绑卡/开户通知

接口说明

请求方式:【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(或约定业务单号)幂等。