Error codes

Whenever an error occurs, an error code is included in the response body for easy identification, benefiting both you and us in quickly pinpointing the error.

📘

We're refining the structure of our error codes.

We are revamping our error code structure to better convey the operation/platform where they error occurred.

Have a look at the "Legacy error codes" or the "New error codes" section.

Legacy error codes

These error codes are shown in our current API stack. Be it on the <<glossary:Global Management System>> or the "legacy" pay.nl <<glossary:Transaction Gateway Unit>> core.

Platform errorcodes

These are the errors that are thrown by our platform.

Error code Error Message Description

PAY‑001

Transaction not found

Wrong <glossary:transactionID> or transaction is archived.

PAY‑004

Service not found

Calling the transaction API with a wrong <glossary:serviceID> or in a wrong format (SL-####-####).

PAY-013

Transaction in chargeback mode

If a transaction is chargebacked, you should not refund to prevent money loss.

PAY-014

Refund too Fast

To prevent refunds by accident, you can't refund the same transaction more than 1 times per 6 seconds.

PAY-015

Refund amount invalid

You send in a wrong refund amount (for instance a negative refund amount) or no amount at all.

PAY‑404

Card not found

The order or checkout-cart is not found.

PAY‑405

Parameter 'paymentProfileId or amount' is invalid: One of them should be set

No amount or payment option set, can't send the transaction to the payment options without this data.

PAY‑406

Transaction can't be cancelled, It's in a PAID, VERIFY or AUTHORISE state.

Canceling by API can only be done with PENDING state.

PAY‑407

Boarding of Payment option (PAYMENT_OPTION_ID) is not completed for this sales location (SL-####-####)

Transactions can only be started if a payment option is fully boarded with the Payment Method, check the status of the payment method on the used the sales location.

PAY‑408

Payment option (PAYMENT_OPTION_ID) is not activated for this Sales Location (SL-####-####) or merchant (M-####-####)

You can only start transactions if the Payment option is activated in the Sales Location.

PAY‑409

Amount is not allowed (AMOUNT)

The provided transaction amount is not within the min and max amount for this saleslocation.

PAY‑410

Maximum amount (AMOUNT) exceeded for payment option (PAYMENT_OPTION_ID)

The maximum transaction amount for the used payment option is exceeded.

PAY‑411

There is no active Authorisation for this transaction

The transaction cannot be captured as there is no active reservation. Please check the state of this transaction.

PAY‑412

This Transaction is already captured)

The transaction has already been captured, no option to perform an new capture.

PAY-2828

Mandatory field is missing, invalid or has an empty value.

Please check the fields you send in and try again.

PAY-2830

Date not in range

The supplied date is not in range. E.g. if you create a paymentlink you can set an expire date. The max expire date that you can supply is now() + 4weeks

PAY-2840

Invalid BIC code

The supplies BIC is not valid. Use a valid BIC code.

PAY-2842

Invalid region

The supplied regionCode is not valid. The regionCode supplied needs be part of the ISO 3166-2 standards

PAY-3839

Invalid VAT

The supplied VAT number is not valid. We validate the VAT number in the VIES system (https://ec.europa.eu/taxation_customs/vies/#/vat-validation). Make sure to supply a valid VAT number

PAY-3000

Failed to add refund: Refunden naar clearing rekening niet geactiveerd.
(refunding to clearing account is not activated).

Refunding to the registered bank account of your company is not activated, if you want to send funds back to the clearing account you can use the clearing options

PAY‑3002

Transaction not successful because of an insufficient balance

Balance should be sufficient to be able to perform payments

PAY‑3003

Refund was not complete

General error, please contact PAY to investigate.

PAY‑3008

Bank account holder name is not provided, log in to the PAY admin and enter the name of the bank account holder.

SEPA refunds cannot be processed without a bank account holder name. You can select a manual refund and enter the name if it's not received via the original payment.

Card Payments error codes

In general the code 00 is being used for successful transactions.

There are different error codes. 05 is the most common error code. For a complete overview, please view the table below.

CodeDescription
01Declined - Call issuer
04Declined - Pick up card
05Declined - Do not honor
10Declined - Partial approval
12Declined - Invalid transaction
13Declined - Card amount invalid
14Declined - Card number is invalidWe received a message from the issuer that the card could not be checked or is not valid. Try again later or ask the user if the card is cancelled if this happens on a refund.
15Declined - No such issuer
19Declined - Re-enter
51Declined - Insufficient funds
54Declined - Card expired
57Declined - Service not allowed
61Declined - Customer exceeds withdrawal limitThe user did too many payments on card level without 3DS or Pincode validation (<<SCA>>), the bank will not approve transactions until a SCA payment is completed.
62Declined - Restricted <<glossary:SIC>> code
63Declined - Restricted
65Declined - Customer exceeds activity limit
78Declined - No accounts
94Duplicate transaction detectedIssuer or the network thinks you have send one transaction twice, mainly because of same amount in short time. Change the amount of you are testing.
97Declined - CVV mismatch
-Blocked: Limit ExceededThe user did too many attempts, we block the auth request because the issuer will not approve the transaction and non-compliance fee's can apply. User will have more new attempts after 2, 6 and 12 hours.

Direct Debit Error codes

A direct debit can be declined after it's send to the bank. This is not an synchronical process, so the status can change in the 5 days after sending a payment in. A status change will perform a exchange call to the application

Consumer BankPAY.Description
MS03109Administrative reason: maximum amount per direct debit order exceeded.
RR01109Administrative reason: no debtor's IBAN.
RR02109Administrative reason: no debtor's IBAN.
RR03109Administrative reason: no creditor's name
RR04109Administrative reason: the transaction does not comply with the statutory requirements.
SL01109Administrative reason: the direct debit is greater than the maximum amount or the maximum number of direct debits specified by the debtor.
RC01109Administrative reason
AM04109Administrative reason: the maximum amount per direct debit order exceeded.
AC04112Rekeningnummer vervallen
MD07112The debtor is deceased.
AC01115The IBAN from which you wish to collect the direct debit is incorrect.
MD01118There is no correct registration of the mandate or the debtor has withdrawn the mandate.
MD02118Your direct debit order stated that the details have changed but you did not enter the changed details.
MD06121Your debtor does not agree with the debit.
MS02121Your debtor does not agree with the debit.
AM05124You have already submitted this direct debit batch.
AG01274The IBAN from which you wish to collect the direct debit has been closed.
AC06277The IBAN from which you wish to collect the direct debit is blocked for (these) direct debits. The debtor or the debtor's bank may have blocked the account.
AC13277You cannot use Business Euro Direct Debit to collect direct debits from private accounts.
Other286No reason specified.

10 System errors (config/transaction/internal calls)

1000cannotFindTransactionPay_Exception_CannotFetchOrderData
1001cannotFindTransactionPay_Exception_InvalidOrderData
1004cannotDetermineNextURLPay_Exception_CannotDetermineNextURL
1005cannotFindTransactionPay_Exception_Transaction_CouldNotInstantiate
1006invalidRequestPay_Exception_RequestLimitReached
1007invalidRequestPay_Exception_TooManyRequests

14 API errors (rights)

1401noRightsPay_Exception_API_NoRights
1402noRightsPay_Exception_API_NoRightsPaymentCseData
1403noRightsPay_Exception_API_NoRightsPaymentCardData
1404noRightsPay_Exception_API_NoRightsPaymentTokenId

20 request parameters

2000requestDeniedPay_Exception_Request_NotTrustedSource
2001actionNotAuthorizedPay_Exception_Request_ActionNotAuthorized **
2002cannotFindTransactionPay_Exception_Request_InvalidOrderId
2003cannotFindTransactionPay_Exception_Request_InvalidEntranceCode
2005invalidRequestPay_Exception_Request_InvalidLanguageCode
2006invalidRequestPay_Exception_Request_InvalidThreeDsTransactionId
2007invalidRequestPay_Exception_Request_InvalidPaymentProfile
2008invalidRequestPay_Exception_Request_Invalid
2009invalidRequestPay_Exception_Request_InvalidServiceId
2010invalidRequestPay_Exception_Request_InvalidToken
2011invalidRequestPay_Exception_Request_InvalidAmount
2012invalidRequestPay_Exception_Request_InvalidPaymentMethod
2013invalidRequestPay_Exception_Request_ServiceNotReady
2014invalidRequestPay_Exception_Request_InvalidRequestToken

21 Transaction status

2102paymentAlreadyCompletedPay_Exception_PaymentStatus_AlreadyCompleted
2103paymentCancelledPay_Exception_PaymentStatus_Cancelled
2104paymentFailedPay_Exception_PaymentStatus_Failed
2105awaitingVerifyPay_Exception_PaymentStatus_AwaitingVerify
2106paymentExpiredPay_Exception_PaymentStatus_Expired

22 risk checks

2201paymentDeclinedPay_Exception_Risk_Blacklisted
2202cardNotAcceptedPay_Exception_Transaction_BusinessCardNotAccepted
2203cardNotAcceptedPay_Exception_Transaction_ConsumerCardNotAccepted
2204paymentDeclinedPay_Exception_Risk_OnlyFull3DSecureAccepted
2205paymentDeclinedPay_Exception_Risk_Only3DSecureAccepted
2206awaitingVerifyPay_Exception_Risk_CheckDeny
2207paymentDeclinedPay_Exception_Risk_CheckDecline
2208paymentDeclinedPay_Exception_Risk_BinBlocked

24 authentication

2400authenticationFailedPay_Exception_Authentication_InvalidResponse
2401authenticationFailedPay_Exception_Authentication_Request_AuthenticateFailed
2402authenticationFailedPay_Exception_Authentication_Request_EnrollmentFailed
2403authenticationFailedPay_Exception_Authentication_Request_StartFailed
2404authenticationFailedPay_Exception_Authentication_Request_StatusFailed
2405authenticationFailedPay_Exception_Authentication_Request_BinFailed

240 Requests to Authentication provider

2400authenticationFailedPay_Exception_Authentication_InvalidResponse
2401authenticationFailedPay_Exception_Authentication_Request_AuthenticateFailed
2402authenticationFailedPay_Exception_Authentication_Request_EnrollmentFailed
2403authenticationFailedPay_Exception_Authentication_Request_StartFailed
2404authenticationFailedPay_Exception_Authentication_Request_StatusFailed
2405authenticationFailedPay_Exception_Authentication_Request_BinFailed
2410authenticationFailedPay_Exception_Authentication_NotAuthenticated
2411cardNotEnrolledPay_Exception_Authentication_Not3ds2Enrolled
2412cardNotEnrolledPay_Exception_Authentication_Not3ds2EnrolledRetryableAnotherAcquirer
2413authenticationFailedPay_Exception_Authentication_FrictionlessFailed

242 Authentication result/status

2422threeDSSessionPendingPay_Exception_Authentication_Status_Pending
2423threeDSSessionExpiredPay_Exception_Authentication_Status_Expired
2424threeDSSessionCancelledPay_Exception_Authentication_Status_Cancelled
2425authenticationFailedPay_Exception_Authentication_Status_Failed

28 field validation

28implausibleCardDataPay_Exception_Validation_Field
2800implausibleCardDataPay_Exception_Validation_Field_InvalidCardHolderData
2801cvcInvalidPay_Exception_Validation_Field_CVCNonMatch
2802expiredCardPay_Exception_Validation_Field_CardExpired
2803invalidExpireDatePay_Exception_Validation_Field_InvalidExpireDate **
2804invalidCardNumberPay_Exception_Validation_Field_InvalidCardNumber
2805invalidCardHolderNamePay_Exception_Validation_Field_InvalidCardHolderName
2806invalidCardCVCPay_Exception_Validation_Field_InvalidCardCVC
2851invalidCurrencyCodePay_Exception_Validation_Field_InvalidCurrencyCode
2852invalidExpireDatePay_Exception_Validation_Field_InvalidTransactionExpireDate
2853invalidCustomerTrustPay_Exception_Validation_Field_InvalidCustomerTrust
2854invalidDobPay_Exception_Validation_Field_InvalidDob
2855invalidLanguagePay_Exception_Validation_Field_InvalidLanguage
2856invalidInitialsPay_Exception_Validation_Field_InvalidInitials
2857invalidLastNamePay_Exception_Validation_Field_InvalidLastName
2858invalidGenderPay_Exception_Validation_Field_InvalidGender
2859invalidStreetNumberPay_Exception_Validation_Field_InvalidStreetNumber
2860invalidZipCodePay_Exception_Validation_Field_InvalidZipCode
2861invalidCityPay_Exception_Validation_Field_InvalidCity
2862invalidCocNumberPay_Exception_Validation_Field_InvalidCocNumber
2863invalidVatNumberPay_Exception_Validation_Field_InvalidVatNumber
2864invalidDeliveryDatePay_Exception_Validation_Field_InvalidDeliveryDate
2865invalidInvoiceDatePay_Exception_Validation_Field_InvalidInvoiceDate
2866invalidProductIdPay_Exception_Validation_Field_InvalidProductId
2867invalidProductPricePay_Exception_Validation_Field_InvalidProductPrice
2868invalidProductQuantityPay_Exception_Validation_Field_InvalidProductQuantity

29 3DS data validation

29authenticationFailedPay_Exception_Validation_Tds
2901authenticationFailedPay_Exception_Validation_Tds_BrowserJavaEnabled
2902authenticationFailedPay_Exception_Validation_Tds_BrowserJavascriptEnabled
2903authenticationFailedPay_Exception_Validation_Tds_BrowserLanguage
2904authenticationFailedPay_Exception_Validation_Tds_BrowserColorDepth
2905authenticationFailedPay_Exception_Validation_Tds_BrowserScreenHeight
2906authenticationFailedPay_Exception_Validation_Tds_BrowserScreenWidth
2907authenticationFailedPay_Exception_Validation_Tds_BrowserTZ

3 Processing

30 acquirer

3000errGeneralPay_Exception_Authorization
3001refundNotPossiblePay_Exception_Authorization_RefundNotPossible
3002refundNotSuccessPay_Exception_Acquirer_Request_RefundFailed
3003refundNotComplete
3006refundAmountTooHigh
3007refundAmountInvalidPay_Exception_Authorization_RefundInvalidAmount
3021reversalNotPossiblePay_Exception_Authorization_ReversalNotPossible
3022reversalFailedPay_Exception_Acquirer_Request_ReversalFailed
3042authorizeFailedPay_Exception_Acquirer_Request_AuthorizeFailed
3061captureNotPossiblePay_Exception_Authorization_CaptureNotPossible
3062captureFailedPay_Exception_Acquirer_Request_CaptureFailed
3063captureNotPossiblePay_Exception_Authorization_CapturePartialNotPossible
3066captureAmountTooHighPay_Exception_Authorization_CaptureAmountTooHigh
3080cardNotAcceptedPay_Exception_Authorization_VelocityCheckDecline24H
3081cardNotAcceptedPay_Exception_Authorization_VelocityCheckDeclineMac03
3082cardNotAcceptedPay_Exception_Authorization_VelocityCheckDeclineLimitExceeded
3091cardNotEnrolledPay_Exception_Acquirer_Request_EnrollmentFailed
3092statusCannotBeDeterminedPay_Exception_Acquirer_Request_StatusFailed
3093statusNotPossiblePay_Exception_Authorization_StatusNotPossible
3099requestFailedPay_Exception_Authorization_Request_InvalidTransactionData

32 Authorization

3200cardNotAcceptedPay_Exception_Authorization_CardNotAccepted
3201referToCardIssuerPay_Exception_Authorization_Declined
3202referToCardIssuerPay_Exception_Authorization_DeclinedNon3ds
3203referToCardIssuerPay_Exception_Authorization_DeclinedFraud
3204referToCardIssuerPay_Exception_Authorization_Failed
3205referToCardIssuerPay_Exception_Authorization_DoNotHonour
3206invalidCardNumberPay_Exception_Authorization_InvalidCardNumber
3207expiredCardPay_Exception_Authorization_ExpiredCard
3208cvcInvalidPay_Exception_Authorization_CVCNonMatch
3210notSufficientFundsPay_Exception_Authorization_NotSufficientFunds
3211referToCardIssuerPay_Exception_Authorization_LackofSCA
3212referToCardIssuerPay_Exception_Authorization_CVCNotProcessed
3231invalidEciPay_Exception_Authorization_ThreeDsECIInvalid
3232invalidInitialTraceIdPay_Exception_Authorization_InitialTraceIdNotFound
3233invalidCryptogramPay_Exception_Authorization_CryptogramInvalid
3297systemErrorPleaseRetryPay_Exception_Authorization_TimeOut
3298systemErrorPleaseRetryPay_Exception_Authorization_InvalidConfiguration
3299systemErrorPleaseRetryPay_Exception_Authorization_SystemError

33 Wallet

3301walletCannotProcessPaymentPay_Exception_Wallet_TokenEmpty
3302walletCannotProcessPaymentPay_Exception_Wallet_TokenCannotDecode
3303walletCannotProcessPaymentPay_Exception_Wallet_UnsealFailed
3304walletCannotProcessPaymentPay_Exception_Wallet_NotSupported
3305walletCannotProcessPaymentPay_Exception_Wallet_TokenNotSupported
3308walletCannotProcessPaymentPay_Exception_Wallet_InvalidMerchant
3309walletCannotProcessPaymentPay_Exception_Wallet_TokenExpired

36 Card tokens (vault)

3601invalidCardTokenIdPay_Exception_Token_InvalidId
3602invalidCardTokenHashPay_Exception_Token_InvalidHash
3603cardNotFoundPay_Exception_Token_CardNotFound
3604invalidCardTokenPay_Exception_Token_InvalidCardToken
3621tokenizationNotAvailablePay_Exception_Tokenization_NotAvailable
3622tokenizationFailedPay_Exception_Tokenization_Failed
3623invalidInitialTraceIdPay_Exception_Authorization_Request_InvalidInitialTraceId

37 CSE

3701requestFailedPay_Exception_Request_PayloadInvalid
3702requestFailedPay_Exception_Request_PayloadMissingData
3703requestFailedPay_Exception_Request_PayloadMissingIdentifier
3720requestFailedPay_Exception_CannotGenerateKeys
3721requestFailedPay_Exception_CannotLoadKeys
3722requestFailedPay_Exception_CannotDecryptKeys

40 System Configuration

4001serviceUnavailablePay_Exception_Acquirer_CannotBeInstantiated
4002serviceUnavailablePay_Exception_Acquirer_BrandNotAvailable
4003serviceUnavailablePay_Exception_Acquirer_ConfigurationMissing
4004serviceUnavailablePay_Exception_Acquirer_ConfigurationErroneous
4005serviceUnavailablePay_Exception_Acquirer_StrategyMaxLoop

50 Terminal Transactions

PAY-5001Terminal not ConnectedPay_Exception_Terminal_Disconnected
PAY-5002Terminal busyPay_Exception_Terminal_In_Use

New error codes

🚧

This section is under active development

The contents will continue to change as we roll out new API's

Generic error codes error

These status codes will be shown on a generic error that is not enriched or attached to any specific operation.

A "PAY-0" error code will be returned for an error that is unmapped in our system.

CodeMessage
PAY-1400Bad request
PAY-1401Authentication is needed to access this resource
PAY-1403Access denied
PAY-1404The requested resource is not found
PAY-1405The request method is not supported by the target resource
PAY-1406There is no content that is acceptable by this server
PAY-1407The proxy needs to authenticate itself
PAY-1408The request timed out
PAY-1409This request conflicts
PAY-1410The requested resource is no longer available
PAY-1411The request is missing a content-length header
PAY-1412The server cannot meet the indicated preconditions
PAY-1413The given payload is too large for this server to handle
PAY-1414The request URI is too long for this server to handle
PAY-1415The server does not support the requested media type
PAY-1416The server is unable to fulfill the requested range
PAY-1417The server cannot meet the requested expectation
PAY-1418I refuses the attempt to brew coffee with a teapot
PAY-1421This request was directed at a server that is not able to produce a response
PAY-1422Unable to process the request
PAY-1423The requested resource is locked by another process.
PAY-1426A protocol upgrade is required
PAY-1428A precondition is required
PAY-1429Too many requests
PAY-1431The headers in the request are too large for this server to handle
PAY-1481The request method is not supported
PAY-1500An internal error has occurred
PAY-1502Bad gateway
PAY-1503The server is unable to handle your request, try again later.
PAY-1504The gateway timed out

TransactionOperation

These errors arise when an operation on any <<glossary:Transaction Gateway Unit>> encounters an error. These status codes will be returned beginning with the Order:Create API.

For any Transaction API, its original status code will be returned, as indicated in the "Legacy Error Codes" section.

CodeMessage
PAY-2000Operation not allowed.
PAY-2001The requested order could not be found.
PAY-2002The order amount is too low.
PAY-2003The order amount is too high.
PAY-2004The order cannot be approved.
PAY-2005The order cannot be declined.
PAY-2006Order cannot be captured, the amount is invalid.
PAY-2007The order is already captured.
PAY-2008The order cannot be captured.
PAY-2009The order cannot be voided.
PAY-2010The order cannot be aborted.
PAY-2011This service is blocked
PAY-2100The requested payment could not be found.
PAY-2102The payment amount is too low.
PAY-2103The payment amount is too high.
PAY-2104The requested payment method is invalid.
PAY-2105The chosen issuer is unknown.
PAY-2106Issuer is temporarily unavailable.
PAY-2107The chosen pin terminal is not ready to be used.
PAY-2108The chosen pin terminal is not connected
PAY-2109The payment cannot be approved.
PAY-2110The payment cannot be declined.
PAY-2111Payment cannot be captured, the amount is invalid.
PAY-2112The payment cannot be captured.
PAY-2113The payment is already captured.
PAY-2114The payment cannot be voided.
PAY-2115The payment cannot be aborted.
PAY-2116The chosen pin terminal is not found.
PAY-2117The chosen pin terminal is not configured to refund.
PAY-2118This payment attempt is denied by the supplier.
PAY-2119There is missing required data in the provided input.
PAY-2200An error occurred, we are unable to process your request
PAY-2210Refund not allowed on terminal (refund not activated / configured)
PAY-2211Refund exceeds the maximum transaction amount
PAY-2212Refund exceeds the maximum daily amount allowed
PAY-2213Refund exceeds the maximum number of daily allowed refunds
PAY-2214Network does not support refunds

AccountManagement & Authentication

These error codes are shown in our new Account Management and Authentication API's.

CodeMessage
PAY-6000Unable to use the provided phone number, try another one.
PAY-60012FA is not initialized.
PAY-6002Either 2FA is not enabled or not set to SMS.
PAY-60032FA method is not supported.
PAY-6004The mfa challenge is invalid.
PAY-6005Unable to send SMS verification.
PAY-6006Password token is invalid or expired.
PAY-6007Invalid credentials.
PAY-6008Token to change email is invalid or expired.
PAY-6009Your authentication session has expired. To continue, please restart the login process.
PAY-6010The operation cannot be completed in the current authentication session state.
PAY-6011This authentication session has already been used to generate an authentication token. If you have lost the token and need a new one, please restart the login process.
PAY-6012This refresh token is consumed too early. Please try again later.
PAY-6013The refresh token has expired.
PAY-6014This refresh token has already been consumed to obtain a new access token. If you have lost the token and need a new one, please restart the login process.
PAY-6015This authentication session is already revoked. To continue, please restart the login process.
PAY-6016The MFA method is either not enabled or challenged.
PAY-6017The phone number provided does not match our records.
PAY-6018Resetting your MFA trough phone number verification is blocked after too many attempts.
PAY-6019You currently have no active MFA challenge, but your MFA method requires one to be issued.
PAY-6020You are not authorized for this application.
PAY-6021Too many authentication attempts. You have been blocked for 15 minutes. Please try again later.
PAY-6022Your account has been locked out. Please try again later.
PAY-6023Your authentication attempt has been denied.