退款
您可以通过本文了解 Antom 的退款规则及如何对成功的交易发起退款。
退款规则
退款的相关规则如下:
- 是否退手续费: 依照双方合约执行。
- 退款的执行汇率:
- 若跨币种结算,外汇策略为锁价模式下,按照发起退款请求当日 Antom 汇率进行结算。
- 若跨币种结算,外汇策略为不锁价模式下,按照发起退款请求后的次日 Antom 汇率进行结算。
- 若结算币种与退款币种相同,则不涉及汇率换算。
- 是否允许部分退款:取决于买家付款所使用的支付方式。详情参见 支付方式能力对比。
- 允许退款的期限:取决于买家付款所使用的支付方式。详情参见 支付方式能力对比。
- 退款处理时效:不同的支付方式的退款处理时效有所差异,请联系技术支持了解详情。
退款方式
您可以通过 调用接口 或者在 Antom Merchant Portal 对成功支付的交易发起退款。
调用接口退款
根据支付方式的不同,调用接口退款时退款可能是同步或者是异步发生的,因此退款分为同步退款和异步退款两种逻辑:
- 同步退款:调用接口退款后,通常会直接响应退款成功或失败的状态。但不排除系统异常或支付渠道处理异常等小概率情况导致返回其他状态。
- 异步退款:调用接口退款后,响应退款处理中。需要您主动查询退款结果或等待退款结果通知来获取退款最终状态。
同步和异步退款所支持的支付方式信息如下:
同步退款 | 异步退款 |
Alipay+ 类型的所有支付方式 | 非同步退款支持的其它支付方式均为异步退款,所有支付方式请参考 支付方式列表。 |
收单机构为 2C2P HK 和 2C2P SG 时的 Mastercard 和 Visa 卡 |
表 1. 同步和异步退款支持的支付方式
同步和异步退款所支持的退款相关接口信息如下:
表 2. 同步和异步退款支持的接口能力
流程图
以下为同步退款和异步退款的工作流程图。
同步退款
图 1. 同步退款流程图
异步退款
图 2. 异步退款流程图
发起退款
通过 退款 接口发起退款时,请求中关键字段如下(具体接口调用规范请参见 退款 接口):
字段名 | 说明 |
refundRequestId | 在商家侧唯一的退款 ID。 |
paymentId | 该笔退款所对应的 Antom 分配的原始交易的 ID。 |
refundAmount | 退款金额。需要大于等于最小退款金额(通常为最小支付金额),且小于等于交易剩余可退金额。 |
refundNotifyUrl | Antom 向您发送退款异步通知地址。 |
表 3. 退款请求关键字段
使用 退款 接口发起退款需满足以下要求,否则将收到 Antom 返回的对应错误码:
退款要求 | 对应错误码 | |
退款的币种 | 退款请求中的币种 refundAmount.currency 需要与通过 支付 接口发起交易时的币种 paymentAmount.currency 保持一致。 |
|
退款金额 | 申请的退款金额 refundAmount.value 需要大于等于最小退款金额(通常与最小支付金额一致),且小于等于交易剩余可退金额。 |
|
交易状态 | 对于卡支付方式:
对于其他支付方式,仅当发起退款对应交易的状态 paymentStatus 为 |
|
退款期限 | 在支付方式支持的退款期限内允许发起退款,超过则不允许发起退款。 |
|
表 4. 退款要求
获取退款结果
对于同步和异步退款,获取退款结果的方式有所不同:
- 同步退款:
- 异步退款:
退款接口获取退款状态
在您调用 退款 接口后,Antom 会返回该次退款的受理结果。响应中的 resultStatus 字段代表该笔交易的退款状态,同步退款返回的不同状态码及状态码解释如下表所示:
resultStatus | 解释 |
| 退款成功。 |
| 退款失败。请参考 退款 接口的 resultCode 进行问题排查。 |
| 退款受理中。 对于同步退款的场景,可能存在小概率发生如下情况:
对于异步退款的场景,当 resultCode 为 |
表 5. 退款接口 refundStatus 状态码说明
调用接口查询退款
在您发起退款请求后,无论买家付款时使用的是何种支付方式,您均可以通过调用 查询交易结果 接口查询该退款的执行状态。返回结果中的 refundStatus 字段代表该笔交易的退款状态,状态码及其解释如下表所示:
refundStatus | 解释 |
| 退款处理成功。 |
| 退款执行失败。 |
| 退款处理中。 |
表 6. 查询退款接口 refundStatus 状态码说明
接收退款异步通知
欲接收退款异步通知,您需要完成退款异步通知接收地址的配置:通过 退款 接口中 refundNotifyUrl 字段传入退款异步通知接收地址或在 Antom Dashboard 配置退款异步通知接收地址。
值得注意的是只有异步退款场景下 Antom 才会通过 退款通知 接口为您发送退款通知。收到通知后,您可以通过 refundStatus 字段来了解该笔交易的退款状态,不同状态码及其解释如下表所示:
refundStatus | 解释 |
| 退款处理成功。 |
| 退款执行失败。 |
表 7. 退款通知 refundStatus 状态码说明
查询交易的退款记录
您也可以通过 查询交易结果 接口查询一笔交易的退款记录。若一笔交易发生过退款,响应中的 transactions 字段会反映该笔交易的退款情况。
通过 Antom Merchant Portal 退款
您可以通过 Antom Merchant Portal 进行退款,欲知如何发起退款并查看退款结果,可参见 通过门户交易中心退款。