Partner Deposit Bank Account
How do I set up a bank-level deposit bank account?
Partners can set up a bank-level deposit bank account, which they can use to deposit funds into their bank-level fiat account. To create a bank-level deposit bank account, please follow these steps:
- First, ensure your bank has at least one fiat platform account that you want to link to the deposit bank account, by using the following API request and note down the account
guid
in the response:
GET /api/accounts?owner=bank&type=fiat
If your bank doesn't have a fiat platform account, you can set one up using the following API request:{ "total": 1, "page": 0, "per_page": 10, "objects": [ { "created_at": "datetime", "updated_at": "datetime", "type": "fiat", "guid": "bank_fiat_account_guid", "asset": "USD", "name": "string", "bank_guid": "bank_guid", "platform_balance": 0, "platform_available": 0, "state": "created", "labels": null } ] }
POST /api/accounts
{ "type": "fiat", "asset": "USD", "name": "string" }
{ "created_at": "datetime", "updated_at": "datetime", "type": "fiat", "guid": "account_guid", "asset": "USD", "name": "string", "bank_guid": "bank_guid", "platform_balance": 0, "platform_available": 0, "state": "storing", "labels": null }
- Next, use the following API request (similar to creating a deposit bank account for customers, but instead omit the
customer_guid
) to create the deposit bank account (of typemain
) and link it to your bank-level platform fiat account from the previous step. Behind the scenes, we open a routable bank account at our partner bank on your behalf, which includes the routing details.
POST /api/deposit_bank_accounts
{ "type": "main", "account_guid": "bank_fiat_account_guid" }
{ "created_at": "datetime", "updated_at": "datetime", "guid": "deposit_bank_account_guid", "type": "main", "bank_guid": "bank_guid", "customer_guid": null, "account_guid": "bank_fiat_account_guid", "asset": "USD", "state": "created", "unique_memo_id": "unique_memo_id", "counterparty_name": "TEST USER", "counterparty_address": { "street": "1 Main St.", "street2": null, "city": "Ottawa", "subdivision": "ON", "postal_code": "H0H0H0", "country_code": "CA" }, "account_details": [ { "account_number": "111222333" } ], "routing_details": [ { "routing_number": "021000021", "routing_number_type": "ABA" } ], "labels": null }
- Once created, you will notice that the beneficiary information, i.e., the account counterparty details, is not automatically populated with PII, similar to customer deposit bank accounts. Partners need to contact Cybrid support (using your Slack channel) and provide the following beneficiary data so we can update the counterparty account details:
After we update the information, the account is ready for use. Especially if you want to fund or top up your Reserve platform account, you can use this deposit bank account to transfer funds into your platform account and then book transfer to your Reserve account.- Legal Business Name - Registered Business Address - Contact Email Address - Contact Phone Number
PII must be manually provided and set for bank-level deposit bank accounts.
Updated about 1 hour ago