How Tos

Create counterparties and accounts

Counterparties and accounts must be pre-registered and linked to send payouts. Registering counterparties and accounts in advance of submitting payouts enables OFAC (sanctions) screening, wallet risk assessment, and helps meet regulatory requirements.

Counterparty creation

To create a counterparty, submit a request to the counterparty creation API and populate the appropriate fields for the individual or business.

*Note: Individuals are natural persons; businesses are registered legal entities.

Select a type of customer you want to create:

Example: Individual counterparty creation request


Code
 
{
  "classification": "individual",
  "individual_first_name": "John",
  "individual_last_name": "Doe",
  "individual_address_country": "US",
  "individual_date_of_birth": "1980-01-01",
  "individual_national_identification_number": "123456789",
  "individual_street_address1": "123 Main St",
  "individual_street_address2": "Apt 4B",
  "individual_city": "New York",
  "individual_state": "NY",
  "individual_postal_code": "10001"
}

In the successful response you receive a unique id for the counterparty.


Code
 
{
  "data": {
    "id": "c7d8e9f0-1a2b-3c4d-5e6f-789012345678",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "classification": "individual",
    "tenant_id": null,
    "individual_first_name": "John",
    "individual_last_name": "Doe",
    "individual_address_country": "US",
    "individual_date_of_birth": "1980-01-01",
    "individual_national_identification_number": "123456789",
    "individual_street_address1": "123 Main St",
    "individual_street_address2": "Apt 4B",
    "individual_city": "New York",
    "individual_state": "NY",
    "individual_postal_code": "10001",
    "business_legal_name": null,
    "business_dba": null,
    "business_address_country": null,
    "business_street_address1": null,
    "business_street_address2": null,
    "business_city": null,
    "business_state": null,
    "business_legal_entity_identifier": null,
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

Account creation

To create an account, submit a request to create a bank, wallet, or ledger account and populate the appropriate fields. Accounts will always belong to the workspace they are created in.

Bank account creation request


Code
 
{
  "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
  "name": "Operating Account - EU",
  "bank_name": "Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "123456789"
}

The response will provide a unique identifier for the account that can be used when requesting payments or transfers:


Code
 
{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "crypto_wallet_address": null,
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z"
  }
}

Associating wallets and ledgers with a tenant or counterparty

A wallet or ledger can optionally belong to either a counterparty or tenant in addition to the workspace.

Do not specify a tenant or counterparty if you want the wallet or ledger to be used in a fully omnibus manner, where funds are commingled across all of your customers. Upon onboarding, your organization will be provisioned with a wallet or ledger that only belongs to your workspace. You may create additional wallets or ledgers that only belong to the workspace as needed.
Create a wallet or ledger that belongs to a tenant to manage proprietary funds belonging to that tenant, or to commingle funds belonging to that tenant's customers (e.g. originators and/or beneficiaries).
Create a wallet or ledger that belongs to a counterparty to fully segregate funds only for that counterparty.

For more information on the relationship between accounts and counterparties, see the Accounts overview.

Last modified on February 24, 2026

Errors Create a Tenant

Code

{
  "classification": "individual",
  "individual_first_name": "John",
  "individual_last_name": "Doe",
  "individual_address_country": "US",
  "individual_date_of_birth": "1980-01-01",
  "individual_national_identification_number": "123456789",
  "individual_street_address1": "123 Main St",
  "individual_street_address2": "Apt 4B",
  "individual_city": "New York",
  "individual_state": "NY",
  "individual_postal_code": "10001"
}

Code

{
  "data": {
    "id": "c7d8e9f0-1a2b-3c4d-5e6f-789012345678",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "classification": "individual",
    "tenant_id": null,
    "individual_first_name": "John",
    "individual_last_name": "Doe",
    "individual_address_country": "US",
    "individual_date_of_birth": "1980-01-01",
    "individual_national_identification_number": "123456789",
    "individual_street_address1": "123 Main St",
    "individual_street_address2": "Apt 4B",
    "individual_city": "New York",
    "individual_state": "NY",
    "individual_postal_code": "10001",
    "business_legal_name": null,
    "business_dba": null,
    "business_address_country": null,
    "business_street_address1": null,
    "business_street_address2": null,
    "business_city": null,
    "business_state": null,
    "business_legal_entity_identifier": null,
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z"
  }
}

Code

{
  "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
  "name": "Operating Account - EU",
  "bank_name": "Chase Bank",
  "bank_code_type": "SWIFT",
  "bank_identifier_code": "CHASUS33",
  "bank_account_number": "123456789"
}

Code

{
  "data": {
    "id": "8f3b1e7c-9a2d-4f58-b6c0-4e7d2a9f1b3c",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "tenant_id": null,
    "counterparty_id": "2a7e1c9f-4b3d-4a82-b6e0-8f5c2d1a9b3e",
    "type": "fiat_bank",
    "name": "Operating Account - EU",
    "bank_name": "Chase Bank",
    "bank_code_type": "SWIFT",
    "bank_identifier_code": "CHASUS33",
    "crypto_wallet_address": null,
    "created_at": "2024-03-02T14:30:00.000Z",
    "updated_at": "2024-03-02T14:30:00.000Z"
  }
}