Managing your bank account(s) in your StablR Account is an additional service accessible via the StablR API. On this page we will guide you through the steps how to retrieve an overview of your whitelisted bank account(s) from your StablR Account.

Configure your StablR Account

To programmatically manage wallets you need to make sure you have created an API Key.

Get an API Key

StablR's API uses API Keys and Access Tokens as the mechanism to authenticate customer requests. When have retrieved the Access Token for authentication, this Access Token must be set in the Authorization header of the API request for which the format of the header is Bearer secret-key-value.

How to Create an API Key.

Once you have generated your API key, store it with its respective {CLIENT_SECRET} and the {CLIENT_ID} in a secure place.

To be able to make valid requests from your backend server, you must retrieve an {ACCESS_TOKEN} using the {CLIENT_SECRET} and {CLIENT_ID} as explained in the Authentication section.

📘

API Access Tokens

StablR's Access Tokens for making secure API requests will expire five (5) minutes after creation. This means you have to request a new token after the respective token has expired to keep making valid requests from your backend server.

Retrieve bank account details

When you want to retrieve the bank accounts you have registered for whitelisting in your StablR Account, you can invoke either the List all Bank Accounts or GET a Bank Account requests.

List all Bank Accounts Request

Replace {ACCESS_TOKEN} with the Access Token you retrieved when authenticating your API Key.

curl --request GET \
     --url https://api.stablr.com/v1/customer/bank-accounts \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {ACCESS_TOKEN}'

GET a Bank Account Request

Replace {ACCESS_TOKEN} with the Access Token you retrieved when authenticating your API Key.

Replace bankAccountId with the BankAccountId you retrieve when retrieving the list of all your whitelisted bank accounts.

curl --request GET \
     --url https://api.stablr.com/v1/customer/bank-accounts/{bankAccountId} \
     --header 'accept: application/json' \
     --header 'authorization: Bearer {ACCESS_TOKEN}'

Response

The response for those requests look like this:

{
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Name": "{BANK_ACCOUNT_HOLDER_NAME}",
  "BankAccountNumber": "{BANK_ACCOUNT_NUMBER}",
  "BankAccountIdentifier": "{BIC_SWIFT}",
  "BankName": "{BANK_NAME}",
  "BankAddress": "{BANK_ADDRESS}",
  "BankPostalCode": "{BANK_POSTAL_CODE}",
  "BankCity": "{BANK_CITY}",
  "BankCountry": "{BANK_COUNTRY}",
  "BlincId": "{BLINC_ID}",
  "ExternalAccountId": "{BANK_ACCOUNT_ID}",
  "Types": [
    "{SUPPORTED_PAYMENT_RAILS}"
  ],
  "Currency": "EUR",
  "Status": "Approved",
  "CreatedAt": "2024-05-30T09:16:37.250Z"
}