在线支付-快捷安全支付-退款
了解 Antom 的退款规则,以及如何为成功交易发起退款。
退款规则
以下是相关的退款规则:
- 手续费:手续费是否退还,以及退款是否产生额外费用,以合同为准。
- 退款结算汇率:当结算和支付货币不一致时,退款所使用的结算汇率为退款成功当天的 Antom 汇率。
- 退款限制:不同的支付方式有不同的限制。以下为具体情况:
- 不支持退款
- 不支持部分退款
- 从成功支付时间起,超过一定时间后不支持退款。
详情请参阅支付方式的退款功能。
- 退款返回:在极端情况下,由于用户的银行账户状态异常等原因,调用 退款 接口并返回成功的退款状态,但用户无法成功收到资金。Antom会结算相应的资金并通过财务报告结算通知您。您需要决定如何处理这些资金。
退款方式
交易成功支付后,您可以通过以下两种方式发起退款:
- 使用退款接口退款 : 您可以通过调用 退款 接口来发起对成功支付交易的退款。
- Antom Merchant Portal : 有关如何发起退款和查看退款结果的更多信息,请参阅在 Antom Merchant Portal 中退款交易。
工作流程
以下是退款的工作流程。
图1:退款工作流程
注意事项:
- 调用 退款 接口后,可能会返回以下三种情况:
- 退款通知: 如果退款成功,将发送退款通知。如果退款请求非法,导致处理异常,则不会收到退款通知。
集成步骤
通过以下步骤开始集成:
- 发起退款请求
- 接收退款响应
步骤1:发起退款请求
通过 退款 接口发起退款流程,具体方法取决于支付方式,可能同步或异步进行:
- 同步退款: 调用 退款 接口后,响应会直接表明退款是否成功或失败。然而,存在系统异常或支付渠道处理异常的微小可能性,这可能导致不同的响应。
- 异步退款: 调用 退款 接口后,响应会显示退款正在进行中。然后需要周期性检查退款状态,或等待通知以获取最终的退款状态。
下表显示了同步和异步退款支持的支付方式。
同步退款 | 异步退款 |
Alipay+ 支付方式 | 所有其他支付方式默认为异步退款。 有关完整的支付方式列表,请参阅支付方式。 |
通过收单机构2C2P HK和2C2P SG的万事达卡和维萨卡 |
表1. 同步和异步退款支持的支付方式
下表显示了接口与同步和异步退款流程的兼容性。
表2. 同步和异步退款支持的接口功能
在使用 退款 接口时,必须满足以下退款请求的要求。如果不满足这些条件,Antom将返回相应的错误代码:
错误代码 | 描述 |
ORDER_STATUS_INVALID | 支付未成功。 |
REFUND_WINDOW_EXCEED | 退款日期超过了合同约定的退款期限。 |
PAYMENT_METHOD_NOT_SUPPORTED | 该支付方式不支持取消或退款交易。 |
PARTIAL_REFUND_NOT_SUPPORTED | 该交易不支持部分退款。 |
MERCHANT_BALANCE_NOT_ENOUGH | 商户余额不足。 |
表3:错误代码
通过 退款 接口发起退款时,请求中的主要参数如下所示:
参数 | 是否必需? | 描述 |
refundRequestId | 是 | 您为支付分配的专属ID。 |
paymentId | 是 | Antom 为待退款原始支付分配的专属ID。 |
refundAmount | 是 | 退款金额必须不少于最小退款金额(通常与最小支付金额相同),且不能超过支付的可退款金额。 退款金额的币种必须与支付接口中支付金额的币种一致。 |
refundNotifyUrl | 否 | 接收异步退款通知的链接。 |
表4:退款请求的关键参数
步骤2:接收退款响应
在调用 退款 接口后,Antom会同步返回退款结果。接口响应中的 resultStatus 参数表示该支付的退款状态。以下是 resultStatus 的值的说明:
S
:退款成功。F
:退款失败。当排除步骤 1 中提到的错误代码后,响应返回F
可能是请求中的非法参数。请参阅错误代码中的 退款 接口,或联系 Antom 技术支持进行故障排查。U
:可能出现以下情况:
REFUND_IN_PROCESS
:表示退款正在处理中。您可以调用 退款查询 接口获取退款结果,或等待退款结果通知。UNKNOWN_EXCEPTION
/REQUEST_TRAFFIC_EXCEED_LIMIT
:通常由 Antom 系统或网络问题引起,您可以调用 退款 接口重试。
ORDER_IS_CLOSED
:通常在 退款查询 响应、 退款 召回 和 退款通知 请求中返回。可能是因为某些原因在 Antom 中无法处理退款。您可以更换账户并重试。