订单支付接口
目前订单支付接口支持以下两种方式:
1、用户将订单金额支付到第三方账号,第三方再与乐荐统一结算;
2、第三方将订单金额支付到乐荐的账户上,并将支付记录(包括但不限于支付宝和微信)同步至乐荐。
以上操作都会将订单状态由未支付状态修改为支付状态。
请求URL:
请求协议:HTTPS
请求方式:POST
需要签名: 是
URL参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
accessToken | 是 | string | 当前有效的accessToken |
nonce | 是 | string | 当前有效的nonce |
sign | 是 | string | 数据sign值 |
关于nonce和sign请查看 数据签名。
URL参数方式一和方式二都需要填写。
POST参数示例
方式一:
{
"orderNum":"20190402161201964014680"
}
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
orderNum | 是 | string | 需要进行支付操作的订单号 |
方式二:
{
"orderNum":"20190402161201964014680",
"tradeType":"0",
"outTradeNo":"2019110515440077706100000001",
"price":100000
}
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
orderNum | 是 | string | 需要进行支付操作的订单号 |
tradeType | 是 | string | 交易类型 0:支付宝 1:微信 |
outTradeNo | 是 | string | 商户流水号 |
price | 是 | int | 支付金额,精确到分 |
返回示例:
正确时返回:
{
"success":"T",
"msg":"success"
}
返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
success | string | T:操作成功 F:操作失败 |
msg | String | 操作返回消息 |
主要异常场景:
1、订单不属于该渠道
{
"success":"F",
"errCode":"201027",
"msg":"The order not belong to the channel"
}
2、渠道账户余额不足,需要充值
{
"success":"F",
"errCode":"201012",
"msg":"balance not enough"
}
3、订单等待时间过长,已经被关闭
{
"success":"F",
"errCode":"201026",
"msg":"The order has been closed"
}
备注:
- 更多返回错误代码请看首页的接口返回码说明
文档更新时间: 2021-10-27 13:22