Payment error handling

This section outlines some of the most common errors encountered when making payments, using different methods and timings.

Overview

When integrating with the Demand API, it's essential to implement error handling in your application to manage any issues that may arise during requests to the API endpoints. This guide details specific errors related to payment failures.

Payment refused errors

This section outlines various error responses related to payment failures, which are returned with the corresponding HTTP status code.

10203 - payment_refused

Name: Payment refused

Description:

• This error occurs when the Payment Service Provider (PSP) cannot provide further details about why the payment was refused.

Solution: In such cases, it is recommended to check with the bank that issued the credit card.

10204 - book_process_failed

Name: Payment refused - fraud

Description:

• This error is equivalent to payment-related fraud in V2. In earlier versions of the API, the vague message "Book process failed" was used in such cases, which may still be returned for some transactions.

• The primary causes of this error could be:

  • Fraud rejection by an external Payment Service Provider (PSP) (The vast majority of cases are triggered by external PSP rejections.)
  • Rejection due to the CC_NO SCA payment method, which is applicable only to a small group of partners.

Solution: Reach out to the payment provider to investigate further and obtain more details regarding the fraud suspicion or rejection.

10205 - insufficient_funds

Name: Payment refused - Insufficient funds

Description:

• The payment has been refused because there are insufficient funds on the credit card used for the transaction.

Solution: Ensure that there are sufficient funds on the card or try a different payment method.

10206 - budget_overflow

Name: Payment refused - Budget overflow

Description:

• The payment was rejected because there are not enough funds available to complete the reservation.

Solution: Check the credit card limit and try again with a valid payment method.

10207 - card_is_expired

Name: Payment refused - Card is expired

Description:

• The credit card used for the transaction has expired.

Solution: Use a valid credit card with an active expiry date.

10208 - invalid_card_number

Name: Payment refused - Invalid card number

Description:

• The provided credit card number is invalid.

Solution: Double-check the card number for accuracy, ensuring it matches the correct format.

10209 - invalid_amount

Name: Payment refused - Invalid amount

Description:

• The payment amount provided is invalid.
• This could be due to incorrect or unsupported values.

Solution: Verify that the amount being charged matches the expected value and format.

10210 - invalid_payment_method

Name: Payment refused - Invalid payment method

Description:

• The provided payment method is invalid or unsupported.
• Example of error response:

{
  "request_id": "01jee7b4h9pqt0j209q38xqzze",
  "errors": [
    {
      "message": "Parameter 'payment.method' is invalid.",
      "id": "invalid_parameter"
    }
  ]
}

Solution: Check the payment method for validity, ensuring it is supported by the system.

10211 - issuer_cvc_check_failed

Name: Payment refused - Issuer CVC check failed

Description:

• The Card Verification Code (CVC) provided with the payment is invalid, and the issuer rejected it.

Solution: Verify that the correct CVC is entered and that it matches the one on the credit card.

10212 - withdrawal_amount_exceeded

Name: Payment refused - Withdrawal amount exceeded

Description:

• The requested payment amount exceeds the limit allowed by the credit card.

Solution: Check the withdrawal limit for the card and adjust the payment amount accordingly.

10213 - withdrawal_count_exceeded

Name: Payment refused - Withdrawal count exceeded

Description:

• The credit card used for booking has already been charged too many times, exceeding the allowable number of withdrawals.

Solution: Use a different card or contact the bank to discuss increasing the withdrawal limit.

10214 - psp_card_is_blocked

Name: Payment refused - PSP card is blocked

Description:

• The Payment Service Provider (PSP) has blocked the credit card used for the transaction.

Solution: Contact the PSP or bank to resolve the card blockage issue.

10215 - sca_required

Name: Payment refused - SCA Required

Description:

• Strong Customer Authentication (SCA) is required for the payment, but the provided authentication is either invalid or incomplete.

Solution: Ensure that SCA data is provided correctly during the transaction process. If the issue persists, contact the PSP or payment provider.