Bank account

A customer can have multiple bank accounts linked to it, and each bank account can optionally have a bank entity linked to it.

Bank accounts can be used to capture a customer's bank account info, and can be managed in multiple places. Given the right permissions, a user can view, create, update and delete a customer's bank accounts via the portal. Bank accounts can also be managed with our bank account specific APIs, as well as be created, updated and deleted through the customer specific APIs.

A customer's bank accounts can be viewed on a separate tab when viewing that customer in the portal.

Uniqueness

Creating a new bank account for a customer requires a unique bank account number. This means the same bank account cannot be created for another customer. A bank account can be deleted but take note that the action cannot be reversed, but you can create a new bank account with the same account number, provided that it is for the same customer. You are not allowed to create a bank account with the same number for another customer, even if you delete it from the previous customer.

Properties

  • Name: The bank account's name is optional and not validated in any way.
  • Currency: It is required to specify a fiat currency for each bank account from the list of currencies already set up in your environment.
  • IsPrimary: Each customer is allowed to have one primary bank account. The primary bank account of a customer can be changed at any time, but take note that if a bank account is created or updated as the primary bank account, any existing primary bank account of the customer will automatically be unset as the primary.
  • Bank: Optionally link a bank entity to your bank account. Via the portal a list of existing banks (setup by you) can be selected, but through the APIs, if the bank specified does not exist yet, the bank will be created, with the minimum requirement being the bank's bic code property.
NOTE

The functionality of fiat operations like transferring fiat currency to or from a customer's bank account, does not sit within Nexus, and needs to be implemented on the client's side if needed.