绑卡/开户异步通知

基本定义

  • 方向：通知商户登记的 notify_url
  • 方法：POST
  • Content-Type：application/json
  • 验签：HTTP Header 签名；Body 为业务 JSON

事件类型 event_type

event_type 说明
OPEN_ACCOUNT_SUCCESS 开户成功
OPEN_ACCOUNT_FAIL 开户失败
BIND_CARD_SUCCESS 绑卡成功
BIND_CARD_FAIL 绑卡失败

通知体字段（分支 A：成功）

绑卡+开户类（event_type=OPEN_ACCOUNT_SUCCESS）使用 account_opened；单独绑卡类（event_type=BIND_CARD_SUCCESS）使用 bind_status。取值均为 SUCCESS。

字段 类型 必填 说明
event_type string 是 事件类型
trade_no string 是 平台交易号
merchant_id string 是 商户号
out_trade_no string 是 商户订单号
account_opened string 条件 绑卡+开户通知；固定 SUCCESS
bind_status string 条件 单独绑卡通知；固定 SUCCESS
contract_no string 是 签约号
error_code string 是 成功时为空串，可忽略
error_message string 是 成功时为空串，可忽略
create_time string 是 通知创建时间，ISO 8601
bank_card_list string 条件 存在绑卡明细时为 JSON 数组字符串

bank_card_list 字符串内元素字段：

字段 类型 说明
bank_code string 银行编码
bank_card_type string 卡类型，如 D/C
bank_card_no_masked string 脱敏卡号，格式如 ****5661（卡号后四位）
agreement_no string 协议绑定号

通知示例：

{
  "event_type": "OPEN_ACCOUNT_SUCCESS",
  "trade_no": "4001010120250525120000000001",
  "merchant_id": "M100001",
  "out_trade_no": "MCH202505250001",
  "account_opened": "SUCCESS",
  "contract_no": "C20250525000001",
  "error_code": "",
  "error_message": "",
  "create_time": "2026-05-25T15:10:01+08:00",
  "bank_card_list": "[{\"bank_code\":\"ICBC\",\"bank_card_type\":\"D\",\"bank_card_no_masked\":\"****5661\",\"agreement_no\":\"AGR20250525000001\"}]"
}

通知体字段（分支 B：失败）

绑卡+开户类（event_type=OPEN_ACCOUNT_FAIL）使用 account_opened；单独绑卡类（event_type=BIND_CARD_FAIL）使用 bind_status。取值均为 FAIL。

字段 类型 必填 说明
event_type string 是 事件类型
trade_no string 是 平台交易号
merchant_id string 是 商户号
out_trade_no string 是 商户订单号
account_opened string 条件 绑卡+开户通知；固定 FAIL
bind_status string 条件 单独绑卡通知；固定 FAIL
contract_no string 否 可能为空串
error_code string 是 失败错误码
error_message string 是 失败原因
create_time string 是 通知创建时间
bank_card_list string 否 失败时不返回

通知处理规范

  • 验签通过后处理业务，建议返回 *HTTP *2xx。
  • 响应 JSON 体（如 { "code": "SUCCESS" }）