Before you start

Before you proceed with getting a list of supported banks, make sure that you have completed the following steps:

• Creating a Service account
• Issuing a JWT token
• Managing JWT tokens
• Processing transactions

How to get a list of supported banks

Retrieve a list of banks that match your search parameters using the Find Banks method. This allows you to display available banks to your users or validate bank details during transactions.

Follow these steps to get the list of supported banks:

1. Set up your Authorization header:
   Include your Bearer token in the Authorization header:\
   

    Authorization: Bearer YOUR_ACCESS_TOKEN

2. Prepare your request:

   • Endpoint:\
     

      GET https://secure.sandbox.paymentsgate.io/banks/find

   • Query Parameters:
     • search (required): Text search by bank name or ID.
     • tag (optional): Filter banks by specific tags (e.g., sepa, upi, etc.).

3. Make the API call:\
   
   Example request:\
   

   curl --request GET \
     --url 'https://secure.sandbox.paymentsgate.io/banks/find?search=Deutsche%20Bank&tag=sepa' \
     --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

   Example response: A successful response will return a JSON object containing an array of bank details.\
   

   bash

   {
     "rows": [
       {
         "name": "Deutsche Bank",
         "title": "DB",
         "title_en": "Deutsche Bank",
         "alias": "DB_ALS",
         "currency": "EUR",
         "country": "DE",
         "enabled": true,
         "supportedPaymentSystems": ["sepa"],
         "automationAvailable": true,
         "isTopBank": true,
         "tagColor": "#000000",
         "textColor": "#FFFFFF",
         "url": "https://www.deutsche-bank.de"
       }
     ]
   }
   

For more detail, please see the Find Banks API method description.