API Idempotency
As part of MoneyHash commitment to ensuring a robust and reliable API, we offer an API Idempotency feature that enables you to make idempotent requests. This ensures that a request made to our API will have the same effect whether it is sent once or multiple times.
What is an Idempotent Request?
An idempotent HTTP request is one that can be made many times without causing any different effects than if it were made only once. This is beneficial in situations where you want to prevent duplicate processing of requests due to network issues, server errors, and so on.
How to perform Idempotent Request?
Simply add the X-Idempotency-Key
header to your POST
, PATCH
, PUT
, or DELETE
HTTP requests.
The value of the X-Idempotency-Key
header must be a unique identifier for the request. We accept only V4 UUID for generating this unique identifier.
Please remember
The
X-Api-Key
header is mandatory for each request. TheX-Idempotency-Key
is used in combination with theX-Api-Key
to uniquely identify the request.
Handling Duplicate Requests
If you attempt to resend a request with the same X-Idempotency-Key
and X-Api-Key
combination within 24 hours, MoneyHash will ensure that you receive an identical response to that of the original request. This design guarantees response consistency, even in cases where the initial request may have encountered failures.
Handling Invalid Idempotency Keys
If you send a request with an X-Idempotency-Key
value that is not a valid UUID, our system will respond with a 400 Bad Request status code and provide a message indicating that the UUID is invalid:
{
"status": {
"code": 400,
"message": "error",
"errors": [
{
"X-Idempotency-Key": "Invalid UUID"
}
]
},
"data": {},
"count": 1,
"next": null,
"previous": null
}
Supported endpoints:
Updated about 2 months ago