An API call is idempotent if the action is performed only once no matter how many times the API call is retried.

Idempotency helps to avoid unwanted duplication in case of failures and retries. For example, idempotency can guarantee that the original credit transaction (OCT) is charged only once if the same createOriginalCredit API call is retried multiple times in the case of a timeout error.

In Alipay+, API idempotency is enabled by an idempotency parameter. Idempotency parameters stay unique without a time limit.

Idempotency parameters

The following table lists the idempotency parameters of APIs. For details of the idempotency parameter, see the specific API specification.

Direction: ACQP > Alipay+

The following table lists the idempotency parameters for APIs that are used by the ACQP to call Alipay+:

Direction: Alipay+ > ACQP

For APIs that are used by Alipay+ to call the ACQP, the ACQP decides the idempotency parameters.