支付订单
该接口用于支付票牛订单。支付订单后会进入备货、发货流程,可通过查询订单跟踪订单状态。
该接口是幂等接口,如果出现网络原因、服务器原因导致请求失败,第三方可以重复调用直到返回码为200,success
字段为true
或false
为止。
POST /openapi/v2/order/pay
参数
context-type="application/x-www-form-urlencoded"
name |
类型 |
意义 |
取值 |
sign |
String |
签名 |
483DFD2E8BE0AF2D486F04C7320C7C5E |
appId |
int |
代理商的唯一id |
1 |
timeStamp |
long |
时间戳 有效期10分钟 |
1482995969920 |
amount |
Bigdecimal |
支付金额(必须和订单金额一样) |
100 |
orderId |
String |
代理商订单id |
js8asa8su |
请求示例(测试环境):
curl -X POST http://openapibeta.piaoniu.com/openapi/v2/order/pay\
-v -d "orderId=js8asa8su&appId=10000&timeStamp=1489798844309&sign=F2CEAA8EE5E4C4B63A8EE69C117C53F2"\
-H "Content-Type: application/x-www-form-urlencoded"
返回值 :
name |
意义 |
取值 |
success |
是否成功,成功后无其他信息,错误会返回错误码及提示(重复支付仍会返回true) |
true/false |
errorCode |
错误码,详见下表 |
ORDER_ERROR |
errorHint |
错误提示 |
订单已关闭,无法支付 |
errcode含义:
错误码 |
含义 |
PARAM_ERROR |
参数错误,例如:支付金额不对 |
ORDER_ERROR |
订单状态,例如:订单已关闭,无法支付 |
建议联调时通过业务对齐,减少PARAM_ERROR
出现。
出现ORDER_ERROR
时,建议在第三方记录库记录支付失败,并采取相应操作(例如退款)。
示例(成功):
{
"success":true
}
示例(失败):
{
"success":false,
"errorCode":"ORDER_ERROR",
"errorHint":"订单已关闭,无法支付"
}