Skip to content
/Quote

Quote

This resource represents a pricing quote for a payout or payin. A quote locks the FX rate and fee breakdown for a fixed period.

Operations

Create quotes

Request

Create one or more pricing quotes for a payout or payin. Each quote locks an exchange rate and fee breakdown for fixed period. Provide exactly one of source_amount or destination_amount.

On a payin quote, pass split_ids to price the fee from your declared share of a dynamic pricing rule. See Dynamic Fee Split. A payment link or an order created from the quote inherits the quote's splits, so it must not send split_ids of its own. split_ids is rejected on a payout quote.

Security
JWT
Bodyapplication/jsonrequired
resourcestringrequired

The resource to create quote for.

Enum:"payout""payin"
Example:"payout"
source_currencystring, (iso-4217)

The source currency code in ISO 4217 format.

Example:"USD"
destination_currencystring, (iso-4217)required

The destination currency code in ISO 4217 format.

Example:"INR"
source_amountinteger, >= 1

The amount you intend to send, in the smallest unit of the source currency (e.g., cents for USD, paisa for INR). For example, 10000 represents $100.00 in USD.

Provide exactly one of source_amount or destination_amount, not both.

Example:10000
destination_amountinteger, >= 1

The amount to be received, in the smallest unit of the destination currency.

Provide exactly one of source_amount or destination_amount, not both.

Example:882000
payment_methodobjectrequired

The payment method details to price. pay_via_bank only supports the local_transfer subtype.

price_idstring

Payin only. The platform referral price to apply. When set, the quote's fee breakdown includes a referral_fee.

Example:"price_5JU9yv0lGSUP"
split_idsArray of strings(SplitIds)

Payin only. The pricing splits to apply when quoting the fee. Sending split_ids with resource: payout returns a 400 Bad Request. A payment link or an order created from this quote inherits these splits, and must not send split_ids of its own.

Example:
[
  "psplit_7Kq2mXbTdLp9"
]
POST
/quotes
curl -i -X POST \
  https://api.glomopay.com/api/v1/quotes \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "resource": "payout",
    "source_currency": "USD",
    "destination_currency": "INR",
    "source_amount": 10000,
    "payment_method": {
      "type": "bank_transfer",
      "subtype": "swift_transfer"
    }
  }'

Responses

Quotes created successfully

Bodyapplication/json
quotesArray of objects(Quote)
Response
{
  "quotes": [
    { … }
  ]
}