Error codes

Here you will find all error codes with their respective description.

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 limit
62Declined - Restricted <<glossary:SIC>> code
63Declined - Restricted
65Declined - Customer exceeds activity limit
78Declined - No accounts
97Declined - CVV mismatch

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

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

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

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
2800implausibleCardDataimplausibleCardDataPay_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_InvalidProductQuantityalidation_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
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
3621tokenizationNotAvailablePay_Exception_Tokenization_NotAvailable
3622tokenizationFailedPay_Exception_Tokenization_Failed

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