Error codes

An error code looks like [PREFIX]_[CODE] or:

[PREFIX] defines the application layer where the error occurred
[CODE] is the numeric code of the error.

There are different prefixes:

PREFIX DESCRIPTION EXAMPLE OF AN ERROR
ACQ Error on the acquirer side ACQ_001
AUTH Authentication error AUTH_149
CLIENT JavaScript application error (in the buyer's browser) CLIENT_003
INT Integration error (on the merchant side) INT_007
PSP Error on the PSP side PSP_001

Errors are returned using 4 parameters:

{
  "errorCode": "INT_015",
  "errorMessage": "invalid customer email",
  "detailedErrorCode": null,
  "detailedErrorMessage": "Invalid input value [name=customer.email, value=fake-email]"
}
PARAMETER DESCRIPTION TYPE
errorCode Error code string (in [PREFIX]_[CODE] format)
errorMessage Error message string
detailedErrorCode Detailed error code string (or null)
detailedErrorMessage Detailed message string (or null)

New error codes can be added in the future. Your implementation must imperatively take this fact into account.

ACQ errors

These errors occur on the merchant acquirer's side (bank).

ERROR DEFINITION CODE
ACQ_001 Payment declined
ACQ_999 Technical error

The code of acquirer's authorization rejection is returned in detailedErrorCode. These codes are returned without any modifications. They are specific to each acquirer.

For example, if a VISA card is rejected because it was identified as stolen, the structure of the error will be:

{
  "errorCode": "ACQ_001",
  "errorMessage": "payment refused",
  "detailedErrorCode": "43",
  "detailedErrorMessage": "Stolen card"
}

The most frequent detailed error codes (detailedErrorCode) are:

GROUP OF ERRORS DESCRIPTION
CB, Visa and Mastercard cards (France) Return codes specific to the CB network
American Express cards Codes returned by AMEX Global acquirer

AUTH errors

AUTH errors (as in “authentication”) are usually linked to issues with authentication servers (e.g. during 3D Secure).

ERROR CODE DEFINITION
AUTH_100 Invalid ACS signature
AUTH_101 Technical error 3DS
AUTH_102 Wrong 3DS parameter
AUTH_103 3DS disabled
AUTH_149 3DS operation timeout
AUTH_999 Technical error

CLIENT errors

These errors occur in the buyer's browser. They occur before the payment data is sent to our servers. This concerns, for example, local form data validation errors or JavaScript client integration errors.

For more information, see the JavaScript client documentation.

INT errors

INT errors (as in “integration”) are usually linked to issues with integration on the merchant side.

Code DEFINITION
INT_005 The manualValidation parameter is invalid
INT_006 The captureDelay or expectedCaptureDate parameter is invalid
INT_009 The amount parameter is invalid
INT_010 The currency parameter is invalid
INT_012 The customer.language parameter is invalid
INT_013 The orderId parameter is invalid
INT_015 The customer.email parameter is invalid
INT_016 The customer.reference parameter is invalid
INT_017 The customer.billingDetails.title parameter is invalid
INT_019 The customer.billingDetails.address parameter is invalid
INT_020 The customer.billingDetails.zipCode parameter is invalid
INT_021 The customer.billingDetails.city parameter is invalid
INT_022 The customer.billingDetails.country parameter is invalid
INT_023 The customer.billingDetails.phoneNumber parameter is invalid
INT_030 The paymentMethodToken parameter is invalid
INT_031 The contrib parameter is invalid
INT_040 The pan parameter is invalid
INT_041 The expiryMonth parameter is invalid
INT_042 The expiryYear parameter is invalid
INT_043 The securityCode parameter is invalid
INT_050 The strongAuthentication parameter is invalid
INT_060 The paymentSource parameter is invalid
INT_062 The mid parameter is invalid
INT_064 The rrule parameter is invalid
INT_066 The initialAmount parameter is invalid
INT_068 The initialAmountNumber parameter is invalid
INT_069 The effectDate parameter is invalid
INT_077 The customer.shippingDetails.cellPhoneNumber parameter is invalid
INT_081 The customer.shippingDetails.address parameter is invalid
INT_082 The customer.shippingDetails.address2 parameter is invalid
INT_083 The customer.shippingDetails.city parameter is invalid
INT_084 The customer.shippingDetails.state parameter is invalid
INT_085 The customer.shippingDetails.zipCode parameter is invalid
INT_086 The customer.shippingDetails.country parameter is invalid
INT_087 The customer.shippingDetails.address2 parameter is invalid
INT_088 The customer.billingDetails.state parameter is invalid
INT_091 The metadata parameter is invalid
INT_092 The customer.billingDetails.category parameter is invalid
INT_093 The customer.shippingDetails.category parameter is invalid
INT_095 The customer.shippingDetails.shippingMethod parameter is invalid
INT_095 The customer.shippingDetails.shippingSpeed parameter is invalid
INT_096 The customer.shippingDetails.deliveryCompanyName parameter is invalid
INT_097 The cartItemInfo.productLabel parameter is invalid
INT_098 The cartItemInfo.productType parameter is invalid
INT_100 The cartItemInfo.productRef parameter is invalid
INT_101 The cartItemInfo.productQty parameter is invalid
INT_102 The cartItemInfo.productAmount parameter is invalid
INT_104 The customer.billingDetails.firstName parameter is invalid
INT_105 The customer.billingDetails.lastName parameter is invalid
INT_106 The customer.shippingDetails.firstName parameter is invalid
INT_107 The customer.shippingDetails.lastName parameter is invalid
INT_108 The customer.shoppingCart.taxAmount parameter is invalid
INT_109 The customer.shoppingCart.shippingAmount parameter is invalid
INT_110 The customer.shoppingCart.insuranceAmount parameter is invalid
INT_112 The customer.billingDetails.streetNumber parameter is invalid
INT_113 The customer.billingDetails.district parameter is invalid
INT_114 The customer.shippingDetails.streetNumber parameter is invalid
INT_115 The customer.shippingDetails.district parameter is invalid
INT_121 The customer.billingDetails.legalName parameter is invalid
INT_124 The customer.billingDetails.identityCode parameter is invalid
INT_125 The customer.shippingDetails.legalName parameter is invalid
INT_130 The acquirerTransientData parameter is invalid
INT_131 The overridePaymentCinematic parameter is invalid
INT_102 The cartItemInfo.productVat parameter is invalid
INT_873 The fingerPrintId parameter is invalid
INT_874 The paymentMethodType parameter is invalid
INT_875 The formAction parameter is invalid
INT_876 The payload parameter is invalid
INT_877 The customer.shippingDetails.identityCode parameter is invalid
INT_878 The commission parameter is invalid
INT_880 initialAmount and initialAmountNumber must be defined
INT_883 The description parameter is invalid
INT_885 The formToken parameter is invalid
INT_886 The debitCreditSelector parameter is invalid
INT_887 The brand parameter is invalid
INT_892 The paymentMethodType parameter is invalid
INT_893 The firstInstallmentDelay parameter is invalid
INT_895 The installmentNumber parameter is invalid
INT_896 Parameter not supported for recurring payments
INT_897 The subscriptionId parameter is invalid
INT_898 The comment parameter is invalid
INT_899 The retry parameter is invalid
INT_900 The parameter does not exist
INT_901 Web Service not found
INT_902 One of the parameters sent to the Web Service is invalid
INT_903 formToken not found
INT_904 Public key
INT_905 Invalid username or password
INT_906 The formToken parameter is invalid
INT_910 Token creation is not enabled for this payment method
INT_911 The public key does not correspond to the formToken
INT_912 The password does not correspond to the transaction
INT_913 Authorized only for PCI-DSS merchants
INT_999 Technical error

PSP errors

PSP errors (Payment Service Provider) occur when the PSP cannot process the request.

Code Message
PSP_501 Transaction not found.
PSP_502 Transaction not found.
PSP_503 This action has not been authorized for a transaction with the {0} status.
PSP_504 This transaction is not authorized in this context.
PSP_505 This transaction already exists.
PSP_506 Invalid transaction amount.
PSP_507 This action is not possible anymore for a transaction created on that day
PSP_508 The card expiration date does not allow this action.
PSP_509 CVV mandatory for this card.
PSP_510 The refund amount is greater than the initial amount.
PSP_511 The refunds total amount is greater than the initial amount.
PSP_512 Credit duplication (refund) is not authorized.
PSP_513 Due to a technical problem, we are unable to process your request.
PSP_514 Due to a technical problem, we are unable to process your request.
PSP_515 Due to a technical problem, we are unable to process your request.
PSP_516 Due to a technical problem, we are unable to process your request.
PSP_517 Aurore MID configuration has failed.
PSP_518 Cetelem response analysis has failed.
PSP_519 Unknown currency.
PSP_520 Invalid type card.
PSP_521 No MID has been found for this payment. Please modify the data or contact your manager in case the error reoccurs.
PSP_522 Shop not found.
PSP_523 Ambiguous MID.
PSP_524 Invalid MID
PSP_525 Due to a technical problem, we are unable to process your request.
PSP_526 Invalid card number.
PSP_527 Invalid card number.
PSP_528 Invalid card number.
PSP_529 Invalid card number.
PSP_530 Invalid card number (Luhn)
PSP_531 Invalid card number (length)
PSP_532 Invalid card number (not found)
PSP_533 Invalid card number (not found)
PSP_534 Failed verification of the card requiring systematic verification.
PSP_535 Failed e-Carte Bleue verification.
PSP_536 The transaction has been refused by risk management.
PSP_537 Interruption not processed during the payment.
PSP_538 Due to a technical problem, we are unable to process your request.
PSP_539 3D Secure refusal for the transaction.
PSP_540 Due to a technical problem, we are unable to process your request.
PSP_541 Due to a technical problem, we are unable to process your request.
PSP_542 An internal error occurred while consulting the card number.
PSP_543 An internal error occurred while consulting the card number.
PSP_545 Invalid currency for the modification.
PSP_546 The amount is greater than the authorized amount.
PSP_547 The desired capture date exceeds the authorization expiration date.
PSP_548 The requested modification is invalid.
PSP_549 Invalid definition of the installment payment.
PSP_550 Unknown shop.
PSP_551 Unknown exchange rate.
PSP_552 The MID has been terminated since {0}.
PSP_553 The shop {0} has been closed since {1}.
PSP_554 Rejected parameter that may contain sensitive data {0}.
PSP_555 Due to a technical problem, we are unable to process your request.
PSP_557 An error occurred while retrieving the token.
PSP_558 The token status is not compatible with this operation.
PSP_559 An error occurred while retrieving the token.
PSP_560 This token already exists.
PSP_561 Invalid token
PSP_562 Token creation failed.
PSP_563 This recurring payment already exists.
PSP_564 This recurring payment is already terminated.
PSP_565 Invalid recurring payment.
PSP_566 Invalid recurrence rule.
PSP_567 Recurring payment creation failed.
PSP_569 Due to a technical problem, we are unable to process your request.
PSP_570 Invalid country code.
PSP_571 Invalid web service parameter.
PSP_572 The authorization has been declined by Cofinoga.
PSP_573 Refusal of authorization for 1 euro (or request for information from the CB network if supported by the acquirer).
PSP_574 Invalid payment configuration.
PSP_575 The operation has been rejected by PayPal.
PSP_577 Due to a technical problem, we are unable to process your request.
PSP_578 Transaction ID missing
PSP_579 This transaction ID is already used.
PSP_580 Transaction ID expired.
PSP_581 Invalid contents of the config theme.
PSP_582 The refund is not authorized.
PSP_583 The transaction amount does not respect the allowed values.
PSP_585 Due to a technical problem, we are unable to process your request.
PSP_587 Due to a technical problem, we are unable to process your request.
PSP_597 No payment options have been enabled for this MID
PSP_592 An error occurred while calculating the payment channel.
PSP_593 An error occurred during buyer redirection to the page of payment finalization.
PSP_594 A technical error has occurred.
PSP_596 An error occurred while capturing this transaction.
PSP_597 The capture date is too far.
PSP_598 Invalid transaction date.
PSP_599 An error occurred while calculating the payment source.
PSP_600 Failed commercial card verification.
PSP_601 Declined due the refusal of the first installment.
PSP_603 The transaction status could not be synchronized with the external system.
PSP_604 An error occurred while capturing this transaction.
PSP_605 A security error occurred while processing 3DS authorization for this transaction.
PSP_606 Unsupported currency on this Merchant ID (MID) and/or shop.
PSP_607 The card associated with the token is no longer valid.
PSP_608 Due to a technical problem, we are unable to process your request.
PSP_609 The timeout has been exceeded during buyer redirection.
PSP_610 Payment card not supported by the MID.
PSP_611 Refus des transactions sans transfert de responsabilité.
PSP_612 Cancellation is not authorized.
PSP_613 Duplication is not authorized.
PSP_615 The refund is not authorized.
PSP_616 Manual payment not authorized for this card.
PSP_618 Manual installment payment not authorized for this card.
PSP_619 The submitted date is invalid.
PSP_620 The initial transaction option is not applicable.
PSP_624 Inactive card.
PSP_625 Payment refused by the acquirer.
PSP_626 This action is impossible as the payment sequence has not been completed.
PSP_636 Refus des transactions dérivées, sans transfert de responsabilité sur la transaction primaire.
PSP_637 Duplicate transaction.
PSP_638 Partial refund is impossible for this transaction.
PSP_639 Refund refused.
PSP_641 The transaction has been declined by the risk analyzer.
PSP_642 The card type used is not valid for the requested payment mode.
PSP_643 Due to a technical problem, we are unable to process your request.
PSP_644 A transaction in production mode has been marked as in test mode by the acquirer.
PSP_645 A transaction in test mode has been marked as in production mode by the acquirer.
PSP_646 Invalid SMS code.
PSP_647 The risk management module has requested for this transaction to be declined.
PSP_648 Due to a technical problem, we are unable to process your request. Transaction has not been created.
PSP_649 The payment session has expired (the buyer has been redirected to the ACS and has not finalized the 3D Secure authentication).
PSP_650 Due to a technical problem, we are unable to process your request. Transaction has not been created.
PSP_651 A FacilyPay transaction cannot be canceled/edited/refunded between 11.30pm and 5.30am.
PSP_652 Due to a technical problem, we are unable to process your request.
PSP_653 A technical error occurred during the call to the Banque Accord service.
PSP_655 The FacilyPay transaction could not be canceled/edited/refunded: the transaction status does not allow to perform the requested action. Reminder regarding a FacilyPay transaction: a refund must be made within two days after the capture, the delay between two refunds is one day, a partial refund is limited to 20 days, a full refund is limited to 6 months.
PSP_658 Due to a technical problem, we are unable to process your request.
PSP_659 The amount is less than the minimum authorized amount (minimum={0} {1}).
PSP_660 It is impossible to refund an unpaid transaction.
PSP_665 The ID type is specified, but its number is missing.
PSP_666 The ID number is specified, but its type is missing.
PSP_667 The ID type is unknown.
PSP_668 The ID number is invalid.
PSP_669 The specific data that must be transmitted to the acquirer is invalid.
PSP_670 The deferred payment is not allowed.
PSP_671 The deferred payment is not allowed.
PSP_672 The selected payment process is invalid.
PSP_673 Error of the Express Checkout service at PayPal.
PSP_675 Cancellation impossible, please try a refund.
PSP_676 Refund impossible, please try a cancellation.
PSP_677 No response to the authorization request has been received within the required deadline.
PSP_678 Cancellation impossible, the transaction has already been canceled.
PSP_679 The transaction status is unknown.
PSP_682 The national client identifier is missing.
PSP_683 The format of the national client identifier is incorrect.
PSP_998 HTTP error
PSP_999 Technical error