{"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    \"0-1\": \"SAME_IDEMPOTENCY_KEY\\n_WAS_ALREADY_IN_USE\\n_WITH_PREVIOUS_DIFFERENT_REQUEST\",\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-0\": \"60102\",\n    \"1-1\": \"REQUEST_WITH_SAME\\n_IDEMPOTENCY_KEY_\\nALREADY_IN_PROGRESS\",\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-0\": \"60103\",\n    \"2-1\": \"IDEMPOTENCY_KEY_MAX\\n_LENGTH_LIMIT_EXCEEDED\",\n    \"3-0\": \"60104\",\n    \"3-1\": \"INVALID_IDEMPOTENCY_KEY\",\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":"610ac65c6d2e38006a05743c","createdAt":"2021-08-04T16:54:52.229Z","user":"606df105d9ab93003f73cb10","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"60fed21a76106200102eae14","version":"60fed21a76106200102eaec3","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.39 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["60fed21a76106200102eae0a","60fed21a76106200102eae0b","60fed21a76106200102eae0c","60fed21a76106200102eae0d","60fed21a76106200102eae0e","60fed21a76106200102eae0f","60fed21a76106200102eae10","60fed21a76106200102eae11","60fed21a76106200102eae12","60fed21a76106200102eae13","60fed21a76106200102eae14","60fed21a76106200102eae15","60fed21a76106200102eae16","60fed21a76106200102eae17","60fed21a76106200102eae18","60fed21a76106200102eae19","60fed21a76106200102eae1a","60fed21a76106200102eae1b","60fed21a76106200102eae1c","613a2bc99ca316007473ee77"],"_id":"60fed21a76106200102eaec3","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"60a40b18fa93ca00237af576","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"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).