# Payout Quotes

A payout quote locks in an exchange rate and fee breakdown for a cross-currency payout. Quotes are valid for **30 minutes** from creation. Use the returned `quote_id` when creating a payout to guarantee the quoted rate and fees.

## How quotes work

1. **Request a quote** — Provide the currency pair, amount, and beneficiary. Specify either the source amount or destination amount (not both).
2. **Review available options** — The response includes quotes for each available payment rail (SWIFT, IMPS, NEFT, RTGS, UPI), or a single rail if you specified one.
3. **Use the quote** — Pass the `quote_id` when creating a payout to lock in the quoted exchange rate and fees.


## Key details

| Detail | Value |
|  --- | --- |
| **Quote validity** | 30 minutes from creation |
| **Amount specification** | Either `source_amount` or `destination_amount`, not both |
| **Amounts format** | Smallest currency unit (e.g., cents for USD, paisa for INR) |
| **Payment rails** | `swift`, `imps`, `neft`, `rtgs`, `upi` |


## Example request


```bash
curl -X POST https://api.glomopay.com/api/v1/payouts/quotes \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "source_amount": 10000,
    "source_currency": "USD",
    "destination_currency": "INR",
    "beneficiary_id": "bene_5JU9yv0lGSUP"
  }'
```

## Example response


```json
{
  "quotes": [
    {
      "quote_id": "quo_abc123",
      "expires_at": "2026-05-11T12:30:00Z",
      "payment_rail": "swift",
      "source_currency": "USD",
      "destination_currency": "INR",
      "mid_market_rate": {
        "currency": "INR",
        "rate": 94.5
      },
      "source_amount": 10000,
      "destination_amount": 807700,
      "fees": {
        "txn_fee": {
          "currency": "USD",
          "amount": 100
        },
        "fx_fee": {
          "currency": "USD",
          "amount": 50
        }
      }
    }
  ]
}
```

## Fees breakdown

Each quote includes a detailed fee breakdown:

- **Transaction fee (`txn_fee`)** — Fixed fee charged per payout transaction.
- **FX fee (`fx_fee`)** — Fee applied on top of the mid-market exchange rate for currency conversion.


Both fees are expressed in the smallest unit of the fee currency.