Register a bank account

Register the external bank account a fiat payout settles to

A bank account is registered once against a user or organization, and can then receive payouts from any of that entity’s wallets.

Use the create method from the externalFiatAccounts resource on users(). Organizations have the same methods under organizations().

import {PrivyClient} from '@privy-io/node';

const privy = new PrivyClient({
  appId: process.env.PRIVY_APP_ID!,
  appSecret: process.env.PRIVY_APP_SECRET!
});

const {external_fiat_account: bankAccount} = await privy
  .users()
  .externalFiatAccounts.create('did:privy:xxxxx', {
    provider: 'bridge',
    environment: 'sandbox',
    currency: 'usd',
    account_owner_name: 'John Doe',
    bank_name: 'Chase',
    account: {
      type: 'us',
      account_number: '1234567899',
      routing_number: '121212121',
      checking_or_savings: 'checking'
    },
    address: {
      street_line_1: '123 Washington St',
      city: 'New York',
      state: 'NY',
      postal_code: '10001',
      country: 'USA'
    }
  });

// bankAccount.id is the fiat_account_id to pay out to

A registered account’s bank details cannot be changed. To pay out to different details, delete the account and register a new one. This prevents a payout from being redirected to another bank account without your app’s knowledge.

Next steps

Get bank accounts

List, read, and delete registered bank accounts

Execute a payout

Convert crypto to fiat in a single call