Error Handling
If a request to the SlimPay API fails or wasn’t accepted by the server, the type of error encountered will be indicated by an HTTP status code. This JSON-encoded message body also includes a human-readable message about what went wrong.
{
"code": XXX,
"message": "Some message to explain what our server thinks you did wrong."
}A 200 or 201 code indicates the request was successful and you can proceed with further API calls.
A 4xx code indicates there was a problem with the request that was sent, and should only happen during your development/testing phase. Common errors include 400 Bad Request, 401 Unauthorized, 403 Forbidden and 404 Not Found.
A 5xx code indicates an issue with the SlimPay server, such as 500 Internal Server Error and 503 Service Unavailable.
Please note: in the event of a 504 Gateway Timeout error, we advise you to verify the state of your payment using the API (get-payment) or the Dashboard before retrying the transaction. It's very likely the payment has actually been processed.
You can find a comprehensive list of all HTTP status codes here.
Different error codes are returned for different flow scenarios:
- Synchronous errors: returned by the API in response to an HTTP request which can't be fulfilled
- Order errors: a property of the order representation following a failed attempt during the Checkout
- Payment errors: a rejected, returned, reversed or refunded payment
Please note: the descriptions below don’t always match the specific error message of the response body.
Synchronous errors
| Code | Message |
|---|---|
| 100 | Internal error |
| 101 | Incomplete data |
| 103 | The merchant authentication has failed |
| 104 | Unknown merchant site |
| 150 | The client has aborted or cancelled the order |
| 122 | Invalid honorificPrefix property |
| 123 | Invalid givenName property |
| 124 | Invalid familyName property |
| 125 | Invalid email property |
| 127 | Invalid telephone property |
| 128 | Invalid postalCode property |
| 129 | Invalid city property |
| 133 | Invalid bic property |
| 134 | Invalid iban property |
| 135 | Invalid rum property |
| 141 | Invalid subscriber reference property |
| 142 | Invalid companyName property |
| 143 | Invalid organizationId property |
| 144 | Invalid address1 property |
| 145 | Invalid address2 property |
| 146 | Invalid country property |
| 177 | The bank account is not in the SEPA zone |
| 180 | Duplicate mandate reference |
| 191 | Invalid dateSigned property (must be present and in the past) |
| 200 | Debtor's data are unavailable |
| 201 | The mandate signature has failed |
| 202 | The code entered during the signature is invalid |
| 205 | Client data are inconsistent |
| 407 | Card operation invalid transaction reference |
| 196 | No payment scheme in the request and SlimPay cannot compute the default one according to the client configuration |
| 199 | Debtor mandate not found |
| 230 | The payment processor (sofort or ideal) does not support signature approval method (otp or checkbox). |
| 231 | The payment items are not valid. |
| 232 | The payment processor (mandate order item) and payment scheme (payment order item) are not consistent. |
| 239 | Service Unavailable |
| 102 | Request type missing |
| 105 | Incoherent timestamp |
| 108 | No customer |
| 109 | No login |
| 111 | Session timeout |
| 136 | Invalid debit amount |
| 137 | Invalid direct debit execution date |
| 138 | Invalid direct debit label |
| 139 | Invalid card amount |
| 140 | Invalid card operation type |
| 147 | Invalid transaction ID |
| 148 | Not SEPA account |
| 156 | Wrong OTP |
| 157 | Expired OTP key |
| 158 | Max OTP key try reached |
| 159 | Incoherent mandate reference |
| 160 | Max OTP key send reached |
| 161 | Invalid CSI |
| 162 | Invalid OTP channel type |
| 163 | Invalid sequence type |
| 167 | Invalid mandate signed date |
| 168 | Invalid mandate source |
| 179 | Invalid creditor |
| 181 | No documents to sign |
| 183 | Document already treated |
| 185 | Missing frequency |
| 186 | Forbidden IBAN |
| 188 | Invalid account owner |
| 193 | IP or IBAN or phone number is forbidden |
| 198 | Duplicate subscriber reference |
| 401 | Card operation bank refusal |
| 402 | Card operation access failure |
| 403 | Invalid card number |
| 404 | Invalid card cvv |
| 405 | Invalid card expiration data |
| 406 | Invalid birth date |
| 408 | Card lost |
| 409 | Card stolen |
| 410 | Card expired |
| 411 | Insufficient card funds |
| 412 | Card suspect |
| 413 | Card limit exceeded |
| 414 | Card in opposition |
| 415 | Connection to card operator failed |
| 416 | Card data missing |
| 417 | Card operation duplicate |
| 419 | Card cancelled |
| 420 | Card operator session expired |
| 421 | Existing card alias |
| 422 | Unknown card alias |
| 423 | Card operator internal error |
| 511 | Address not in SEPA country |
| 512 | Iban not in SEPA country |
| 522 | IP address or IBAN or phone number is in blacklist |
| 523 | Debtor IBAN is creditor IBAN |
| 524 | Maximum number of subscriptions for the same IBAN reached |
| 525 | Maximum number of phone numbers for the same IBAN reached |
| 529 | IBAN bank and branch code blacklisted |
| 555 | Antifraud rule violation |
| 301 | The card operation has been refused by the operator |
| 602 | The card provider returned an error |
| 631 | This account does not exist |
| 632 | Contact your bank for authorisation |
| 633 | Operation cancellation unauthorised |
| 634 | Card expired |
| 635 | Card lost |
| 636 | Card stolen |
| 637 | Check your configuration |
| 638 | Conversion rate is not found |
| 639 | Duplicated transaction |
| 640 | The usage frequency is exceeded |
| 641 | There is an opposition on the account |
| 642 | The bank is unknown |
| 643 | Invalid Card |
| 644 | Invalid PIN |
| 645 | the transaction can't be processed. |
| 646 | Invalid birthdate |
| 647 | Invalid cvv3 |
| 648 | Invalid amount |
| 649 | The amount is exceeded |
| 650 | Security violation |
| 651 | Suspicious card |
| 652 | Transaction can not be found |
| 653 | Transaction refused by card scheme |
| 654 | Unauthorised transaction |
| 655 | Card not registered |
| 656 | Fraud detected |
| 657 | Refund period exceeded |
| 661 | Card not enrolled |
| 662 | Card not participating |
| 663 | Card authentication failed |
| 664 | Can not find verify Enrollment call for this card |
| 665 | Duplicated transaction |
| 666 | Invalid PARES |
| 667 | Enrollment verification failed |
| 668 | Authentication verification failed |
| 669 | Authentication verification failed |
| 681 | Max attempts exceeded |
| 682 | Moto Contract is not set for the merchant |
| 901 | Duplicate order |
| 902 | The resource has not been found |
| 903 | Illegal state |
| 904 | Access denied |
| 905 | Unmapped error |
| 906 | Error |
| 907 | Bad Gateway : the remote server sent a wrong response |
| 908 | Currency mismatch between the request and the resource on the server |
| 909 | No payment scheme in the request and SlimPay cannot compute the default one according to the client configuration |
| 910 | The provided payment scheme is unsupported according to the client configuration |
| 911 | Credit Transfer amount is greater than the available funds of the client |
| 912 | No mandate |
| 913 | The provided request is incompatible with the client configuration |
| 914 | The provided request is invalid |
| 915 | The payment is not cancellable |
| 916 | Cannot find origin bank account |
| 917 | Cannot find destination bank account |
| 918 | There are multiple possible origin and/or destination bank accounts. You must specify them. |
| 919 | Creditor is configured with entities but entityReference is not given |
| 920 | Creditor is not configured with entities but entityReference is given |
| 921 | Creditor entity not found |
| 922 | dateFrom and dateTo are not compatible |
| 923 | Creditor is configured with entities but entityReference is not given. |
| 924 | The binary content is unreadable |
| 925 | Checkout user approval error |
| 926 | Cannot find the refunded payment. |
| 927 | The order is not cancellable |
| 928 | The card transaction is not capturable |
| 929 | The total amount to reimburse cannot be higher than the original transaction. |
| 187 | Document template not found |
| 234 | The sort code is invalid |
| 235 | The account number is invalid |
| 233 | The sort code is not found |
| 236 | The country code is invalid |
| 237 | Your bank does not accept SEPA payments |
| 241 | BIC not consistent with provided IBAN |
| 238 | The sort code is not valid |
| 240 | The payment is not refundable |
| 930 | The process of the recurrent card transaction has failed |
| 931 | You can not access to this resource |
| 1001 | Missing phone |
| 1002 | Phone number is not accessible |
| 1003 | Phone number not received |
| 1004 | Missing email |
| 1005 | Inaccessible email |
| 1008 | Email not received |
| 1009 | Code canceled |
| 1010 | Missing phone and email |
| 1011 | Code cancelled by client |
| 1020 | Order already used |
| 2000 | Forbidden access code reuse |
| 2001 | Forbidden access code override |
| 2002 | Order already in final state |
| 2003 | Registration max attempts |
| 2004 | Invalid Order. |
| 2005 | This functionality is not yet supported |
| 2008 | Order's validation failed. |
| 2011 | Order not found |
| 10000 | IBAN is blacklisted |
| 10001 | IP is blacklisted |
| 10002 | Untrusted email |
| 10003 | Address is blacklisted |
| 10004 | Name is blacklisted |
| 10005 | IP country is in country list |
| 10006 | Emailage fraud detection |
| 10007 | Invalid IBAN structure |
| 10008 | Phone is blacklisted |
| 10009 | Model mandate check |
| 10010 | Schufa rule check |
| 10100 | Card 3DS evaluation |
| 4000 | The email address or password entered is not valid. |
| 4001 | The account has been locked for security purpose. Try again in few minutes. |
| 4002 | The account has been locked for security purpose. Contact your account manager. |
| 4003 | The Dashboard account password has expired and must be updated. |
| 4004 | Missing multi-factor authentication Data. |
| 4005 | OTP code is not valid. |
| 4006 | Too many requests. |
| 4007 | OTP sms sending failed. |
| 4008 | The password entered is not valid. |
| 4009 | Multi-factor authentication has been locked for security purpose. Try again in few minutes. |
| 4010 | Multi-factor authentication has been locked for security purpose. Contact your account manager. |
| 5000 | Failed to create a Slimcollect PIS Payment Link |
| 5100 | Failed to create a Slimcollect AIS Link |
Order errors
| Code | Message |
|---|---|
| 100 | Internal error |
| 101 | Incomplete request data |
| 105 | Incoherent timestamp |
| 108 | No customer |
| 120 | Session timeout |
| 123 | Invalid given name |
| 124 | Invalid family name |
| 125 | Invalid email |
| 127 | Invalid phone number |
| 128 | Invalid postal code |
| 129 | Invalid city |
| 133 | Invalid BIC |
| 134 | Invalid IBAN |
| 158 | Max OTP key try reached |
| 160 | Max OTP key send reached |
| 179 | Invalid creditor |
| 180 | Duplicate mandate reference |
| 181 | No documents to sign |
| 186 | Forbidden IBAN |
| 188 | Invalid account owner |
| 201 | Mandate signature failed |
| 202 | Invalid user approval (OTP) code |
| 205 | Inconsistent client data during signature |
| 400 | Card operation refused by operator |
| 401 | Card operation bank refusal |
| 402 | Card operation access failure |
| 407 | Card operation invalid transaction reference |
| 408 | Card lost |
| 409 | Card stolen |
| 412 | Card suspect |
| 901 | Duplicate order |
| 902 | Resource not found |
| 903 | Illegal state |
| 905 | Unmapped error |
| 931 | You cannot access to this resource : [reason] |
| 1001 | Missing phone |
| 1002 | Phone number is not accessible |
| 1003 | Phone number not received |
| 1004 | Missing email |
| 1005 | Inaccessible email |
| 1008 | Email not received |
| 1009 | Code cancelled |
| 2000 | Forbidden access code reuse |
| 2001 | Forbidden access code override |
| 2002 | Order already in a final status |
| 2003 | Order is disabled or expired |
| 2004 | Invalid order |
| 2005 | This functionality is not yet supported |
| 2008 | Order's validation failed |
Payment errors
In the event that a direct debit or card payment fails, an error code will be returned explaining the reason for the R-transaction.
For a complete list of error codes and the reasons for payment failure, please refer to the European Payment Council guide on R-transactions. A selection of common payment failure codes for direct debit and card are listed below, and are also included on our Help Center.
For information about managing payment failures, please refer to our payment issues section.
Direct debit error codes
| Code | Reason |
|---|---|
| AC01 | Account Identifier incorrect |
| AC04 | Account closed |
| AC06 | Account blocked |
| AC13 | Debtor account is a consumer account |
| AG01 | Direct Debit forbidden on this account for regulatory reasons |
| AG02 | Operation code/transaction code/sequence type incorrect, invalid file format |
| AM04 | Insufficient funds |
| AM05 | Duplicate collection |
| BE05 | Identifier of the Creditor Incorrect |
| CNOR | Creditor Bank is not registered under this BIC in the CSM |
| DNOR | Debtor Bank is not registered under this BIC in the CSM |
| FF01 | File format incomplete or invalid |
| FOCR | Following a cancellation request (by the creditor) |
| MD01 | No mandate or Unauthorised Transaction |
| MD02 | Mandate data missing or incorrect |
| MD06 | Disputed authorised transaction |
| MD07 | Debtor Deceased |
| MS02 | Refusal by the Debtor |
| MS03 | Reason not specified |
| RC01 | Bank Identifier (BIC) Incorrect |
| RR01 | Regulatory Reason |
| RR02 | Regulatory Reason |
| RR03 | Regulatory Reason |
| RR04 | Regulatory Reason |
| SL01 | Specific Service offered by the Debtor Bank |
Card payment error codes
| Code | Reason |
|---|---|
| C01 | This account does not exist |
| C02 | Contact your bank for authorisation |
| C03 | Operation cancellation unauthorised |
| C04 | Card expired |
| C05 | Card lost |
| C06 | Card stolen |
| C07 | Check your configuration |
| C08 | Conversion rate is not found |
| C09 | Duplicated transaction |
| C10 | The usage frequency is exceeded |
| C11 | There is an opposition on the account |
| C12 | The bank is unknown |
| C13 | Invalid card number |
| C14 | Invalid PIN code |
| C15 | The transaction can't be processed |
| C16 | Invalid birthdate |
| C17 | Invalid CVV3 |
| C18 | Invalid amount |
| C19 | The amount is exceeded |
| C20 | Security violation |
| C21 | Suspicious card |
| C22 | Transaction cannot be found |
| C23 | Transaction refused by card scheme |
| C24 | Unauthorised transaction |
| C25 | Card not registered |
| C26 | Fraud detected |