取消核销
取消核销接口,已经支付核销过的订单不允许直接退款,想要发起退款时,需要先调用此接口进行取消核销
请求地址
环境 | HTTPS 请求地址 |
---|---|
新正式环境 | https://etrade-api.baidu.com/cashier/syncOrderStatus |
历史环境 | https://nop.nuomi.com/nop/server/rest (即将废弃,请尽快切到上面新正式环境中) |
TIPS:取消核销API逐步升级,新开发者建议接入新正式环境;历史环境不影响正常使用,已接入开发者建议尽快切到新正式环境中。
请求参数说明
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
method | String | 否 | 固定值:nuomi.cashier.syncorderstatus | API 接口名称,使用历史环境该字段为必填,新正式环境无需传该字段 |
orderId | Int | 是 | 2636635856 | 百度平台订单 ID |
userId | Int | 是 | 4188819900 | 百度用户 ID,支付回调中返回 |
type | Int | 是 | 固定值:3 | 标识使用该接口取消订单核销状态 |
appKey | String | 是 | MMMzaA | appKey |
rsaSign | String | 是 | rsa 签名,所有参数参与签名,详见签名与验签。 |
发送请求时需要对可能包含中文及特殊字符的字段进行 UrlEncode 操作,对于除中文及特殊字符的参数不需要进行 UrlEncode。
返回说明
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
errno | Int | 是 | 0 | 返回码 |
msg | String | 是 | success | 返回信息 |
data | Object | 是 | [] | 返回数据 |
“企业余额”金额小于退款金额时会导致取消核销失败,返回 10003 错误;如取消核销请求参数的 orderID、userID 填写错误,会提示 10002 错误,返回自查是否和系统支付回调时回传的参数一致,如一致,请反馈问题至客服邮箱
jiaoyi-ask@baidu.com
。
返回示例
{
"errno": 0,
"msg": "success",
"data": []
}