Appearance
绑卡结果回调
- 绑卡订单处理完会将最终绑卡结果主动通知到商户API提单的回调地址中。
- 通知服务通过HTTP POST方式请求回调地址,请求格式(Content-Type)为application/json。
- 通知机制:最多通知5次,第一次立即执行,第二次在首次发送后间隔5秒,第三次到第五次间隔3分钟。
- 商户成功接受通知后请返回字符串:success,否则将按上述机制继续通知,直至通知机制完成。
- 签名方式:异步回调签名规则同其他接口签名方式一样,参考签名规则说明。
请求参数
参数名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
order_no | string | 是 | 20514801314693120 | 平台订单号 |
customer_order_no | string | 是 | 1690355168 | 外部订单号,请确保订单号唯一 |
cookie_type | int | 是 | 4 | CK类型:1PC、2M站、3api |
product_code | string | 是 | JDE | 产品编码 |
card_no | string | 否 | JDV48670037901000039 | 卡号 |
card_secret | string | 是 | D0A589D3AD91918A | 卡密 |
card_face | int | 否 | 50 | 提交面值 (用户提交面值) |
card_balance | int | 是 | 50 | 实际面值 (卡余额) |
card_end_date | string | 是 | 2026-07-21 | 过期时间 |
status | string | 是 | success | 订单状态(success:成功,processing:处理中,failed:失败,cancel:已取消) |
error_code | string | 否 | 90002 | 仅失败情况下需要根据该字段进行处理,参见错误码定义 |
error_msg | string | 否 | 卡密错误 | 错误信息 |
卡密绑定成功回调数据样例
json
{
"order_no": "20514801314693120",
"customer_order_no": "1690355168",
"cookie_type": 1,
"product_code": "JDE",
"card_no": "JDV48670037901000039",
"card_secret": "D0A589D3AD91918A",
"card_face": 50,
"card_balance": "50.00",
"card_end_date": "2026-07-21",
"created_at": "2023-07-26 15:06:08",
"finished_at": "2023-07-26 15:06:49",
"error_code": "",
"error_msg": "",
"status": "success",
"sign": "b45116c856424f067d4f2ce144ac2fef"
}
卡密绑定失败回调数据样例
json
{
"order_no": "20909458523684864",
"customer_order_no": "1690449261",
"cookie_type": 1,
"product_code": "JDE",
"card_no": "",
"card_secret": "D9A589D3AD91918D",
"card_face": 50,
"card_balance": "",
"card_end_date": "",
"created_at": "2023-07-27 17:14:22",
"finished_at": "2023-07-27 17:14:58",
"error_code": "90002",
"error_msg": "卡已被绑定",
"status": "failed",
"sign": "f6faa38c8fa5d680ba0656675fb7748c"
}