Skip to main content

Bank accounts API

Introduction​

Using this section you can easily manage your bank accounts within the toolkit, which can be used to make payments.

Bank account connection​

There are 2 possible types of connecting a ban account:

  • Manual - the user provides bank account data through an API request, after which Fena’s team checks this data. Once Fena verifies that the entered data is correct, the bank account can be used to work with Fena payments.
  • Via the application, the user, instead of manually providing data to Fene, receives a link that will redirect him to the provider's application, in which the user will need to authorize. After authorization, Fena will receive the necessary data to connect a bank account and if the data has passed our internal verification, then the bank account can be used to work with Fena payments. Note: Due to FCA guidance update a bank account connsent will expire in 90 days. after connection. When this happens, the API key user will be notified of this event via a webhook from Fena.

List of bank account data that Fena stores to be able to process payments:

  • Name of used provider
  • Sort code
  • Account number
  • Bank statement (for manual connection type)

List of statuses that a bank account can have.Fena notifies the user of the API key about each change in the status of the bank account via webhook.

StatusDescription
VerifiedBank account is verified and it can be used in payments
PendingFena has received your bank account details and our team is checking them
DisabledBank account details were not verified or an error occurred while connecting through the application

Sandbox​

If you want to see for yourself how our payment flow works you can create a sandbox payment with the sandbox bank account which we've created for you automatically during sign up. "Sandbox" bank accounts have the isSandbox flag set to true and "sandbox" payments will be generated when using this kind of accounts.