Skip to content
On this page

绑卡结果回调

  1. 绑卡订单处理完会将最终绑卡结果主动通知到商户API提单的回调地址中。
  2. 通知服务通过HTTP POST方式请求回调地址,请求格式(Content-Type)为application/json。
  3. 通知机制:最多通知5次,第一次立即执行,第二次在首次发送后间隔5秒,第三次到第五次间隔3分钟。
  4. 商户成功接受通知后请返回字符串:success,否则将按上述机制继续通知,直至通知机制完成。
  5. 签名方式:异步回调签名规则同其他接口签名方式一样,参考签名规则说明。

请求参数

参数名称类型必填示例值描述
order_nostring20514801314693120平台订单号
customer_order_nostring1690355168外部订单号,请确保订单号唯一
cookie_typeint4CK类型:1PC、2M站、3api
product_codestringJDE产品编码
card_nostringJDV48670037901000039卡号
card_secretstringD0A589D3AD91918A卡密
card_faceint50提交面值 (用户提交面值)
card_balanceint50实际面值 (卡余额)
card_end_datestring2026-07-21过期时间
statusstringsuccess订单状态(success:成功,processing:处理中,failed:失败,cancel:已取消)
error_codestring90002仅失败情况下需要根据该字段进行处理,参见错误码定义
error_msgstring卡密错误错误信息

卡密绑定成功回调数据样例

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"
}