对接指南
API对接流程

1. 需求沟通

发起方:双方
分销商申请合作,并联系磐河商务人员进行需求沟通和商务洽谈;
如果您尚未成为磐河的分销商,请联系150-2190-5015;

2.协议签订

发起方:磐河
双方签署《磐河旅行开放平台系统对接协议》,磐河审核;

3.开发

发起方:磐河的分销商
分销商根据API文档进行设计、开发;磐河提供测试环境,并提供答疑支持;

4.联调

发起方:磐河的分销商
分销商主导联调测试,磐河配合;

5.上线

发起方:磐河的分销商
磐河提供正式环境参数;分销商技术人员将对接功能上线,并由分销商业务人员进行验收,磐河配合;

业务流程

1.产品资源搜索展示

分销商通过磐河开放平台的产品查询类接口(如酒店搜索接口、机票航班查询接口等)进行产品获取并展示到分销商自己的终端平台(如:APP、小程序、H5、PC等)供分销商的用户进行查询预订(PS:磐河开放平台提供的是通用标准API接口(即不是针对某一分销商的特殊业务而开发的定制接口),分销商自己终端平台的UI设计 交互设计、业务规则、营销策略等等由分销商自主完成开发,磐河仅提供与接口相关的技术支持)

2.产品下单预订

当分销商需要产品采购时,可通过磐河开放平台相关产品的下单接口把订单自动创单到磐河平台(一般创单仅创单并没有支付,如需支付还需要调用 支付代扣相关即可,视具体业务产品而定)

3.订单支付结算

当分销商确定需要预订出票时,可通过相关支付代扣接口进行订单的支付。
磐河旅行分销开放平台目前是通过预充值即预存模式(根据自身业务量预先充值一笔金额到贵司在磐河的分销账户中)进行结算,贵司需要帮自己的用户采购出票时,再通过订单代扣支付接口一单一结支付给磐河(如发生退款,也是原路退回到贵司的分销账户中)。预存充值金额不限,同时我们会提供给贵司一个分销后台供贵司查询订单和交易明细,这样既简单方便、又保证贵司平台的独立性。
( PS:分销商的用户通过分销商自己的终端平台直接支付给分销商(分销商平台支持哪些支付方式(如:支付宝、微信、信用卡、积分、优惠券、企业月结等等)完全由分销商自己决定的,磐河不做任何参与。),整个过程中分销商的用户和磐河之间无任何的交易往来。)

3.订单相关操作

分销商可通过磐河开放平台订单操作相关接口(如:取消订单、申请退票、申请改签等等,视具体业务产品接口而定)将订单操作相关功能开放给分销商的终端用户,从而实现订单操作的同步处理和打通。

常见问题

磐河支持哪些支付方式

磐河开放平台的订单只支持余额支付,所以需要分销商提前预存一定金额到自己的分销账户中。下单支付时一单一结

订单支付流程是什么样子的

磐河与分销商之间:是通过预充值即预存模式(根据自身业务量预先充值一笔金额到贵司在磐河的分销账户中)进行结算,贵司需要帮自己的用户采购出票时,再通过订单代扣支付接口一单一结支付给磐河(如发生退款,也是原路退回到贵司的分销账户中)
分销商与分销商的客户之间:分销商自己终端平台支持哪些支付方式以及和终端用户之间的支付流程完全由分销商自己决定,磐河无需关注
磐河与分销商的客户之间:从始至终,整个过程中磐河与分销商的客户之间没有任何交易往来

预存充值方式支持哪些?预充值金额有什么要求?

目前支持对公转账充值,支付宝充值
充值金额没有要求,分销商可根据自己平台的业务量每次充值一周或半个月左右的订单量即可。磐河分销平台余额不足也会发送短信提醒的(可自行开通配置)

预充值可以开发票吗

预充值并非消费,所以充值是没有发票的

订单完成后可以开发票吗

酒店:可以开具增值税普通发票
国内机票:无法提供发票,可申请纸质行程单(打印服务费和快递费需自行承担)。
火车票:纸质火车票作为唯一的报销凭证,旅客如需报销,请提前至火车站换取纸质车票并妥善保管,我司无法另行提供火车票票款发票给对接商户或最终旅客
景点门票:不提供发票,部分景区提供发票的,旅客取票时可直接向景区索取

技术常见问题

接口请求方式

接口使用http请求的方式进行通讯,(为了测试调用方便部分接口get/post都支持)但这里请求方式强烈建议一律用POST,(请求头部一律记得设置)Content-Type:application/json。磐河开放平台所有接口方法都支持这种请求方式,强烈建议,少走弯路。

接口返回:appKey不存在

一般只有两种原因:1、appKey值错了(如复制错了,把secretKey值当appKey了等)2、环境用错了(如把测试环境的appKey用到生产环境 或 把生产环境的appKey用到测试环境了)

接口返回:appKey无请求此数据权限

每个业务产品(如酒店和火车票)之间是完全独立的,每个产品的appKey只能用于该产品的相关接口,无法用于调用其他产品接口。如把酒店的appKey拿去调用火车票相关接口就会提示:appKey无请求此数据权限

订单状态变更会有推送通知吗?推送通知参数及格式是什么样的?

磐河开放平台产品 只要有传回调地址的订单,状态变更时都会有回调通知。具体通知参数及格式,详见:订单状态推送通知说明

上线前需要做哪些准备

需同时将接口域名及接口账户切换成生产环境的(必选);
白名单配置(可选项);
提前预存一定金额到分销账户余额中,否则无法下单支付(必选);
余额不足短信提醒配置(可选),如需开通,提供个最低预警值(如2000元,当余额低于2000元系统会发送余额不足短信提醒)给到磐河对接人员。

订单出票、退票、改签成功及失败是否发送短信?

默认不发送短信,由分销商平台自行发送短信,如需短信模板,磐河可提相关订单通知类 短信参考模板。