查询接口

查询接口(可选接口)

用来主动查询订单是否支付成功,一般情况只用发起支付+回调接口即可。如果您服务器中断了一段时间,可以用这个接口,快速获取中断时期的订单的支付状态。注意:此接口不能频繁查询,每个订单每分钟只能查一次。不可替代回调接口。

接口URL:

https://bapi.app/api/v2/order

传参方式:GET

请求参数

参数 必填 类型 描述
order_id 必填 string(32) 商户订单号,请保证订单号的唯一性。
time 必填 long 发起支付时的服务器时间,13位时间戳,使用此参数是出于安全考虑,用来防御请求重发攻击
app_key 必填 string(16) 平台生成的app key。在“商家后台 - 商家信息”中获取
sign 必填 string(32) 签名,点此查看签名生成方法

请求例子

  1. curl 'https://bapi.app/api/v2/order?sign=e1f73a0b4f11eed4147a6ac761556e2b&order_id=1&app_key=4789e57f8629eb9e&time=1234567890123'

返回参数

参数格式::application/json

参数 类型 描述
code int 状态代码,200 代表获取成功,其他状态代码请对照msg 返回的信息内容
msg string 提示信息
data object -
data.bapp_id string(32) 平台订单号,此订单号在 B.app上唯一
data.order_id string(32) 商户订单号,请保证订单号的唯一性。
data.order_state int 订单状态,0:等待用户支付 1:支付成功 2:订单超时自动关闭
data.body string(128) 商品名称,UTF8格式,用来显示在支付页上的商品名称位置,还有您商户后台的订单列表里。
data.notify_url string 回调地址
data.order_ip string 订单发起端端ip
data.amount long 订单金额,单位字符(分)
data.amount_type string(16) 订单货币单位,目前只支持人民币,此处只会是:CNY
data.amount_btc long 比特币金额,单位(聪)
data.pay_time long 支付时间戳(13 位字符),如果未支付或者支付失败,此值位 0
data.create_time long 订单创建时间戳(13 位字符)
data.order_type int 订单类型,1:扫码支付 2:H5支付 3:APP原生支付
data.app_key string 平台生成的 app key,16 位字符
data.extra string 额外参数,最长 64 位字符

返回例子

  1. {
  2. "code": 200,
  3. "msg": "ok",
  4. "data": {
  5. "bapp_id": "20190618171802840b6a",
  6. "order_id": "1",
  7. "order_state": 1,
  8. "body": "goods_name",
  9. "notify_url": "https://bapi.app/api/experience/notify/test",
  10. "order_ip": "",
  11. "amount": 1,
  12. "amount_type": "CNY",
  13. "amount_btc": 16,
  14. "pay_time": 1560859623468,
  15. "create_time": 1560849482796,
  16. "order_type": 2,
  17. "app_key": "4789e57f8629eb9e",
  18. "extra": ""
  19. }
  20. }