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

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

Steet_line

String

Street line of the Bank's address. Required if USA

{
  "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"
}

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

{
  "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

Last updated