发起付款接口

创建订单接口

使用方法:您的服器端(server端)将参数以json格式post到我们指定接口。成功后,接口会返回一个json字串,包含支付地址,币种等信息

用户付款成功后,我们会向您的notify_url发送这笔订单支付成功的回调通知

请求参数

以下所有参数,1个中文字、1个英文字母、1个标点符号、1个空格都只算1个字符

参数 必填 类型 描述
method必填string(32)请求的方法,此处固定值:create_order
token必填string(16)用户分配的token
time必填long时间戳,每次请求的当前时间,系统当前时间参考:(1634744991
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
paymentCode必填string(32)支付使用的代码,参考值
currency必填string(16)支付金额对应的币种,支持:USD-美元,CNY-人民币,BTC-比特币。参考值
amount必填string(16)支付金额,支持6位小数,
outOrderNo必填string(32)商户订单号,最长 32 位元字元,请保证订单号的唯一性
itemName必填string(32)商品名称,UTF8格式,用来表示在支付页上的商品名称位置,后有您商户后台的订单清单里。
extra可选string(256)额外参数,支付成功会原样返回,最长 256 位元字元

请求例子

sign用的tokenKey:0f6e65ab7cf3437abb30a8f41afa08b8


curl -X POST -H 'content-Type:application/json;sign:7139e5976f4ecbe7d2e062e183554466bb66f24b4ed2816ec65246d83fedbdc9ccded8cf2761b8df918bc0989fbd188b2031d0aa564835fb9839f5e91192e484' -d '{"time":"1597330081","method":"create_order","token":"384fc783fcc34762bdfc100517675722","paymentCode":"btc","amount":"0.01","currency":"BTC","outOrderNo":"7a04bb7901a546a2acfdff06f4f4d3cf","itemName":"点卡充值","extra":"11212122"}' 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": ""
    }
}