{"title":"Pay by Bank (Europe) for API only","category":"default","creationDate":1567783140,"content":"

Accept Pay by Bank (Europe) payments using our APIs, and build your own payment form to have full control over the look and feel of your checkout page.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have built your API-only integration<\/a>.<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nBefore you begin, contact our Support Team<\/a> to add Pay by Bank (Europe) in your Customer Area.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Build your payment form<\/h2>\n

You can optionally configure your payment form to include a list of issuing banks for Pay by Bank (Europe).<\/p>\n

In some regions, like Germany, there are so many banks that you cannot show a list of issuing banks. Shoppers are redirected to our open banking partner Tink to select their bank.<\/p>\n

In other regions, like the United Kingdom, you can let shoppers pre-select their bank before redirecting them to Tink, by showing the list of issuing banks in your payment form. If you do not show the list of issuing banks, shoppers select their bank after being redirected to Tink.<\/p>\n

In markets where issuer selection is supported, the list of issuing banks is included in the \/paymentMethods<\/code> response.<\/p>\n

Show a list of issuer IDs<\/h3>\n

If issuer selection is supported:<\/p>\n

    \n
  1. Make a \/paymentMethods<\/a> request specifying the correct countryCode<\/a> (for example, GB<\/strong><\/span>) and amount.currency<\/a> (for example, GBP<\/strong><\/span>).<\/li>\n
  2. From the paymentMethods<\/code> response, get a list of available issuing banks from the object with type<\/code>: paybybank<\/strong><\/span>.<\/li>\n
  3. Show the list of issuing banks to the shopper.<\/li>\n
  4. After the shopper selects a bank, include the issuer ID<\/a> when you make the payment request<\/a>.<\/li>\n<\/ol>\n

    For more information, refer to the API-only integration guide<\/a>.<\/p>\n

    For the UK, where you can show the issuer list in the payment form, the list may include the following banks:<\/p>\n\n

    \n
    \n \n <\/tabs>\n <\/div>\n<\/div>\n\n
    \n

    We provide logos for and the issuing banks, which you can use on your payment form. For more information, refer to Downloading logos<\/a>.<\/p>\n<\/div><\/div>\n

    Make a payment<\/h2>\n
      \n
    1. \n

      Make a \/payments<\/a> request, specifying:<\/p>\n\n\n\n\n\n\n\n\n\n
      Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
      countryCode<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nThe shopper's country\/region.
      Format: the two-letter ISO-3166-1 alpha-2<\/a> country code. Exception: QZ<\/strong> (Kosovo).<\/td>\n<\/tr>\n
      returnUrl<\/code><\/td>\n\"-white_check_mark-\"<\/td>\nURL to where the shopper should be redirected back to after they complete the payment. This URL can have a maximum of 1024 characters.<\/td>\n<\/tr>\n
      paymentMethod.type<\/code><\/td>\n\"-white_check_mark-\"<\/td>\npaybybank<\/strong><\/span><\/td>\n<\/tr>\n
      paymentMethod.issuer<\/code><\/td>\n<\/td>\nThe issuer ID<\/a> of the shopper's selected bank. This is only supported in regions where you can show the issuer list.<\/td>\n<\/tr>\n
      shopperLocale<\/code><\/td>\n<\/td>\nThe language that the redirection page (hosted by Tink) should be rendered in. The page can be in the local language (for example, de-DE<\/strong><\/span> for Germany) or in en-US<\/strong><\/span>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      \n<\/code-sample>\n<\/div>\n<\/li>\n
    2. \n

      In the \/payments<\/a> response, check the action<\/code> object for the information that you must use to redirect the shopper.<\/p>\n

      \n<\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n

      Handle the redirect<\/h2>\n
        \n
      1. \n

        To complete the payment, redirect the shopper to the action.url<\/code> returned in the \/payments<\/a> response, taking into account the following recommendations:<\/p>\n