Created with Sketch.
Created with Sketch.
Checkout 3.0

Error codes

Checkout 3

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:

ErrorCodeErrorMessage
0Non specific error
100Purchase must be in completed state
101Order reference can not be changed when purchase is not completed
102User inputs can not be changed when purchase is not completed
110Authorize recurring payment can not be processed. Invalid recurring payment token or origin purchase does not meet conditions for recurring payments
120Authorize recurring payment can not be processed. Recurring payment token expired.
121Authorize recurring payment can not be processed. Recurring payment limit reached
122Authorize recurring payment can not be processed. Origin purchase is not in complete state
123Multiple parallel operation on one purchase detected
124Delivery address type can not be set for this checkout site
125Country in delivery address can not be changed for this checkout site
126Name can not be longer than 40 characters
127Address 1 can not be longer than 40 characters
128City can not be longer than 30 characters
129Invalid Zip format
130First name can not be longer than 40 characters
131Last name can not be longer than 40 characters
132Country in invoicing address can not be set for this checkout site
200Request body must be specified!
210Invalid email
211Invalid phone
300Checkout site does not exists
301B2B mode is not supported for selected merchant
302Partner setup does not support email invoice
303Partner setup does not support recurring payment
304SelectedPaymentMethodType setup is denied for Sweden market
305Unable to show B2B link, because B2B mode isn´t allowed
306Unable to show country selector, because branch settings for ShowCountryInCheckoutForm isn´t allowed
307CompleteNotificationUrl does not follow requirement of valid absolute uri path
400Description can not be longer than 35 characters
401Notes can not be longer than 35 characters
402Maximum number of decimal places allowed is 2.
403Maximum number of decimal places allowed is 2.
900Checkout token exists but does not belongs to any checkout site
901Invalid checkout token

Backoffice

ErrorCodeErrorMessage
500Processing error. Please try again later or contact technical support
501Invalid transaction id
502Invalid order reference
503Duplicity order error
504Price must be within purchase site’s limits
505Authorization not found
506Transaction type is not valid for payment method.
507Purchase denied – insufficient Customer Balance
508Return denied – insufficient Merchant/Purchase Balance
509Operation denied – PSP cannot refund money back to customer card
510Operation denied – Finnish bank cannot refund money back to customer account directly
511Operation denied – Swish cannot refund money back to customer
512CancelAuthorization denied – no such Authorization found
513CancelAuthorization denied – CancelAuthorization was allready called
514CancelAuthorization denied – PurchaseOrder, ReturnOrder or RefundOrder was allready called
515CancelAuthorization denied – Card provider is not matching
516CancelAuthorization denied – amount is not equal to the authorized amount
517Return denied – insufficient Customer Balance
518Refund error – refund can’t be used for loan/invoice purchases
519Refund error – amount must be positive.
520Refund error – Card provider is not matching
521Batch Refund error
522Confirmed Refund error
523Authorize Recurring Payment error