Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Fiat

Initiate an onramp transaction

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

post/v1/users/{user_id}/fiat/onramp

Path parameters

user_idstring required

The ID of the user initiating the onramp

Headers

privy-app-idstring required

ID of your Privy app.

Request body

amountstring required
provider'bridge' | 'bridge-sandbox' required

Valid set of onramp providers

Example request

{
  "amount": "100.00",
  "destination": {
    "chain": "base",
    "currency": "usdc",
    "to_address": "0x38Bc05d7b69F63D05337829fA5Dc4896F179B5fA"
  },
  "provider": "bridge-sandbox",
  "source": {
    "currency": "usd",
    "payment_rail": "ach_push"
  }
}

Response

Bank deposit instructions for the onramp

idstring 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.

Example response

{
  "deposit_instructions": {
    "amount": "100.0",
    "bank_account_number": "11223344556677",
    "bank_address": "1800 North Pole St., Orlando, FL 32801",
    "bank_beneficiary_address": "1234 Elm St, Springfield, IL 12345",
    "bank_beneficiary_name": "Bridge Ventures Inc",
    "bank_name": "Bank of Nowhere",
    "bank_routing_number": "123456789",
    "currency": "usd",
    "deposit_message": "BRGFU2Z9TJPJXCS7ZZK2",
    "payment_rail": "ach_push"
  },
  "id": "3a61a69a-1f20-4113-85f5-997078166729",
  "status": "awaiting_funds"
}