查詢接口

查詢接口(可選接口)

用來主動查詢訂單是否支付成功,一般情況只用發起支付+回檔接口即可。如果您伺服器中斷了一段時間,可以用這個接口,快速獲取中斷時期的訂單的支付狀態。注意:此接口不能頻繁查詢,每個訂單每分鐘只能查一次。不可替代回檔接口。

接口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. }