绑卡/开户通知
接口说明
请求方式:【POST】商户 notify_url
请求域名:商户在进线请求中上送的回调地址
请求参数
Header 参数
通知请求头与异步通知说明中的 Header 参数相同。
Body 参数
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| event_type | string | true | 事件类型 |
| trade_no | string | true | 平台交易号 |
| merchant_id | string | true | 商户号 |
| out_trade_no | string | true | 商户订单号 |
| account_opened | string | false | 绑卡+开户通知;成功固定 SUCCESS;失败固定 FAIL |
| bind_status | string | false | 单独绑卡通知;成功固定 SUCCESS;失败固定 FAIL |
| contract_no | string | true | 签约号;失败时可能为空串 |
| error_message | string | false | 仅失败时有值;成功时不下发 |
| create_time | string | true | 通知创建时间,ISO 8601 |
| bank_card_list | string | false | 存在绑卡明细时为 JSON 数组字符串;元素含 bank_code、bank_card_type、bank_card_no_masked、agreement_no |
通知示例
{"event_type":"OPEN_ACCOUNT_SUCCESS","trade_no":"4001010120250525120000000001","merchant_id":"M100001","out_trade_no":"MCH202505250001","account_opened":"SUCCESS","contract_no":"C20250525000001","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"}]"}
处理建议:验签通过后处理业务;须应答 HTTP 状态码 200,响应体为字符串 OK;否则系统按固定频率重试。须按 out_trade_no(或约定业务单号)幂等。