Idempotency

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

The idempotency helps to avoid unwanted duplication in case of failures and retries. For example, idempotency can guarantee that the payment is charged only once if the same API payment call is retried multiple times in the case of a timeout error.

The WorldFirst API idempotency is enabled by an idempotency field.

Idempotency fields

The following table lists the idempotency fields of APIs. For details of the idempotency field, see the specific API chapter.

Interface endpoint name

Idempotency Field

Direction

notifyVostro

fundingId

WorldFirst > Partner

bindBeneficiary

bindBeneficiaryRequestId

Partner > WorldFirst

removeBeneficiary

removeBeneficiaryRequestId

Partner > WorldFirst

createDeal

dealRequestId

Partner > WorldFirst

unwindDeal

dealRequestId

Partner > WorldFirst

createExchange

exchangeRequestId

Partner > WorldFirst

notifyExchange

exchangeRequestId

WorldFirst > Partner

createTransfer

transferRequestId

Partner > WorldFirst

notifyTransfer

transferRequestId

WorldFirst > Partner

@2024 WorldFirst