{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Idempotency Errors","type":"basic","slug":"idempotency-errors","excerpt":"(Coming Soon)","body":"##Idempotency errors\n\nWhen the `Idempotency-Key` header is used, BlueSnap may return one of the following errors:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"60101\",\n    \"1-0\": \"60102\",\n    \"2-0\": \"60103\",\n    \"3-0\": \"60104\",\n    \"0-1\": \"SAME_IDEMPOTENCY_KEY\\n_WAS_ALREADY_IN_USE\\n_WITH_PREVIOUS_DIFFERENT_REQUEST\",\n    \"1-1\": \"REQUEST_WITH_SAME\\n_IDEMPOTENCY_KEY_\\nALREADY_IN_PROGRESS\",\n    \"2-1\": \"IDEMPOTENCY_KEY_MAX\\n_LENGTH_LIMIT_EXCEEDED\",\n    \"3-1\": \"INVALID_IDEMPOTENCY_KEY\",\n    \"0-2\": \"This occurs if there is an attempt to reuse an `Idempotency-Key` with a request different from the first request attempt. BlueSnap will respond with HTTP 422 status code [Unprocessable Entity].\",\n    \"1-2\": \"This occurs if a request is retried using the same `Idempotency-Key` as the original request while it is still being processed. BlueSnap will respond with HTTP 409 status code [Conflict].\",\n    \"2-2\": \"This occurs if the `Idempotency-Key` header exceeds the maximum length of 64 characters.\",\n    \"3-2\": \"This occurs if the `Idempotency-Key` header contains invalid characters. It can only contain Alpha-Numeric characters or hyphens.\"\n  },\n  \"cols\": 3,\n  \"rows\": 4\n}\n[/block]\nFor more information about idempotency, refer to [Idempotency (Coming Soon)](https://developers.bluesnap.com/v8976-Basics/docs/idempotency).","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"61a5208deadb750070998f47","createdAt":"2021-08-12T13:34:14.932Z","user":"606df105d9ab93003f73cb10","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"61a5208deadb750070998e92","version":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5208deadb750070998e87","61a5208deadb750070998e88","61a5208deadb750070998e89","61a5208deadb750070998e8a","61a5208deadb750070998e8b","61a5208deadb750070998e8c","61a5208deadb750070998e8d","61a5208deadb750070998e8e","61a5208deadb750070998e8f","61a5208deadb750070998e90","61a5208deadb750070998e91","61a5208deadb750070998e92","61a5208deadb750070998e93","61a5208deadb750070998e94","61a5208deadb750070998e95","61a5208deadb750070998e96","61a5208deadb750070998e97","61a5208deadb750070998e98","61a5208deadb750070998e99","61a5208deadb750070998e9a"],"_id":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed269718a45001c25b4a0","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}

Idempotency Errors

(Coming Soon)

Idempotency errors

When the Idempotency-Key header is used, BlueSnap may return one of the following errors:

Code
Name
Description

60101

SAME_IDEMPOTENCY_KEY
_WAS_ALREADY_IN_USE
_WITH_PREVIOUS_DIFFERENT_REQUEST

This occurs if there is an attempt to reuse an Idempotency-Key with a request different from the first request attempt. BlueSnap will respond with HTTP 422 status code [Unprocessable Entity].

60102

REQUEST_WITH_SAME
_IDEMPOTENCYKEY
ALREADY_IN_PROGRESS

This occurs if a request is retried using the same Idempotency-Key as the original request while it is still being processed. BlueSnap will respond with HTTP 409 status code [Conflict].

60103

IDEMPOTENCY_KEY_MAX
_LENGTH_LIMIT_EXCEEDED

This occurs if the Idempotency-Key header exceeds the maximum length of 64 characters.

60104

INVALID_IDEMPOTENCY_KEY

This occurs if the Idempotency-Key header contains invalid characters. It can only contain Alpha-Numeric characters or hyphens.

For more information about idempotency, refer to Idempotency (Coming Soon).