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

在线支付-快捷安全支付-退款

了解 Antom 的退款规则,以及如何为成功交易发起退款。

退款规则

以下是相关的退款规则:

  • 手续费:手续费是否退还,以及退款是否产生额外费用,以合同为准。
  • 退款结算汇率:当结算和支付货币不一致时,退款所使用的结算汇率为退款成功当天的 Antom 汇率。
  • 退款限制:不同的支付方式有不同的限制。以下为具体情况:
    • 不支持退款
    • 不支持部分退款
    • 从成功支付时间起,超过一定时间后不支持退款。

详情请参阅支付方式的退款功能

  • 退款返回:在极端情况下,由于用户的银行账户状态异常等原因,调用 退款 接口并返回成功的退款状态,但用户无法成功收到资金。Antom会结算相应的资金并通过财务报告结算通知您。您需要决定如何处理这些资金。

退款方式

交易成功支付后,您可以通过以下两种方式发起退款:

工作流程

以下是退款的工作流程。

image.png

图1:退款工作流程

注意事项:

  • 调用 退款 接口后,可能会返回以下三种情况:
    • 退款失败会在 退款 响应中返回:如果请求参数不正确,尝试根据返回的错误代码信息调整退款参数并重试。请联系 Antom 技术支持进行故障排查。有关如何处理每个错误代码的详细信息,请参阅 错误代码
    • 退款成功会在 退款 响应中返回:参数 resultCode 返回 REFUND_IN_PROCESS ,使用 退款查询 接口获取最终退款结果,或者等待通过 退款通知 的退款结果通知。
    • 退款 响应中返回了未知的退款异常:这通常由于网络原因,您可以尝试不更改账户进行重试。
  • 退款通知: 如果退款成功,将发送退款通知。如果退款请求非法,导致处理异常,则不会收到退款通知。

集成步骤

通过以下步骤开始集成:

  1. 发起退款请求
  2. 接收退款响应

步骤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 中无法处理退款。您可以更换账户并重试。