1. 发起场景 :用户支付完成后,如果是外部凭证模式,则我方会调用该接口通知合作方发放凭证。 2. 预期结果 :发码成功返回 success和相应的券码;发码失败返回 fail,并透传相应错误码和错误文案;需要异步发码返回dealing,我方会等待合作方的发货通知。 3. 异常兜底 :默认异步发货。 4. 重试机制 :返回dealing 时,我方将重复发起调用,直到订单失效(超时未发放凭证),默认为 2 小时。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
fulfillment_order_no | String | 必须 | 12345678 | 平台履约单号,长度19位,可作为幂等条件 | |
partner_order_no | String | 必须 | 123456 | 合作方订单号,可作为幂等条件 | |
order_no | String | 可选 | 12345678 | 平台订单号,非必传,不推荐使用 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
success | Boolean | true | 合作方是否收到本次请求,默认为true |
biz_result | String | fail | 值枚举,success : 发货成功(接单) fail : 发货失败(拒单) dealing : 发货中(重试发货通知) |
biz_error_code | String | ORDER_NOT_EXIST | 业务错误码 |
biz_error_msg | String | 订单不存在 | 业务错误描述 |
data | String | { "ticketList" : [ "654321" ] } | 具体数据,本接口需要传合作的的券码列表,具体信息入。非必填 |
{"order_no":"12345678","partner_order_no":"123456","fulfillment_order_no":"12345678"}
{ "success":true, "biz_result":"fail", "biz_error_code":"ORDER_NOT_EXIST", "biz_error_msg":"订单不存在", "data":"{ \"ticketList\" : [ \"654321\" ] }" }
{"biz_error_msg":"Illegal request","success":"不等于true","biz_error_code":"sign-check-failure"}
错误码 | 错误描述 | 解决方案 |
---|