回调通知

回调通知接口(必用接口)

用户支付成功后,我们会将成功订单信息以json格式传到您的notify_url参数中对应的网址。notify_url是您发起支付时传入的参数。

收到支付结果后,请返回 SUCCESS 字符串给B.app。

如果回调通知失败,之后会按时间重试5次,分别是:订单第一次回调失败后的5秒,10秒,30秒,1分钟,5分钟。重试5次后依然通知不成功,不会再自动重试,您之后可以用查询接口完成判断知否是否成功

传参方式:POST

参数格式::application/json

参数 类型 描述
bapp_id string(32) bapp平台订单号,此订单号在B.app上唯一
order_id string(32) 商户订单号,就是您发起订单时传入的order_id
order_state int 当前订单状态,有回调的,必然支付成功,永远=1
order_type int 用户付款方式,1:扫码支付 2:H5支付3:APP原生支付
amount long 订单金额,单位(分),和发起订单时金额一致,是未扣手续费之前的金额
amount_type string(16) 订单货币单位,目前只支持人民币,此处只会是:CNY
amount_btc long 比特币金额,单位(聪)注释:1BTC=100,000,000聪
order_fee long 商户手续费,单位(分),币种和传入币种相同
order_fee_btc long 商户手续费,单位(聪)
rate long 交易时的比特币汇率,单位(分/BTC)
create_time long 订单创建时间戳(13 位字符)
pay_time long 支付时间戳(13 位字符)
body string(128) 商品名称,UTF8格式,和您传入的商品名称一致
extra string(64) 额外参数,您发起支付带入的参数,原样返回
order_ip string(45) IP参数,您发起支付带入的参数,原样返回
time long 服务器时间,13位时间戳,使用此参数是出于安全考虑,用来防御请求重发攻击
app_key string(16) 平台生成的 app key,16 位字符
sign string(32) 签名,签名方式和发起支付相同

回调通知例子

  1. {
  2. "bapp_id": "20190618171802840b6a",
  3. "order_id": "1",
  4. "order_state": 1,
  5. "order_type": 2,
  6. "amount": 1,
  7. "amount_type": "CNY",
  8. "amount_btc": 16,
  9. "order_fee": 0,
  10. "order_fee_btc": 0,
  11. "rate": 6432450,
  12. "create_time": 1560849482796,
  13. "pay_time": 1560859623468,
  14. "body": "goods_name",
  15. "extra": "",
  16. "order_ip": "",
  17. "time": 1561023663119,
  18. "app_key": "4789e57f8629eb9e",
  19. "sign": "d72e1c8d7efbac64cbc8ec5b76b00671"
  20. }