接口说明:
1.转账(取现)最终交易状态以代付state为准
2.商户接收到通知后务必在接收通知后返回大写OK
3.系统在未确认商户接收通知成功后将会通过重发机制通知商户(重发次数10次,请以第一次收到的付款成功的消息为准,避免进行多次确认)通知发给商户。
4.该接口除了订单成功、失败结果通知外,退款的结果也一并通知。
5.通知参数格式:http://URL?member_id=1&terminal_id=2&data_type=JSON&data_content=密文
6.通知报文编号:BCT3-9103-001-01
异步通知规则
1、地址通且有返回OK则后续不再通知
2、通知14次,分别为:
0秒/10秒/10秒/10秒/10秒/15秒/1分钟/3分钟/10分钟/30分钟/60分钟/3小时/6小时/6小时
唯一性标准:银行流水号[serverTransId]+银行类型[bankType]确定入金唯一性。
通知参数
参数名称 | 类型 | 长度 | 出现要求 | 参数备注 |
---|---|---|---|---|
member_id | String | 10 | M | 商户号 |
terminal_id | String | 10 | M | 终端号 |
data_type | String | 5 | M | JSON,data_content的明文组装格式 |
data_content | String | 128 | M | 加密数据,需使用宝付公钥解密后再做base64解码 |
data_content解密参数
参数名称 | 类型 | 长度 | 出现要求 | 参数备注 |
---|---|---|---|---|
serviceTp | String | 20 | M | 报文编号BCT3-9103-001-01 |
data | Json | - | M | - |
data内容
中文名 | 参数 | 定义 | 长度 | 必填 | 说明 |
---|---|---|---|---|---|
版本号 | version | String | 5 | M | 版本号1.0.0 |
业务类型 | [type] | String | 2 | M | 03记账簿入金通知; |
入账金额 | amount | BigDecimal | 10,2 | M | 转账金额,单位:元 |
记录时间 | recordTime | datetime | 14 | M | 时间 yyyyMMddHHmmss |
明细序号 | seqNo | String | 64 | M | |
备注说明 | remark | String | 1024 | O | |
对方账户 | peerAccNo | String | 64 | O | |
对方账户名称 | peerAccName | String | 128 | O | - |
对方银行号 | peerBankNo | String | 30 | O | - |
对方银行名称 | peerBankName | String | 64 | O | - |
银行流水号 | serverTransId | String | 128 | M | 渠道核心流水号唯一 |
电子账簿ID | balanceAcctId | String | 64 | O | - |
电子账簿账簿号 | relAcctNo | String | 64 | O | - |
渠道业务订单号 | orderId | String | 64 | O | 外部订单号,一般是企业网银转账的对方银行流水号或者网联结算资金入账的网联流水号 |
银行附言 | bankMemo | String | 255 | O | 展示在收款银行系统中的附言 |
银行类型 | bankType | String | 16 | M | HT:华通银行;SSQY:苏商银行 |
银行扩展信息 | bankExtra | Json | O | - | |
- | - | - | - | - | - |