幂等性

2024-08-08 17:37

Antom 接口具备幂等性，这意味着可以多次重试同一请求，而系统只会执行一次对应的操作。这有助于在故障或重试时避免非预期的重复操作。

如果之前的请求因为临时错误或超时导致没有完成, 后续的重试将保证操作顺利完成。若操作已执行完毕，应确保该操作仅执行一次，且重试过程返回相同的结果。所有与支付相关的 Antom 接口都是幂等的。下表列出了最常用的接口及其幂等性规则。

幂等性字段

下表列出了接口的幂等性字段。每个幂等性字段的详细信息，请参阅相应的接口文档。

接口名称	幂等性字段	规则
支付	paymentRequestID	商户使用 paymentRequestId 字段进行幂等性控制。对于使用相同 paymentRequestId 值发起，且达到最终状态（`S` 或 `F` ）的支付请求，应返回相同的结果。注意：接口确保关键请求参数（例如 paymentRequestId ， paymentAmount 和 paymentMethodId ）在相关场景下的一致性。如果任何关键值与先前请求的值不同，将返回错误 `REPEAT_REQ_INCONSISTENT` 。
退款	refundRequestID	商户使用 refundRequestID 字段进行幂等性控制。对于使用相同 refundRequestID 发起，且达到最终状态（`S` 或 `F`）的退款请求，应返回相同的结果。注意：如果 refundAmount 与之前请求的值不同，将返回错误 `REPEAT_REQ_INCONSISTENT`。
请款	captureRequestId	商户使用 captureRequestId 字段进行幂等性控制。对于具有相同 captureRequestId 发起，且达到最终状态（`S` 或 `F`）的请款请求，应返回相同的请求结果。注意：如果 captureAmount 的值与先前请求不同，应返回错误 `REPEAT_REQ_INCONSISTENT`。
注册	registrationRequestId	商户使用 registrationRequestId 字段来实现幂等性控制。对于使用相同 registrationRequestId 发起，且达到最终状态（`S` 或 `F`）的注册请求，应返回相同的结果。
授权初始化	authenticationRequestId	商户使用 authenticationRequestId 字段进行幂等性控制。对于使用相同 authenticationRequestId 发起，且达到最终状态（ `S` 或 `F` ）的初始化授权请求，应返回相同的结果。

表1. 幂等性字段及其对应的处理规则