- 请求地址:https://pay.bilibili.com/payplatform/pay/cancel
- 警惕,接口具备一定条件,如无法确认下述条目项,务必联系支付平台研发进行确认。
【使用必读】
- 1.在未调用支付/payplatform/pay/pay之前,调用此接口之后,同一个orderId在2小时之内不可调用/payplatform/pay/pay支付(返回订单已取消), 如果调用取消支付成功,2小时候取消状态失效,用户仍然可以发起支付。
- 2.在已调用/payplatform/pay/pay之后,未支付成功之前,调用调用该接口直接将未付款的交易进行取消,支付中心收到支付成功通知,支付成功系统会立即发起退款,不会通知业务方支付成功。
- 3.已支付成功订单不可取消
- 4.业务方不可完全依赖支付中心的取消退款逻辑,如果业务方收到支付成功通知,需要自行判断是否需要退款
- 请求方式: http post application/json
入参列表
请求参数 | 描述 | 类型 | 是否必须传入 |
customerId | 支付平台分配给开发者的业务id | string | 是 |
txId | 支付平台订单id | string | txId、orderId 二选一,优先 txId |
orderId | 业务订单id | string | txId、orderId 二选一,优先 txId |
timestamp | 请求时间戳 毫秒级 | Int | 是 |
traceId | 请求标识id | string | 是 |
version | 接口版本,目前1.0 | string | 是 |
signType | 签名校验类型,默认MD5 | string | 是 |
sign | 校验签名 | string | 是 |
返回列表
【errno及msg映射】
errno | Msg |
0 | Success |
8004010001 | 签名不正确 |
8004010002 | customerId参数为空 |
8004010003 | 参数错误 |
8004010004 | 内部错误 |
8004010005 | timestamp参数为空 |
【data返回体】
返回字段 | 描述 |
traceId | 请求标识id |
serverTime | 服务器时间戳 |
customerId | 支付平台分配给开发者的业务id |
orderId | 业务方订单id |
orderCloseTime | 支付取消时间 |
返回示例
{
"errno": 0,
"msg": "SUCCESS",
"data": {
"orderId": "12344",
"orderCloseTime": 13443436
}
}