Skip to main content

Handling Error Codes

Handling Error Codes in Apple Pay Express Checkout Integration​

When integrating Apple Pay Express Checkout, the component may return various error codes during different stages of the payment process. It is essential to handle these errors appropriately to ensure a smooth user experience and provide meaningful feedback to your customers.

Common Error Codes​

Here are some common error codes that you may encounter:

  • 1001: No Card Networks Configured

    • Description: There are no card networks configured for this terminal. Ensure that your payment gateway settings include the necessary card networks for processing transactions.

  • 1002: Failed to Initialize the Apple Pay Button

    • Description: The Apple Pay button could not be initialized. This error typically occurs if the browser does not support Apple Pay or if there is a configuration issue. Ensure that the user's device and browser support Apple Pay.

  • 1003: Apple Pay Session Validation Failed

    • Description: The Apple Pay session could not be validated. This may occur if there are issues with the merchant's domain verification or if the session request is malformed.

  • 1004: Failed to Authorize Payment

    • Description: The payment authorization failed. This could be due to incorrect payment details, network issues, or insufficient funds. Prompt the user to check their payment information and try again.

  • 1005: Payment Processing Failed

    • Description: The payment could not be processed. This error may arise from issues with the payment gateway or the merchant's account settings.

  • 1006: Failed to Update Shipping Method

    • Description: The selected shipping method could not be updated. This error might occur if the selected shipping method is invalid or unavailable. Provide alternative shipping options to the user.

Notes​

User Experience: Provide clear instructions or next steps for the user when an error occurs, such as retrying the payment or contacting support.

By properly handling error codes, you can improve the reliability of your Apple Pay Express Checkout integration and ensure a better user experience.