异步通知说明:
- 异步通知以POST方式访问商户设置的通知URL
- 商户系统接收到宝付异步通知,并正确的完成相应的业务处理后,须同步返回大写OK字符串<除了OK无任何其他内容>。
- 由于网络抖动等异常因素以及商户侧未按照约定返回OK,宝付支付系统会多次请求商户侧通知地址,商户系统必须能够正确处理重复的通知。建议商户系统收到通知进行处理时,采用数据锁进行并发控制,检查对应业务数据状态,如未处理,则进行处理,防止多次通知造成资金损失。
- 宝付支付系统会在未正常收到商户侧返回OK时,将通过重发机制再次通知商户(重发次数 2~10 次,请以第一次收到的支付成功的消息为准,避免进行多次支付),直到商户接收成功或达到最大重发次数为止则不再进行通知,商户应调用订单查询接口确认订单状态。
业务通知报文
域名 | 变量名 | 必填 | 字段类型 | 备注 |
---|---|---|---|---|
商户号 | member_id | M | Max11Numeric | 宝付提供给商户的唯一编号 |
终端号 | terminal_id | M | Max11Numeric | 终端号 |
代理商户号 | agent_member_id | C | Max11Numeric | 宝付提供给商户的唯一编号 |
代理终端号 | agent_terminal_id | C | Max11Numeric | 代理商户终端号 |
报文发送日期时间 | send_time | M | ISODateTime | 发送方发出本报文时的机器日期时间,如 2017-12-19 20:19:19 |
宝付订单号 | order_no | C | Max32Text | |
商户订单号 | out_order_no | R | Max32Text | |
订单状态 | order_status | C | Max16Text | 订单状态,详见:【订单状态】 |
业务返回码 | result_code | M | Max16Text | 订单状态,详见:【业务应答码】 |
业务返回说明 | result_message | M | Max255Text | |
成功金额 | succ_amt | C | Max12Numeric | 单位:分,例:1元则100 |
成功时间 | succ_time | C | ISODateTime | 支付成功时间 |
商户保留域1 | req_reserved1 | O | Max255Text | |
商户保留域2 | req_reserved2 | O | Max255Text | |
系统保留域1 | additional_info1 | O | Max255Text | |
系统保留域2 | additional_info2 | O | Max255Text | |
营销金额 | discount_amt | C | Max12Numeric | 单位:分 |
返回扩展参数 | extend_params | C | json格式,该属性里面的字段会根据业务返回增加或减少 |
订单状态
状态码 | 描述 |
---|---|
INIT | 初始化 |
PROCESSING | 处理中 |
SUCCESS | 成功 |
FAIL | 失败 |
CLOSED | 关闭 |
业务应答码
状态码 | 描述 |
---|---|
0000 | 0000 |
BF00100 | 系统异常,请联系宝付 |
BF00101 | 持卡人信息有误 |
BF00113 | 交易处理中,请稍后查询 |
BF00114 | 订单已支付成功,请勿重复支付 |
BF00116 | 该终端号不存在 |
BF00118 | 报文中密文解析失败 |
BF00120 | 报文交易要素缺失 |
BF00121 | 报文交易要素格式错误 |
BF00122 | 卡号和支付通道不匹配 |
BF00123 | 商户不存在或状态不正常,请联系宝付 |
BF00124 | 商户与终端号不匹配 |
BF00125 | 商户该终端下未开通此类型交易 |
BF00126 | 该笔订单已存在 |
BF00127 | 不支持该支付通道的交易 |
BF00128 | 该笔订单不存在 |
BF00129 | 密文和明文中参数【%s】不一致,请确认是否被篡改!” |
BF00130 | 请确认是否发送短信,当前交易必须通过短信验证! |
BF00131 | 当前交易信息与短信交易信息不一致,请核对信息 |
BF00132 | 短信验证超时,请稍后再试 |
BF00133 | 短信验证失败 |
BF00134 | 绑定关系不存在 |
BF00135 | 交易金额不正确 |
BF00136 | 订单创建失败 |
BF00180 | 获取短信验证码失败 |
BF00182 | 您输入的银行卡号有误,请重新输入 |
BF00183 | 请重新获取验证码 |
BF00186 | 该卡已绑定 |
BF00187 | 暂不支持信用卡的绑定 |
BF00188 | 绑卡失败 |
BF00190 | 商户流水号不能重复 |
BF00331 | 卡号校验失败 |
BF00313 | 该商户未开通此产品 |
BF00315 | 手机号码为空,请重新输入 |
BF00316 | ip未绑定,请联系宝付 |
BF00317 | 短信验证码已失效,请重新获取 |
BF00321 | 身份证号不合法 |
BF00324 | 请求计费出现异常 |
BF00325 | 交易受理成功 |
BF00328 | 商户订单号不能重复 |
BF00332 | 收单交易失败 |
BF00333 | 收单交易处理中,请稍后查询 |
BF00399 | 订单已存在,请勿重复提交 |
BF00383 | 商户绑卡同步关系未配置 |
BF00423 | 商户暂无权限进行此交易,请联系宝付 |
BF00455 | 平台编号不正确 |
BF00456 | 该终端未配置签名证书 |
BF00458 | 商户订单号格式错误 |
BF00460 | 该终端未配置加密证书 |
BF00462 | 接口发起商户号与代理商户号不匹配 |
BF00463 | 商户未配置计费规则 |
BF00464 | 订单创建失败 |
BF00465 | 代理商户关系不存在 |
BF00466 | 商户未开通相应支付方式 |
BF00467 | 绑卡操作失败 |
BF00468 | 报文签名失败 |
BF00469 | 通知商户失败 |
BF00470 | 协议不存在或无效 |
BF00471 | 确认支付的订单状态无效 |
BF00472 | 请求参数无效 |
BF00473 | 签约信息不存在 |
BF00474 | 数字证书加密异常 |
BF00475 | 您输入的银行编码有误,请重新输入 |
BF00476 | 确认支付与预支付订单商户号不匹配 |
BF00477 | 商户重复请求 |
BF00500 | 渠道返回营销列表为空 |
BF00501 | 渠道返回营销余额信息为空 |
BF00502 | 渠道支付失败 |