On Ramp Quote

Convert fiat currency to cryptocurrency (e.g., BRL to BRZ via PIX).

Note: we currently only support BRL → BRZ on ramps at the moment.

Request a Quote

You can request a quote using an existing recipient ID or by passing the settlement details directly in the payload.

Using Recipient ID

TypeScript

const quote = await orda.onRamp.requestQuote({
  fromCurrency: 'BRL',
  intent: {
    method: 'fromAmount',
    value: '100.00'
  },
  recipientId: 'recipient-id'
});

console.log('PIX Key:', quote.depositInstructions.pixKey);
console.log('Transaction ID:', quote.transactionId);

Using Inline Settlement

Deposit Instructions

The quote response includes PIX deposit details and a QR code formatted in Base64.

Response (JSON)

{
  "transactionId": "tx-id",
  "depositInstructions": {
    "pixKey": "[email protected]",
    "pixKeyType": "EMAIL",
    "amount": "100.00",
    "currency": "BRL"
  }
}

Get Status

TypeScript

const status = await orda.onRamp.getStatus(quote.transactionId);
console.log(status.status);  // 'AwaitingDeposit', 'Processing', 'Completed', etc.

Wait for Completion

TypeScript

await orda.onRamp.waitForCompletion(quote.transactionId, {
  intervalMs: 15000,
  timeoutMs: 3600000,
  onStatusUpdate: (status) => console.log('Status:', status)
});

Terminal Statuses

Possible terminal statuses

• Completed - Crypto received

• Failed - Transfer failed

• Cancelled - Transfer cancelled

• Refunded - Fiat returned