Execute a fiat payout

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`	`ousd`, `usdc_e`, `usdt0`
Ethereum	`ethereum`	`ousd`, `usdc`, `usdt`, `usdb`, `eurc`
Base	`base`	`ousd`, `usdc`, `usdb`, `eurc`
Arbitrum	`arbitrum`	`usdc`
Optimism	`optimism`	`usdc`
Polygon	`polygon`	`usdc`
Solana	`solana`	`ousd`, `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.

Payment rails

By default, a payout settles over the standard rail for the destination account’s type. To settle over a different rail, pass destination.payment_rail. The rail must be one the destination account supports.

Account type	Default rail	Supported `payment_rail`
`us`	`ach`	`ach`, `ach_same_day`, `wire`, `fednow`
`gb`	`faster_payments`	`faster_payments`
`iban`	`sepa`	`sepa`
`pix`	`pix`	`pix`
`swift`	`wire`	`wire`

FedNow payouts are waitlisted. Reach out to [email protected] to request access.

Use the create method from the payout().fiat() service 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>',
      payment_rail: 'ach_same_day' // optional, defaults to the account's standard rail
    }
  });

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

Payouts

Fiat payouts

Crypto payouts

Execute a payout

Supported assets and chains

Payment rails

Next steps

Track a payout

Wallet actions

​Supported assets and chains

​Payment rails

​Next steps

Track a payout

Wallet actions

Supported assets and chains

Payment rails

Next steps