Creating accounts

Once a business passes KYB, give it somewhere to hold and move money. Fuze offers three account primitives, all issued to businesses only.

Named IBANs

An internal fiat account with a dedicated IBAN, issued to a business. Incoming transfers are matched to that business automatically, so there is no memo to parse. Check List account currencies, then create one with Create internal account.

{
  "code": 200,
  "error": null,
  "data": {
    "orgUserId": "sherlock_holmes",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "APPROVED",  //make sure this is APPROVED before
    "owner": "FIRST_PARTY",
    "accountType": "INTERNAL",
    "createdAt": "2023-10-01T00:00:00Z",
    "updatedAt": "2023-10-01T00:00:00Z",
    "accountDetails": {
      "accountNumber": "1234567890",
      "beneficiaryName": "Sherlock Holmes",
      "bankName": "Bank of Baker Street",
      "bankCountry": "GB",
      "bankCity": "London",
      "currency": "AED",
      "type": "iban",
      "iban": "AE210860000006320984516"
    }
  }
}

Wallets

An internal or external crypto address for holding balances or routing deposits and withdrawals on behalf of a business. Create an internal wallet with Create internal wallet; before sending to or accepting from an external wallet, run it through Screen external wallet.

Internal Wallets: Create an internal wallet for a user or a user's counter-party. The wallet will be used to deposit crypto funds for the user.

{
  "code": 200,
  "error": null,
  "data": {
    "orgUserId": "sherlock_holmes",
    "counterPartyId": "john_watson",
    "walletId": "123e4567-e89b-12d3-a456-426614174000",
    "walletType": "INTERNAL",
    "owner": "FIRST_PARTY",
    "purpose": "DEPOSIT_SOURCE",
    "status": "APPROVED",
    "createdAt": "2023-10-01T00:00:00Z",
    "updatedAt": "2023-10-01T00:00:00Z",
    "walletDetails": {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "currency": "USDC",
      "chain": "ETHEREUM",
      "network": "MAINNET",
      "memo": "Wallet for Sherlock Holmes",
      "nickname": "wallet001"
    }
  }
}

External Wallets: Create an external wallet for a user's counter-party. The wallet will be used to deposit or withdraw crypto funds for the user.

{
  "code": 200,
  "error": null,
  "data": {
    "orgUserId": "sherlock_holmes",
    "counterPartyId": "john_watson",
    "walletId": "123e4567-e89b-12d3-a456-426614174000",
    "walletType": "EXTERNAL",
    "owner": "THIRD_PARTY",
    "purpose": "WITHDRAWAL",
    "status": "APPROVED",
    "createdAt": "2023-10-01T00:00:00Z",
    "updatedAt": "2023-10-01T00:00:00Z",
    "walletDetails": {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "currency": "USDC",
      "chain": "ETHEREUM",
      "network": "MAINNET",
      "memo": "Wallet for John Watson",
      "nickname": "wallet001"
    }
  }
}

External Bank A/C

A saved external bank account, owned by your business or a business customer, that you can pay out to. Register a counterparty first with Create counter-party, then call Create external account. Double-check the beneficiary name and routing details, since mismatches are a common cause of returned payouts.

{
  "code": 200,
  "error": null,
  "data": {
    "orgUserId": "sherlock_holmes",
    "counterPartyId": "john_watson",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "APPROVED",
    "owner": "THIRD_PARTY",
    "accountType": "EXTERNAL",
    "createdAt": "2023-10-01T00:00:00Z",
    "updatedAt": "2023-10-01T00:00:00Z",
    "accountDetails": {
      "accountNumber": "1234567890",
      "beneficiaryName": "John Watson",
      "bankName": "Bank of Baker Street",
      "bankCountry": "GB",
      "bankCity": "London",
      "bankAddressLine1": "221B Baker Street",
      "bankAddressLine2": "Marylebone",
      "bankState": "Greater London",
      "bankPostalCode": "NW1 6XE",
      "currency": "AED",
      "type": "iban",
      "iban": "AE210860000006320984516",
      "nickname": "John"
    }
  }
}

Managing accounts

Confirm any account or wallet any time with Get account, Get wallet, List accounts, or List wallets. See Fiat Accounts for the full reference.


{
"accountId": "acc_7c1e4b2a9f3d","owner": "FIRST_PARTY",
"accountType": "INTERNAL","status": "APPROVED",
"accountDetails": { "iban": "GB29NWBK60161331926819", "currency": "USD" }}