{"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_WAS_ALREADY_IN_USE_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_IDEMPOTENCY_KEY_ALREADY_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_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).\n[block:html]\n{\n  \"html\": \"<style>\\n  .td p{\\n    overflow-wrap:anywhere;\\n    min-width: 60px;\\n  }\\n</style>\"\n}\n[/block]","updates":[],"order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"628531cd1258c8003f6dd277","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":"628531cd1258c8003f6dd1c9","version":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.42 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628531cd1258c8003f6dd1bf","628531cd1258c8003f6dd1c0","628531cd1258c8003f6dd1c1","628531cd1258c8003f6dd1c2","628531cd1258c8003f6dd1c3","628531cd1258c8003f6dd1c4","628531cd1258c8003f6dd1c5","628531cd1258c8003f6dd1c6","628531cd1258c8003f6dd1c7","628531cd1258c8003f6dd1c8","628531cd1258c8003f6dd1c9","628531cd1258c8003f6dd1ca","628531cd1258c8003f6dd1cb","628531cd1258c8003f6dd1cc","628531cd1258c8003f6dd1cd","628531cd1258c8003f6dd1ce","628531cd1258c8003f6dd1cf","628531cd1258c8003f6dd1d0","628531cd1258c8003f6dd1d1","628531cd1258c8003f6dd1d2"],"_id":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"622783372cd60c003782d77e","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_IDEMPOTENCY_KEY_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).