Idempotent Requests

The Wizit API supports idempotency that allows the safe retry of requests, guaranteeing the operation is only performed once.

For example, if a refund request fails with a network error, the request can be retried with the same requestId and merchantReference. This is especially important for partial refunds to ensure retry attempts are not processed as separate refunds.

Wizit recommends that merchants generate UUIDs for use as request IDs. The resources that include a requestId may send back the same response.


When performing an idempotent retry of an API request, a response with response code 412 may be encountered. This generally indicates that the original request was received, but is still processing. Please try again in a few moments, and repeat with the same requestId until something other than a 412 response is received.