异步通知说明:

  • 异步通知以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 渠道支付失败