---
title: "Initiate an onramp transaction"
method: POST
path: "/v1/users/{user_id}/fiat/onramp"
tags: ["Fiat"]
---

# Initiate an onramp transaction

`POST /v1/users/{user_id}/fiat/onramp`

Triggers an onramp to the specified recipient blockchain address, returns the bank deposit instructions

## Path parameters

- `user_id` string, required — The ID of the user initiating the onramp

## Headers

- `privy-app-id` string, required — ID of your Privy app.

## Request body

- object
  - `amount` string, required
  - `destination` object, required
    - `chain` 'ethereum' | 'base' | 'arbitrum' | 'polygon' | 'optimism', required — Supported blockchain chains for onramp and offramp.
    - `currency` 'usdc', required — Supported crypto assets for onramp and offramp.
    - `to_address` string, required
  - `provider` 'bridge' | 'bridge-sandbox', required — Valid set of onramp providers
  - `source` object, required
    - `currency` 'usd' | 'eur', required — Supported fiat currencies.
    - `payment_rail` 'sepa' | 'ach_push' | 'wire', required — Supported fiat payment rails.

## Response `200`

Bank deposit instructions for the onramp

- object — Response for an onramp transfer initiation.
  - `deposit_instructions` OnrampDepositInstructions, required — Bank deposit instructions for an onramp transfer.
    - `account_holder_name` string
    - `amount` string, required
    - `bank_account_number` string
    - `bank_address` string
    - `bank_beneficiary_address` string
    - `bank_beneficiary_name` string
    - `bank_name` string
    - `bank_routing_number` string
    - `bic` string
    - `currency` 'usd' | 'eur', required — Supported fiat currencies.
    - `deposit_message` string
    - `iban` string
    - `payment_rail` 'sepa' | 'ach_push' | 'wire', required — Supported fiat payment rails.
  - `id` string, required
  - `status` 'awaiting_funds' | 'in_review' | 'funds_received' | 'payment_submitted' | 'payment_processed' | 'canceled' | 'error' | 'undeliverable' | 'returned' | 'refunded', required — Status of an onramp or offramp transfer.

---

[API](https://skmtc.net/privy-io/apis/privy-api.md) · [All operations](https://skmtc.net/privy-io/apis/privy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/privy-io/privy-api/revisions/bb2eb34156cc/schema)