Antom, leading provider of tailored payment solutionsAntom, leading provider of tailored payment solutions

在线支付-快捷安全支付-取消

您可以使用取消接口来取消一笔交易。取消期限受合同约束。

在发起取消之前，您需要了解以下信息：

  • 已支付交易取消后，支付金额将退回到用户账户。
  • 手续费：对于已取消的交易，手续费将退还。
  • 部分取消： 仅允许全额取消。
  • 取消期限： 在T+1日00:15之前（UTC+8:00）

何时取消交易

如果您有需要取消交易的业务场景（如限时优惠、酒店预订服务或票务销售服务），可以使用 取消 接口来取消交易。交易取消后，支付状态变为CANCELLED 即使在交易取消后收到支付成功的通知，支付状态仍保持为CANCELLED。您可以在以下场景中取消交易， Antom 会根据场景处理取消操作：

场景

结果

在交易已支付且处于可取消期内发起退款请求。

全额退款，不收取手续费。

在交易已支付，但收到 Antom 异步通知或使用 支付结果查询 接口后，支付结果仍未知。

交易被取消。如果收到已取消交易的支付成功通知，则全额退款，不收取手续费。

表2. 不同场景下的退款处理

注意事项：已退款的交易无法取消。否则，会返回错误代码PROCESS_FAIL。

如何取消交易

步骤1：调用取消接口

您可以通过使用取消接口来取消交易。在请求中，您必须传入以下参数之一：

参数

是否必需

描述

paymentId

可选

Antom 分配给交易的专属ID。

paymentRequestId

可选

您为请求分配的专属ID。

表3. 取消 接口的请求参数详情

步骤2：获取取消结果

在调用 取消 接口后， Antom 会通过 result.resultStatus 同步返回取消结果：

resultStatus

解释

S

取消成功。cancelTime 表示取消成功的时间。

F

取消失败。请参阅错误代码以进行 取消 接口的故障排除。

U

取消操作未知。请使用相同的 paymentRequestId 值重新发送接口请求。 paymentRequestId 是取消操作的识别ID，因此使用相同参数值重发请求不会触发多次取消。 如果连续重试三次后，result.resultStatus 的值仍然是U，请联系 Antom 技术支持。

表4. result.resultStatus 的说明