Idempotency keys

Our Direct Debit API endpoints support idempotency keys, to prevent the worst-case-scenario of creating a double booking, for example due to a network timeout.

This means that any request you send us can and will be only 'accepted' one single time. If you send the same request again after it has previously been accepted, our API will respond with the HTTP error code 400. Idempotency keys are optional, but highly recommended to use.

{
  "error": {
      "id": "{{errorId}}",
      "code": 400,
      "message": "IdempotencyKey {{key}} was already used at {{date}} creating entity {{entityId}}.",
      "details": []
  }
}