查询订单接口

查询接口

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

传参方式:POST

请求参数

参数 必填 类型 描述
method必填string(32)请求的方法,此处固定值:get_order
token必填string(16)用户分配的token
time必填long时间戳,每次请求的当前时间,系统当前时间参考:(1634744288
version必填string(16)此接口版本号,支持1.0.0,默认1.0.0
format可选string(16)数据格式化方式,支持json,默认json
signMode可选string(16)数据签名方式,支持HmacSHA512,默认HmacSHA512
charset可选string(16)数据编码方式,支持UTF-8,默认UTF-8
outOrderNo必填string(32)outOrderNo/orderNo二选一必填,商户订单号,请保证订单号的唯一性
orderNo必填string(16)outOrderNo/orderNo二选一必填,系统返回的订单号

请求例子

sign用的tokenKey:0f6e65ab7cf3437abb30a8f41afa08b8


curl -X POST -H 'content-Type:application/json;sign:53896dbb777f911002f11e3c9d5c134b6a1f680a595128a184f9270721f06fd3cae77c714aeddbace8464f10d26a2416ee46cdba0d8b04a60a40f660e724d63b' -d '{"time":"2019-04-01 14:47:29","method":"get_order","token":"384fc783fcc34762bdfc100517675722","outOrderNo":"7a04bb7901a546a2acfdff06f4f4d3cf"}' https://a1.fubaox.com/api

返回参数

参数格式::application/json

参数 类型 描述
successboolean请求是否成功,true/false
datastring成功,返回的数据
errCodestring错误,返回的错误码
errMsgstring错误,返回的错误信息
errDetailMsgstring错误,返回的错误很详细的内容
data.currencystring下订单时预计收款的币种
data.amountstring下订单时预计收款的币种金额
data.currency2string实际支付的币种
data.amount2string币种2对应的金额
data.extrastring下单时传过来的额外参数,原样返回
data.outOrderNostring下订单时传过来的商户单号,原样返回
data.orderNostring当前订单创建后返回的单号
data.orderStatusstring当前订单的支付状态
data.orderStatusNamestring当前订单的支付状态名称
data.paymentNamestring下订单时传过来的支付代码名称
data.paymentCodestring下订单时传过来的支付代码
data.paymentContentstring支付地址,如果是数字货币则是数字货币的地址,如果是支付则是二维码地址或支付页面地址
data.paymentTagstring如果币种currency2是XRP等之类需要tag的地址,此字段存放tag

返回例子


{
 "success": true,
 "data": {
	"currency": "CNY",
	"amount": "12",
	"currency2": "BTC",
	"amount2": "0.01",
	"extra": "11212122",
	"outOrderNo": "abe93fd9ce6a470ab006c4e66d25533a",
	"orderNo": "159551503708776247",
	"orderStatus": "N",
	"orderStatusName": "未支付",
	"paymentName": "泰达币以太链",
	"paymentCode": "usdterc20",
	"paymentContent": "0x0b17d0d51fcc2c25efb308afb277a87e474f9887",
	"paymentTag": ""
    }
}