接口说明:
1.转账(取现)最终交易状态以代付state为准
2.商户接收到通知后务必在接收通知后返回大写OK
3.系统在未确认商户接收通知成功后将会通过重发机制通知商户(重发次数10次,请以第一次收到的付款成功的消息为准,避免进行多次确认)通知发给商户。
4.该接口除了订单成功、失败结果通知外,退款的结果也一并通知。
5.通知参数格式:http://URL?member_id=1&terminal_id=2&data_type=JSON&data_content=密文
6.通知报文编号:BCT3-3104-001-01
异步通知规则
1、地址通且有返回OK则后续不再通知
2、通知14次,分别为:
0秒/10秒/10秒/10秒/10秒/15秒/1分钟/3分钟/10分钟/30分钟/60分钟/3小时/6小时/6小时
通知参数
参数名称 | 类型 | 长度 | 出现要求 | 参数备注 |
---|---|---|---|---|
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-3104-001-01 |
data | Json | - | M | - |
data内容
参数名称 | 类型 | 长度 | 出现要求 | 参数备注 |
---|---|---|---|---|
version | String | 5 | M | 版本号1.0.0 |
contractNo | String | 32 | M | 转出子商户号 |
orderId | String | 20 | M | BCT订单号 |
transSerialNo | String | 50 | M | 原商户流水号 |
transMoney | BigDecimal | 10,2 | M | 转账金额,单位:元 |
transFee | BigDecimal | 10,2 | M | 费用,单位:元 |
transferTotalAmount | BigDecimal | 10,2 | M | 转账交易时金额,单位:元 |
state | String | 4 | M | 状态 1成功 0失败 2处理中 3提现退回 |
transRemark | String | 128 | M | 失败原因 |
reqReserved | String | 512 | O | 保留域 |
说明:
A)“提现退回”
当商户请求一笔代付订单到宝付后,宝付将该笔订单发往渠道,渠道扣除宝付备付金资,转账给收款行后返回给宝付“付款成功”的状态,此时客户调用查询接口也会收到“转账成功”的状态,即state=1。但在银行向收款账户入账时,可能因账户本户原因(如收付状态异常等)导致收款账户不能入账,银行会有退票的情况,退回后客户再调用查询接口查询该订单,则状态为“转账退款”
data_content示例
{
"contractNo": "CP690000000000000258",
"orderId": "21201148",
"reqReserved": "",
"state": "1",
"transFee": "1.00",
"transMoney": "10.01",
"transRemark": "",
"transSerialNo": "TID277461406486212443164402",
"transferTotalAmount": "10.01"
}