GuidesRecipesAPI ReferenceChangelog
Guides

Partner Deposit Bank Account

Set up a bank-level deposit bank account to fund your partner fiat account.

Overview

Partners can create a bank-level deposit bank account to deposit funds into their bank-level fiat account. Follow these steps:

Step 1: Verify your fiat platform account

Ensure your bank has a fiat platform account. List existing accounts with:

GET /api/accounts?owner=bank&type=fiat

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

If no fiat account exists, create one via 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
}

Step 2: Create the deposit bank account

Create a main type deposit bank account linked to the fiat account. Cybrid opens a routable bank account at the partner bank on your behalf, including 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": "PARTNER NAME",
  "counterparty_address": {
    "street": "123 Main St.",
    "street2": null,
    "city": "New York",
    "subdivision": "NY",
    "postal_code": "10001",
    "country_code": "US"
  },
  "account_details": [
    {
      "account_number": "XXXXXXXXX"
    }
  ],
  "routing_details": [
    {
      "routing_number": "XXXXXXXXX",
      "routing_number_type": "ABA"
    }
  ],
  "labels": null
}

Step 3: Provide beneficiary details

The counterparty details are not automatically populated for bank-level deposit bank accounts. Contact Cybrid support via your Slack channel and provide:

  • Legal Business Name
  • Registered Business Address
  • Contact Email Address
  • Contact Phone Number

After Cybrid updates the information, the account is ready for use. You can fund your reserve platform account by transferring funds to this deposit bank account, then book-transferring to the reserve account.

ℹ️

Manual PII setup

PII must be manually provided and set for bank-level deposit bank accounts.