取消交易

2023-11-07 08:12

下单后您可以在一定时间窗口期内通过使用取消接口主动关闭某笔交易，支持取消的时间窗口期以合约划定为准。

取消交易的关键业务信息如下：

在支付成功之前发起取消的交易，买家将无法继续支付。
买家支付成功后发起取消的交易，资金会原路退回用户账户。
是否退手续费: 退费，被取消的交易不会产生手续费。
是否允许部分取消: 不允许。取消会对整个订单进行取消。
取消窗口期: 不同支付方式的窗口期有差异。具体请查看以下表格：

支付方式	取消窗口期
印尼地区的支付方式、和 JKOPay	不支持取消
泰国 Online Banking、Mobile Banking APP、和 Bank Transfer 类支付方式	下单时间至支付成功前支付成功后无法取消
卡支付	下单时间至下单后 7*24h 内请款成功的交易无法进行取消
Mercado Pago（巴西、智利、墨西哥、和秘鲁）	下单时间至下单后 7*24h 内
其他支付方式	下单时间至东八区 T+1 日的 00：15 之前

表 1. 支付方式取消窗口期

使用场景

如果商户有明确的主动关单场景，如闪购、酒店预订、机票购买等，则需要集成取消接口。可以针对以下情况之一发起交易取消，交易取消后，交易状态变为 CANCELLED。即使交易取消后收到支付成功的异步通知，您系统中的交易状态仍然应保持 CANCELLED。针对不同场景进行的交易取消，Alipay 会相应进行处理：

场景	处理结果
交易已支付，在取消时限内发起取消。	全额退款，不收取消交易手续费。
交易未支付，在付款时限内（14 分钟）发起取消。	关闭交易，买家将无法继续支付。
交易已支付，交易结果无法通过 Alipay 异步通知和调用查询支付结果接口获取，发起取消。	关闭交易，若后续收到支付成功异步通知则全额退款，不收取消交易手续费。
卡支付场景下，授权支付（Auth）完成后、商户请款（Capture）之前，买家申请退款，则商户侧发起取消。	取消授权交易（Auth）。

表 2. 取消交易场景及处理

注意：

已发生过退款的交易（包括全额退款和部分退款）不支持取消，取消已退款的交易将返回错误码 PROCESS_FAIL。
卡支付场景下，请款成功后，不可取消交易但可申请退款。
对于巴西、智利、墨西哥、和秘鲁的 Mercado Pago 支付方式，如果您设置的支付超时时间小于 7 天，买家取消交易时请调用取消接口来主动关闭交易，以免买家可以继续支付。

集成步骤

步骤一：发起交易取消

您可以通过取消接口发起单笔交易的撤销。在请求中，你需要传入以下 2 种 ID 中的一个：

参数名	必填/选填	描述
paymentId	OPTIONAL	下单时由支付宝侧返回的唯一交易号。
paymentRequestId	OPTIONAL	下单时由商家分配的唯一请求号。

表 3. 取消接口传参说明

步骤二：取消结果获取

在您调用取消接口后，Alipay 会通过 result.resultStatus 字段同步返回该次交易的取消结果：

resultStatus	解释
S	取消成功。由 cancelTime 字段表示取消成功的时间。
F	取消失败。错误码信息请参考 Error codes。
U	取消结果未知，请使用相同的请求参数 paymentRequestId 发起取消重试。paymentRequestId 是取消的唯一标识，使用同一个 paymentRequestId 多次请求不会触发多次取消。如果重试三次仍返回 `U`，请联系支付宝技术支持。

表 4. 取消结果解释