Accounts

An account is the main container for identity, permissions, balances, beneficiaries, payments, statements, and compliance status.

Account types

CashXChain can support several account patterns:

• Business account: a company using CashXChain directly.
• Platform account: a platform embedding CashXChain workflows.
• Connected account: a seller, supplier, contractor, merchant, or sub-customer under a platform.
• Treasury entity: an internal entity or subsidiary used for treasury operations.

Account status

Status	Meaning
draft	Account data has been created but onboarding is incomplete.
pending_verification	KYB or review is in progress.
active	The account can use enabled products and corridors.
restricted	Some functionality is limited.
rejected	The account is not approved.
closed	The account is no longer active.

Required information

Required account information depends on customer type, jurisdiction, corridor, product, and partner. Typical fields include:

• Legal business name.
• Registration number.
• Registered address.
• Operating address.
• Industry and business activity.
• Website.
• Expected monthly volume.
• Source of funds.
• Directors and authorized representatives.
• Beneficial owners.
• Supporting documents.

Account creation example

{
  "type": "business",
  "legal_name": "Example Trading GmbH",
  "country": "DE",
  "registration_number": "HRB 123456",
  "industry": "import_export",
  "expected_monthly_volume": "250000.00",
  "expected_currencies": ["EUR", "USD"]
}

Connected accounts

Platforms can create connected accounts for their customers. Connected accounts may have their own verification status, beneficiaries, limits, and balances.

Account limits

Limits can apply by amount, currency, day, month, corridor, payment method, risk tier, or approval policy. Limits may change after additional review.

Best practices

• Collect complete KYB data early.
• Keep business activity descriptions specific.
• Store account IDs in your system.
• Listen for account status webhooks.
• Do not enable payments until account status and product permissions are confirmed.