Bank Account Information

These endpoints manage the subaccount's bank account, where the fiat funds will be deposited after selling crypto with Beta.

Merchants that use the Payment Product must register their preferred bank account for settlement in the Dashboard. This section is dedicated to registering bank accounts for users who are transacting with the Exchange or Pay Anything products.

Register Subaccount's Bank Account

POST https://live.betaapp.com/v1/subaccount/bank-account/external

Endpoint to register external bank accounts for subaccounts. This will be used during the Fiat withdrawal process.

Headers

Name	Type	Description
Authorization*	String	Bearer {access_token}
x-sub-account-id*	String	Subaccount ID
accept*	String	application/json

Request Body

Name	Type	Description
asset*	String	Check coverage page for more details of the supported assets. It must be a Fiat Asset.
name*	String	Nickname for the bank account
bank_name*	String	Bank name
branch*	String	Branch ID if applicable
country*	String	Check coverage page for more details of the supported countries. Follow ISO 3166
instant_payment	String	Instant Payment number
instant_payment_type	String	Check coverage page for more details of the supported instant payment types.
account*	String	Bank Account number
City	String	Bank's city address. Required if USA.
Postal Code	String	Postal code of the Bank's address. Required if USA.
State	String	State of the Bank's address. Required if USA. Follows ISO 3166-2:US if USA.
Steet_line	String	Street line of the Bank's address. Required if USA

200: OK Sucess

{
  "account": "string",
  "asset": "string",
  "bank_name": "string",
  "branch": "string",
  "bank_account": "string",
  "country": "string",
  "created_at": "string",
  "deleted_at": "string",
  "id": "string",
  "instant_payment": "string",
  "instant_payment_type": "string",
  "message": "string",
  "updated_at": "string"
}

400: Bad Request Error message

{
  "message": "string"
}

Request Example:

curl -X 'POST' \
  'https://live.betaapp.com/v1/subaccount/bank-account/external' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: fe2f30db...5b5e7c' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g' \
  -d '{
  "asset": "MXN",
  "name": "My personal MXN Account",
  "bank_name": "BBVA",
  "branch": "000",
  "account": "000000009",
  "country": "Mexico",
  "instant_payment": "74618537489"
  "instant_payment_type": "SPEI",
  "City": "Mexico city",
  "postal_code": "235892",
  "state": "Ciudad de México",
  "street_line": "Avenida Álvaro Obregón",
}'

Response Example:

{
  "id": "f7856b5e-8d31-4195-99b2-c153bc0b6eaa",
  "bank_name": "BBVA",
  "branch": "000",
  "account": "000000009",
  "bank_type": "external",
  "instant_payment": "74618537489",
  "instant_payment_type": "SPEI",
  "country": "Mexico",
  "asset": "MXN",
  "City": "Mexico city",
  "postal_code": "235892",
  "state": "Ciudad de México",
  "street_line": "Avenida Álvaro Obregón",
  "created_at": "2023-11-22T11:44:28.36033647Z",
  "updated_at": "2023-11-22T11:44:28.36033647Z",
  "deleted_at": null
}

Delete Subaccount's Bank Account Details

DELETE https://live.betaapp.com/v1/subaccount/bank-account/external/id/{id}

Headers

Name	Type	Description
Authorization*	String	JWT Token
x-sub-account-id	String	Subaccount ID
accept	String	application/json

Request Body

Name	Type	Description
id*	String	Bank Account ID

200: OK Sucess

{
  "message": "string"
}

400: Bad Request Error message

{
  "message": "string"
}

Request Example:

curl -X 'DELETE' \
  'https://live.betaapp.com/v1/subaccount/bank-account/id/f7856b5e-8d31-4195-99b2-c153bc0b6eaa' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: fe2f30db...5b5e7c' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g'

Response Example:

null