Execute a payout

Convert crypto from a wallet to fiat and settle it to a bank account

A payout converts crypto from a wallet and settles it to a registered bank account in a single call.

Supported assets and chains

Pass source.asset as one of Privy’s well-known assets. The asset value differs by chain: Tempo uses usdc_e and usdt0, not usdc and usdt.

Chain	source.chain	Supported source.asset
Tempo	tempo	usdc_e, usdt0
Ethereum	ethereum	usdc, usdt, usdb, eurc
Base	base	usdc, usdb, eurc
Arbitrum	arbitrum	usdc
Optimism	optimism	usdc
Polygon	polygon	usdc
Solana	solana	usdc, usdt, usdb, eurc

On Polygon, pay out usdc rather than usdc_e. Privy’s usdc_e on Polygon is PoS-bridged USDC, which the provider does not accept, so a payout naming it is rejected.

Use the create method from the payout.fiat resource on wallets().

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

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

const payout = await privy.wallets().payout.fiat.create('<wallet-id>', {
  source: {
    asset: 'usdc_e',
    chain: 'tempo',
    amount: '100.00'
  },
  destination: {
    fiat_account_id: '<fiat-account-id>'
  }
});

// payout.id is the wallet action ID to track

Next steps

Track a payout

Follow a payout from on-chain transfer to bank settlement

Wallet actions

Learn how wallet actions are authorized and executed