Skip to main content

Handling Error Codes

Handling Error Codes in Pay by Bank App Integration​

When integrating Pay by Bank App, 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: Failed to Load jQuery

    • Description: The jQuery library required for Pay by Bank App could not be loaded. If this error occurs, you can try to reinitialize the button to attempt loading the library again. If the problem persists, please contact our support team for further assistance.

  • 1002: Failed to Load Zapp

    • Description: The Zapp library required for Pay by Bank App integration could not be loaded. This may occur due to network issues or incorrect configuration. Check your network connectivity.

  • 1003: Failed to Initialize Cookie Management

    • Description: The cookie management required for the Pay by Bank App could not be initialized.

  • 1004: Failed to Initialize PBBA Button

    • Description: The Pay by Bank App button could not be initialized. This error typically occurs if there is a configuration issue or missing parameters. Verify your integration settings and ensure all required fields are provided.

  • 1005: Failed to Render PBBA Button

    • Description: The Pay by Bank App button could not be rendered on the page. This may happen if the container element is missing or incorrectly specified. Check your HTML and JavaScript code to ensure the button is correctly referenced and initialized.

  • 1006: Failed to Create PBBA Order

    • Description: The order for the Pay by Bank App payment could not be created. This could be due to issues with the payment data or server-side processing. Verify the order details and ensure the payment data is correctly formatted and complete.

  • 1007: Failed to Process PBBA Payment

    • Description: The payment could not be processed through the Pay by Bank App. This error may occur due to network issues, incorrect merchant account settings, or problems with the user's bank. Ensure that all payment information is accurate and try again.

  • 1008: Failed to Notify PBBA Payment Status

    • Description: The system failed to notify the status of the Pay by Bank App payment. This could be due to a network issue or incorrect configuration.

  • 1009: No Result Returned from onClick

    • Description: This error occurs when no result is returned from the onClick event handler, typically if the merchant is passing payment data or a token during the onClick event instead of during the button initialization. Ensure that all necessary data is passed during the button initialization to avoid this error.

  • 1010: Payment Data Field Missing in Result from onClick

    • Description: This error occurs when a required field in the payment data is missing in the result from the onClick event, typically if the merchant is passing payment data during the onClick event instead of during the initialization of the button. Ensure that all necessary payment data is correctly included during button initialization to avoid this error.

  • 1011: Token Field Missing in Result from onClick

    • Description: This error occurs when the token field is missing in the result from the onClick event, typically if the merchant is passing the token during the onClick event instead of during the initialization of the button. Ensure that the token is correctly generated and included during button initialization to avoid this error.

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 Pay by Bank App integration and ensure a better user experience.