Create a fiat deposit account

To create a fiat deposit account for a wallet, make a POST request to:

https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/fiat

In the body of the request, include the following fields:

'bridge'

required

Provider to orchestrate the deposit account with.

'production' | 'sandbox'

Provider environment to use. Defaults to production.

object

required

The fiat the account receives.

Hide properties

string

required

Fiat currency to receive deposits in, such as usd or eur. Privy returns the payment rails available for that currency in the response.

object

required

The crypto the deposit is converted into and delivered as.

Hide properties

string

required

Asset to deliver to the wallet, such as usdc.

string

required

Chain to deliver the asset on, such as tempo, base, or solana. The chain must match the wallet’s chain_type — an ethereum wallet cannot receive deposits on Solana.

Deposit accounts are persistent, billed resources at the provider. Pass an Idempotency-Key header to guarantee a retried request returns the same account instead of provisioning a second one.

Below is a sample cURL command for this request:

curl --request POST https://api.privy.io/v1/wallets/{wallet_id}/deposit_accounts/fiat \
  -u "<your-privy-app-id>:<your-privy-app-secret>" \
  -H "privy-app-id: <your-privy-app-id>" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: <your-idempotency-key>' \
  -d '{
    "provider": "bridge",
    "environment": "sandbox",
    "source": {
      "currency": "usd"
    },
    "destination": {
      "asset": "usdc",
      "chain": "tempo"
    }
  }'

A successful response includes the following fields:

object

The deposit account.

Hide properties

string

Unique ID of the deposit account. Referenced by deposit webhooks.

string

ID of the wallet deposits are delivered to.

'bridge'

Provider orchestrating the account.

'production' | 'sandbox'

Provider environment the account belongs to.

'activated' | 'deactivated'

Whether the account can currently receive deposits.

object

The fiat currency the account receives, and the payment_rails available to fund it.

object

The asset and chain deposits are delivered as.

object | null

Bank details the user sends funds to. Fields vary by currency and rail: US accounts return bank_routing_number and bank_account_number, SEPA returns iban and bic. null while the account is still being provisioned.

string

When the account was created, as an ISO 8601 timestamp.

{
  "fiat_deposit_account": {
    "id": "da_xxxxx",
    "wallet_id": "dk3kud7kfo2jcnc5anoovdim",
    "provider": "bridge",
    "environment": "sandbox",
    "status": "activated",
    "source": {
      "currency": "usd",
      "payment_rails": ["ach_push", "wire"]
    },
    "destination": {
      "asset": "usdc",
      "chain": "tempo"
    },
    "deposit_instructions": {
      "bank_name": "Lead Bank",
      "bank_address": "1801 Main St., Kansas City, MO 64108",
      "bank_routing_number": "101019644",
      "bank_account_number": "1234567890",
      "bank_beneficiary_name": "Acme, Inc.",
      "payment_rails": ["ach_push", "wire"]
    },
    "created_at": "2026-08-03T12:00:00Z"
  }
}

Get deposit accounts

Read a wallet’s deposit accounts and their bank details

Deposit lifecycle

Follow a deposit from bank transfer to on-chain settlement

Funding

Deposits

Payouts

Create a deposit account

Next steps

Get deposit accounts

Deposit lifecycle

​Next steps

Get deposit accounts

Deposit lifecycle

Next steps