# Preview a payout price

Returns the exchange rate, the fees and the amount the beneficiary receives, and saves nothing. A preview
has no `id` and no `expires_at`. Call it each time the customer changes the amount.
A `local_transfer` to INR returns one price for each rail that the amount fits: `upi` up to ₹1 lakh,
`imps` up to ₹5 lakh, and `neft` up to ₹1 crore. A `swift_transfer` returns one `swift` price.
The amounts follow this formula: (`source_amount` - `txn_fee` - `fx_fee`) x `fx_rate` =
`destination_amount`. In the example, (60000 - 500 - 250) x 88.2 = 5225850.

Endpoint: POST /payment-accounts/{payment_account_id}/quotes/preview
Version: 1.0.0
Security: JWT

## Security:

  - `JWT` (unknown)
    http bearer JWT

## Path parameters:

  - `payment_account_id` (string, required)
    The ID of a payment account you own. Starts with `pacct_`.

## Request fields (application/json):

  - `resource` (string, required)
    Must be `payout`. Any other value returns `400`.
    Enum: "payout"

  - `source_currency` (string, required)
    The currency the account pays from.
    Example: USD

  - `destination_currency` (string, required)
    The currency the beneficiary receives.
    Example: INR

  - `source_amount` (integer)
    The amount to send from the account, in minor units. Send `source_amount` or `destination_amount`, not both.
    Example: 60000

  - `destination_amount` (integer)
    The amount the beneficiary receives, in minor units. Send it when the customer types the amount the beneficiary must get.
    Example: 5225850

  - `payment_method` (object, required)

  - `payment_method.type` (string, required)
    Enum: "bank_transfer"

  - `payment_method.subtype` (string, required)
    Enum: "local_transfer", "swift_transfer"

## Response 200:

  - `200` (unknown)
    One price for each rail

## Response 200 fields (application/json):

  - `quotes` (array)

  - `quotes.id` (string)
    The quote ID. Not present on a preview.
    Example: quote_6ab5a2d4Wc7Nh

  - `quotes.resource` (string)
    The resource this quote prices.
    Enum: "payout", "payin"

  - `quotes.resource_type` (null)
    Always `null` on a payment account quote.
    Example: null

  - `quotes.expires_at` (string)
    When the quote expires, 30 minutes after it is locked. Not present on a preview.
    Example: 2026-10-15T11:30:20Z

  - `quotes.payment_method` (object)
    The payment method details for this quote.

  - `quotes.payment_method.type` (string)
    The payment method for this quote.
    Enum: "bank_transfer", "pay_via_bank", "card"

  - `quotes.payment_method.subtype` (string)
    The payment method subtype for this quote. Absent on a `card` quote, which has no subtype.
    Enum: "local_transfer", "swift_transfer"

  - `quotes.payment_method.rail` (string)
    The derived payment rail for this quote. Present only for payout quotes. A SWIFT transfer yields a single `swift` quote. A local transfer yields one quote per local rail for the destination currency whose amount limits admit the payout: `upi`, `imps` or `neft` for INR, `ipp` or `fts` for AED, `sepa` for EUR, `fps` for GBP and `npp` for AUD.
    Example: swift

  - `quotes.source_currency` (string)
    The source currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
    Example: USD

  - `quotes.destination_currency` (string)
    The destination currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format.
    Example: INR

  - `quotes.fx_rate` (number)
    The mid-market exchange rate for this quote, before FX fees, as units of `destination_currency` per one unit of `source_currency`. `90.0` means 1 USD = 90 INR. `1` when the two currencies are the same.
    Example: 90

  - `quotes.effective_fx_rate` (number | null)
    The exchange rate after the FX fee, as units of `destination_currency` per one unit of `source_currency`: `fx_rate x (1 - fx_fee / source_amount)`. The transaction fee is not in it, so it is not the all-in rate. `null` when no exchange rate applies.
    Example: 87.8325

  - `quotes.source_amount` (integer)
    The total source amount, in the smallest unit of `source_currency` (cents for USD). `10000` is $100.00 when `source_currency` is USD.
    Example: 10000

  - `quotes.destination_amount` (integer)
    The destination amount, in the smallest unit of `destination_currency` (paise for INR, cents for USD). `882000` is ₹8,820.00 when `destination_currency` is INR.
    Example: 882000

  - `quotes.fees` (object)
    The fees breakdown for this quote.

  - `quotes.fees.txn_fee` (object)
    The transaction fee applied to this quote

  - `quotes.fees.txn_fee.currency` (string)
    The currency of the transaction fee, as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code.
    Example: USD

  - `quotes.fees.txn_fee.amount` (integer)
    The transaction fee, in the smallest unit of this fee's `currency`. `100` is $1.00 when that currency is USD.
    Example: 100

  - `quotes.fees.fx_fee` (object)
    The foreign exchange fee applied to this quote

  - `quotes.fees.fx_fee.currency` (string)
    The currency of the FX fee, as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code.
    Example: USD

  - `quotes.fees.fx_fee.amount` (integer)
    The FX fee, in the smallest unit of this fee's `currency`. `100` is $1.00 when that currency is USD.
    Example: 100

  - `quotes.fees.referral_fee` (object)
    The platform referral fee. Present only on payin quotes when a referral `price_id` was applied.

  - `quotes.fees.referral_fee.currency` (string)
    The currency of the referral fee, as an [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code.
    Example: USD

  - `quotes.fees.referral_fee.amount` (integer)
    The referral fee, in the smallest unit of this fee's `currency`. `50` is $0.50 when that currency is USD.
    Example: 50

  - `quotes.payment_account_id` (string)
    The payment account the quote is priced for.
    Example: pacct_6ab59a10Hk3Zq

  - `quotes.fee_breakdown` (object)
    The fees in `fees`, split by who bears them. Each fee type holds one entry per bearer, with any tax on the fee in `taxes`. A fee type with no fee is an empty list.

  - `quotes.fee_breakdown.fx_fee` (array)

  - `quotes.fee_breakdown.fx_fee.amount` (number)
    The fee amount in the smallest unit of this entry's `currency` (cents for USD), aggregated across all rules for this fee bearer. `250` is $2.50 when `currency` is USD.
    Example: 250

  - `quotes.fee_breakdown.fx_fee.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `quotes.fee_breakdown.fx_fee.bearer` (string)
    The party bearing this fee.
    Enum: "customer", "merchant"

  - `quotes.fee_breakdown.fx_fee.collection_mode` (string | null)
    When the fee is collected. Customer-borne fees are always collected immediately; merchant-borne fees follow the payment's collection mode.
    Enum: "immediate", "deferred", "null"

  - `quotes.fee_breakdown.fx_fee.taxes` (array)
    Taxes applied on this fee (for example, GST). Empty when no tax applies to the underlying rules.

  - `quotes.fee_breakdown.fx_fee.taxes.amount` (number)
    The tax amount in the smallest unit of this line's `currency` (cents for USD). `1800` is $18.00 when `currency` is USD.
    Example: 1800

  - `quotes.fee_breakdown.fx_fee.taxes.currency` (string)
    The currency code in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, USD.
    Example: USD

  - `quotes.fee_breakdown.fx_fee.taxes.name` (string)
    The name of the tax applied on the fee. For example, GST.
    Example: GST

  - `quotes.fee_breakdown.fx_fee.taxes.bps` (number)
    The tax rate in basis points. For example, 1800 represents 18%.
    Example: 1800

  - `quotes.fee_breakdown.txn_fee` (array)

  - `quotes.fee_breakdown.referral_fee` (array)

## Response 400:

  - `400` (unknown)
    The request is not valid

## Response 400 fields (application/json):

  - `error` (string, required)
    The HTTP reason phrase.
    Example: Bad Request

  - `message` (string, required)
    What went wrong. Show it in logs, not to the customer.
    Example: Payment account cannot send money

  - `code` (string)
    A stable code for the error. Present only on some errors, for example `INSUFFICIENT_BALANCE` on a payout and `order_amount_above_cap` on an order. Branch on `code` when it is present, and on the HTTP status when it is not.
    Example: INSUFFICIENT_BALANCE

## Response 404:

  - `404` (unknown)
    The payment account does not exist or you do not own it

## Response 404 fields (application/json):

  - `error` (string, required)
    The HTTP reason phrase.
    Example: Bad Request

  - `message` (string, required)
    What went wrong. Show it in logs, not to the customer.
    Example: Payment account cannot send money

  - `code` (string)
    A stable code for the error. Present only on some errors, for example `INSUFFICIENT_BALANCE` on a payout and `order_amount_above_cap` on an order. Branch on `code` when it is present, and on the HTTP status when it is not.
    Example: INSUFFICIENT_BALANCE

