🏦Create external wallet / bank accounts

You can plug your wallet(s) and external bank account after the KYB

POST /bank-pro/account/:customerId

Connect an external wallet and an external bank account to receive the funds

Headers

Name	Value
Content-Type	application/json
x-join-key	api_token
join-session-id (optional)	customer_session_id

Params (body)

Body JSON

{
  referenceId: string;
  accountName: string;
  individualBank?: {
    firstName: string;
    lastName: string;
    name: string;
    iban: string;
    bic: string;
    countryCode: string;
  };
  professionalBank?: {
    businessName: string;
    name: string;
    iban: string;
    bic: string;
    countryCode: string;
  };
  wallet?: {
    address: string
    chain: string // ethereum; solana; polygon; base; arbitrum; avalanche
  }
}

Response

200

{
  bank: {
    id: string;
    type: string; // e.g. "EXTERNAL_BANK_ACCOUNT"
    name: string;
    referenceId: string;
    bank: {
      name: string;
      address: string;
      city: string;
      state: string;
      postalCode: string;
      country: string;
      iban: string;
      bic: string;
      owner: {
        name: string | null; // concat of firstName + lastName
        firstName: string | null; // only for individual
        lastName: string | null; // only for individual
        email: string;
        businessName: string | null; // only for business type
      }
    };
    createdAt: string; // ISO datetime
    updatedAt: string; // ISO datetime
    customerId: string;
  },
  wallet: {
    id: string;
    type: string; // e.g. "EXTERNAL_WALLET_ACCOUNT"
    name: string;
    referenceId: string;
    wallet: {
      address: string;
      chain: string; // ethereum; polygon; base; arbitrum; avalanche
      isManaged: boolean;
    };
    createdAt: string; // ISO datetime
    updatedAt: string; // ISO datetime
    customerId: string;
  }
}