酒店通用分销
方法名称
taobao.xhotel.order.distribution.pay
使用说明
概述
确认支付接口。分销商收到用户付款后，调用飞猪确认支付。
确认支付流程
注意事项
- 分销商需确保用户付款后再调用飞猪【确认支付】接口，确认支付后订单即进入履约流程，确认有房后用户发起的取消是可能存在罚金的。由于分销商错误调用【确认支付】接口引起的罚金由分销商承担。
- 创建订单成功后，需要在28分钟内完成支付，否则会关闭订单（飞猪会发送【状态变更消息】通知分销商）。
- 确认支付接口支持幂等。如出现网络抖动等因素导致未接收到调用结果，分销商需要重试【确认支付】或查询【订单详情】获取订单最新状态。
- 如果入参飞猪订单号及外部订单号皆存在，则取飞猪订单号为准。
API入参
字段 |
类型 |
可为空 |
示例值 |
描述 |
dis_order_id |
String |
N |
4564658412 |
外部分销订单号，飞猪订单号与外部订单号不能都为空 |
distributor |
String |
N |
hello |
分销渠道 |
fliggy_order_id |
Number |
N |
飞猪订单号，飞猪订单号与外部订单号不能都为空 |
API出参
字段 |
类型 |
可为空 |
示例值 |
描述 |
result |
Boolean |
Y |
true |
是否确认支付成功 |
is_success |
Boolean |
N |
true |
请求是否成功 |
error_msg |
String |
Y |
该订单不属于此分销渠道，不可操作 |
错误信息 |
error_resp_code |
Number |
Y |
111 |
错误码 |
msg_for_dev |
String |
Y |
开发查看的错误信息 |
常见错误码
错误码 |
解释 |
解决方案 |
101 |
飞猪订单号与外部分销订单号不能都为空 |
检查请求参数是否符合要求 |
102 |
分销渠道信息不能为空 |
检查请求参数是否符合要求 |
112 |
请求参数有误 |
检查请求参数是否符合要求 |
201 |
该订单非待支付状态 |
不支持支付，请检查订单状态 |
301 |
订单查询失败 |
重试，一直失败请联系飞猪开发同学排查 |
302 |
订单付款失败 |
重试，一直失败请联系飞猪开发同学排查 |
