Open Bank Account
This endpoint allows you to request opening of a bank account for a user. The account will be opened asynchronously and once completed, you will receive deposit instructions (routing number, account number) that can be used to receive payments.
Prerequisites
- The account must have completed banking KYC verification (status:
approved).
v3's Open a Bank Account opens one in a chosen currency, waits for the bank, and answers its account number in the same response.
Authorization:
Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.
Headers:
Authorization: APIKey {SIGNED_JWT}
How to build and sign the JWT: Authentication.
Endpoint
/api/v2/banking/bank-accounts
Request Body Sample
{
"accountId": "00000000-0000-0000-0000-000000000000",
"accountType": "checking",
"accountName": "John's Checking Account",
"reference": "client-reference-123"
}
Request Body Schema
| Field | Type | Description |
|---|---|---|
accountId | string (uuid) | Required. The account ID to open a bank account for. |
accountType | string | Required. The type of bank account. Values: checking, savings. |
accountName | string | Required. A friendly name for the bank account. Min 3, max 255 characters. |
reference | string | Required. A unique client reference for the account. Min 1, max 255 characters. |
Response Sample
{
"message": "Bank account opening initiated"
}
Response Schema
| Field | Type | Description |
|---|---|---|
message | string | Confirmation message indicating the account opening process has been initiated. |
Notes
- Bank account creation is asynchronous. Once complete, the deposit instructions will be available.
- The deposit instructions include routing number and account number for ACH transfers.
Errors
| Status | Message | Meaning |
|---|---|---|
409 | banking_operation_unsupported | The workspace's bank cannot open bank accounts. |
Support and Resources
If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.
Stay Updated
Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:
- Instagram: BlockWyre Instagram
- Twitter: BlockWyre Twitter
- Facebook: BlockWyre Facebook
- LinkedIn: BlockWyre LinkedIn
We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!