Retrieve Payment Quote
Retrieves a payment quote. Use it to check which payment holds the quote, through payment_id, and when it expires.
Authorizations
An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.
Headers
Pins the request to a dated API version.
"2026-10-15-1"
Path Parameters
The payment quote ID, prefixed pq_.
Response
payment quote retrieved
The account the purchase is priced for, prefixed biz_.
"biz_xxxxxxxxxxxxxx"
The billing address the purchase was priced with, or null. Where tax was calculated when no shipping address was given, and the address the registration belongs to.
Three-letter ISO 4217 code of the variants' own currency, lowercase. Equal to currency when nothing was converted.
"usd"
total in base_currency at exchange_rate: the variants' own prices after the promo code, plus tax_amount converted at exchange_rate when tax is added on top. Equal to total when nothing was converted. The payment charges total, in currency.
When the quote was priced, as an ISO 8601 timestamp.
"2026-01-01T12:00:00.000Z"
Three-letter ISO 4217 currency code the purchase is priced and charged in, lowercase: the variants' own currency, or the presentment_currency it was converted into.
"usd"
What the promo code takes off. Zero without a code.
How many units of currency one unit of base_currency buys, as a decimal string such as "5.4321": the rate the variants' prices were converted at, fixed until expires_at, and the rate a payment consuming the quote is charged at. A string, like money amounts, so no float rounds it in transit. Null when nothing was converted.
"0.918"
When the quote stops being chargeable, as an ISO 8601 timestamp. Quote again after it.
"2026-01-01T12:00:00.000Z"
Payment quote ID, prefixed pq_.
"pq_xxxxxxxxxxxxxx"
Which location tax was calculated for: shipping_address when it carries a country, else the billing address when it does, else the presentment_country sent, else the buyer's ip_address. A quote located by presentment_country or ip_address is a preview that estimates tax: a payment cannot use it, so quote again with the buyer's address to pay. Null when nothing in the request located the buyer, which only a seller that collects no tax on this purchase is quoted without; tax_status is then not_applicable.
shipping_address, address, presentment_country, ip_address, null "address"
The payment holding this quote, prefixed pay_, or null while it is unspent. A declined payment keeps its quote and can be retried; check that payment's status.
"pay_xxxxxxxxxxxxxx"
The promo code the quote applied, prefixed promo_, or null.
null
Lowercase ISO 4217 codes to offer the buyer in a currency picker, most relevant first: the currency of the presentment_country sent, else of the country the buyer's ip_address is in, when this purchase can be converted into it and a payment method can collect it, then base_currency. Quote again with one as presentment_currency to price in it. Only base_currency when the quote was priced without presentment_currency or presentment_country.
The shipping address the purchase was priced with, or null. When present it is where tax was calculated.
The price of every line before the promo code, tax and fees.
The tax a payment consuming this quote charges. Zero unless tax_status is calculated.
Whether tax is added on top of the price (exclusive) or already inside it (inclusive). Null when no tax was calculated.
inclusive, exclusive, null "exclusive"
calculated: every line was priced and a payment may consume the quote. not_applicable: this seller collects no tax on this purchase, so the quote owes none and may still be consumed. unavailable: tax could not be priced — the provider did not answer, or this seller's tax setup cannot price a purchase here — so a payment refuses the quote; quote again, or charge without quote_id to have tax calculated at charge time.
calculated, not_applicable, unavailable "calculated"
What the buyer pays: the subtotal less the discount, plus tax_amount when tax is added on top.

