Setup the Payment Hub

Configuration

The Payment Hub is a payment selector interface which appears when your shop or application has several payment methods associated to it. This enables to suggest from a single integration the possibility to provide multiple payment methods to the payer in order to maximize convertion.

To configure multiple payment methods:

  • Login to the console
  • Create a new or select an existing shop or an application
  • In the payments tab, select the payment methods you would like to enable

Attach Payment Methods

Attach Payment Methods to create request to pay /connect/v2 and create connect /pis/v2/connect is now possible. The goal here is that, although you have configured the payments in the console, you can select them granularly in the link obtaining in the response.

🚧 Be aware

Before proceeding, it is important taking into account that payment methods attached into the request need to be activated previously in console side (# Configuration)

Payment method ids allowed are:

  • smart_transfer
  • immediate_transfer
  • bnpl

The payment methods desired will be attached into meta object as this example: "payment_methods": [{ "id": "smart_transfer" }, { "id": "immediate_transfer", order: 1 }], where id is mandatory and order is optional.

The possible scenarios after sending the request are:

  • If a payment method does not exist or is not activated, an error is returned
  • If no payment methods are provided, the default ones are used
  • If payment methods are attached and are activated, the payment methods are accepted

If an error is not received, a connect link will be available to redirect to connect with the payment methods desired.

Some payment methods might not be available in your country or in your contractual relationship. Contact support to discover the different payment methods and ask how to get those activated in your account