The Checkout 3 API will return errors as indicated in the example response below.
Example Request
{ "items": [{ "description": "Item description", "notes": "Some item", "amount": "100.1234", "taxCode": "20", "taxAmount": 42, "quantity": "1" }] }
Example Response
{ ... "Errors": [{ "Property": "Items[0].Amount", "ErrorCode": 0, "ErrorMessage": "Maximum number of decimal places allowed is 2." }] }, "StatusCode": 400, ...
In addition to the 400 StatusCode
, the list of possible errorCode
and errorMessage
combinations are below:
ErrorCode | ErrorMessage |
---|---|
0 | Non specific error |
100 | Purchase must be in completed state |
101 | Order reference can not be changed when purchase is not completed |
102 | User inputs can not be changed when purchase is not completed |
110 | Authorize recurring payment can not be processed. Invalid recurring payment token or origin purchase does not meet conditions for recurring payments |
120 | Authorize recurring payment can not be processed. Recurring payment token expired. |
121 | Authorize recurring payment can not be processed. Recurring payment limit reached |
122 | Authorize recurring payment can not be processed. Origin purchase is not in complete state |
123 | Multiple parallel operation on one purchase detected |
124 | Delivery address type can not be set for this checkout site |
125 | Country in delivery address can not be changed for this checkout site |
126 | Name can not be longer than 40 characters |
127 | Address 1 can not be longer than 40 characters |
128 | City can not be longer than 30 characters |
129 | Invalid Zip format |
130 | First name can not be longer than 40 characters |
131 | Last name can not be longer than 40 characters |
132 | Country in invoicing address can not be set for this checkout site |
200 | Request body must be specified! |
210 | Invalid email |
211 | Invalid phone |
300 | Checkout site does not exists |
301 | B2B mode is not supported for selected merchant |
302 | Partner setup does not support email invoice |
303 | Partner setup does not support recurring payment |
304 | SelectedPaymentMethodType setup is denied for Sweden market |
305 | Unable to show B2B link, because B2B mode isn´t allowed |
306 | Unable to show country selector, because branch settings for ShowCountryInCheckoutForm isn´t allowed |
307 | CompleteNotificationUrl does not follow requirement of valid absolute uri path |
400 | Description can not be longer than 35 characters |
401 | Notes can not be longer than 35 characters |
402 | Maximum number of decimal places allowed is 2. |
403 | Maximum number of decimal places allowed is 2. |
900 | Checkout token exists but does not belongs to any checkout site |
901 | Invalid checkout token |
ErrorCode | ErrorMessage |
---|---|
500 | Processing error. Please try again later or contact technical support |
501 | Invalid transaction id |
502 | Invalid order reference |
503 | Duplicity order error |
504 | Price must be within purchase site’s limits |
505 | Authorization not found |
506 | Transaction type is not valid for payment method. |
507 | Purchase denied – insufficient Customer Balance |
508 | Return denied – insufficient Merchant/Purchase Balance |
509 | Operation denied – PSP cannot refund money back to customer card |
510 | Operation denied – Finnish bank cannot refund money back to customer account directly |
511 | Operation denied – Swish cannot refund money back to customer |
512 | CancelAuthorization denied – no such Authorization found |
513 | CancelAuthorization denied – CancelAuthorization was allready called |
514 | CancelAuthorization denied – PurchaseOrder, ReturnOrder or RefundOrder was allready called |
515 | CancelAuthorization denied – Card provider is not matching |
516 | CancelAuthorization denied – amount is not equal to the authorized amount |
517 | Return denied – insufficient Customer Balance |
518 | Refund error – refund can’t be used for loan/invoice purchases |
519 | Refund error – amount must be positive. |
520 | Refund error – Card provider is not matching |
521 | Batch Refund error |
522 | Confirmed Refund error |
523 | Authorize Recurring Payment error |