Options for redirecting customers to third-party services

Overview

During payment processing, customer redirection from the payment form pages to the services of third parties, such as banks, payment systems, and providers, can be required. This can be necessary for customer authentication, payment confirmation by customers, and other actions. Customer redirection can look as follows.

Figure 1. Customer redirection to the bank service

In the ecommpay payment platform, various options for such redirections are supported: with the pages of the third-party services opened in an iframe object, in the current or in a new browser tab. Depending on a payment method and considering the special aspects of its use, one of these options is applied in the payment platform by default. At the same time, when setting up a method within a certain project, the merchant can coordinate the application of another option (from the available ones) with the technical support specialists. Finally, for separate payments, it is possible to apply redirection in a separate tab by using the parameters for opening Payment Page.

Request format

If for a separate payment, it is required to specify the option of opening the page of a third-party service in a new browser tab, disregarding the option specified for the method in general, the request should contain the boolean parameter force_acs_new_window with the value 1. (Using this parameter with the value 0 does not affect the redirection options.)

In the following example of a request for purchase processing, the preselected method is Open Banking in Romania and the page of the bank Banca Comerciala Romana, which supports the purchase by using this method, is set to open in a separate tab.

Figure 2. Example of data from the request for opening Payment Page
{
      payment_id: "X03936", 
      payment_amount: 1000, 
      payment_currency: "EUR", 
      project_id: 123,
      customer_id: "customer1",
      force_payment_method: "online-romanian-banks",
      payment_methods_option:
        {
            "online_romanian_banks":
                {
                    "banks_id": [55941]
                }
        },
      force_acs_new_window: 1,    // the option of opening the bank page      
      signature: "kUi2x9dKHAVNU0FYldJrxh4...zUCwX6R\/ekpZhkIQg=="
    }
Figure 3. Example of data from the request for opening Payment Page
{
      payment_id: "X03936", 
      payment_amount: 1000, 
      payment_currency: "EUR", 
      project_id: 123,
      customer_id: "customer1",
      force_payment_method: "online-romanian-banks",
      payment_methods_option:
        {
            "online_romanian_banks":
                {
                    "banks_id": [55941]
                }
        },
      force_acs_new_window: 1,    // the option of opening the bank page      
      signature: "kUi2x9dKHAVNU0FYldJrxh4...zUCwX6R\/ekpZhkIQg=="
    }

Related topics

When working with various customer redirections, the following articles can come in handy: