{"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":"61a51e4adca83b015f8acb9e","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":"61a51e4adca83b015f8acaf0","version":"61a51e4adca83b015f8acba4","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a51e4adca83b015f8acae6","61a51e4adca83b015f8acae7","61a51e4adca83b015f8acae8","61a51e4adca83b015f8acae9","61a51e4adca83b015f8acaea","61a51e4adca83b015f8acaeb","61a51e4adca83b015f8acaec","61a51e4adca83b015f8acaed","61a51e4adca83b015f8acaee","61a51e4adca83b015f8acaef","61a51e4adca83b015f8acaf0","61a51e4adca83b015f8acaf1","61a51e4adca83b015f8acaf2","61a51e4adca83b015f8acaf3","61a51e4adca83b015f8acaf4","61a51e4adca83b015f8acaf5","61a51e4adca83b015f8acaf6","61a51e4adca83b015f8acaf7","61a51e4adca83b015f8acaf8","61a51e4adca83b015f8acaf9"],"_id":"61a51e4adca83b015f8acba4","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed21a76106200102eaec3","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"project":"57336fd5a6a9c40e00e13a0b","__v":0,"parentDoc":null}

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

iDEAL Transactions

Local Bank Transfer transactions

SEPA Direct Debit Transactions

Sofort Transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

JSON Objects

Test Data & Codes

Guides & Tools

Mobile SDK

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).