Integration Details

Institution list

How to retrieve the list of supported financial institutions

After successful onboarding, you can integrate with Volt. The first step in creating the user experience is institution selection. The GET /institutions endpoint returns all the data needed to build an interface where the user selects the bank (institution) from which an account-to-account payment should be made.

Endpoint:

Required query parameters:

  • currency – Payment currency (e.g., GBP, EUR)
  • country – Country of the user initiating the payment (ISO 3166 alpha-2 format, e.g., GB, PL)

Optional parameter:

  • active – Filter institutions by active status (true or false)

Required account identifiers

Many institutions require specific account data to be provided before the payment process can continue.

  1. When calling GET /institutions, each institution has an accountIdentifiersRequired field, which is an array containing the names of account identifiers that must be provided.
  2. Identifiers in the response are used in SNAKE_CASE format. For POST /payments, identifiers must be converted to camelCase.
  3. In the POST /payments request body, required identifiers should be placed in the accountIdentifiers object, within the object corresponding to the given payment institution.

How is this guide?

Last updated on

On this page