Create an account | CrissCross

curl -X POST https://api.crisscross.money/v1/toc/accounts \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Acme Corp",
  "currency": "USD",
  "bic": "CHASUS33",
  "address": {
    "line1": "383 Madison Avenue",
    "line2": null,
    "city": "New York",
    "postcode": "10179",
    "country": "US"
  },
  "accountNumber": "123456789",
  "bankName": "JPMorgan Chase Bank",
  "bankCountry": "US"
}'

{
  "accountId": "acc_550e8400-e29b-41d4-a716-446655440000",
  "type": "beneficiary",
  "currency": "USD",
  "accountHolder": "Acme Corp",
  "accountNumber": "123456789",
  "bic": "CHASUS33",
  "bankName": "JPMorgan Chase Bank",
  "country": "US",
  "bankCountry": "US",
  "status": "pending"
}

Creates a new beneficiary account for the authenticated organisation.

Authentication

AuthorizationBearer

Token obtained via the login flow.

Request

This endpoint expects an object.

namestringRequired<=33 characters

Legal name of the beneficiary. Max 33 chars (SWIFT limit).

currencystringRequired

ISO 4217 fiat currency code.

bicstringRequired

SWIFT BIC (8 or 11 characters) of the beneficiary’s bank.

addressobjectRequired

ibanstringOptional

IBAN, if applicable. Either iban or accountNumber must be provided.

accountNumberstringOptional

Account number when no IBAN is available. Either iban or accountNumber must be provided.

bankNamestringOptional

Name of the beneficiary's bank.

bankCountrystringOptional

ISO 3166-1 alpha-2 country code of the beneficiary’s bank.

Response

Account created.

accountIdstring

typeenum

beneficiary — outbound payment destination; deposit — inbound funding account.

currencystring

ISO 4217.

accountHolderstring

accountNumberstring

ibanstring

bicstring

swiftReferencestring

bankNamestring

countrystring

ISO 3166-1 alpha-2.

addressobject

bankCountrystring

ISO 3166-1 alpha-2 country code of the beneficiary’s bank.

statusenum

Errors

400

Bad Request Error

401

Unauthorized Error