Sign in
Payouts

Create Payout Quote

Creates a short-lived, provider-backed quote for a payout. No funds move until the returned quote_token is submitted to POST /payouts. An Idempotency-Key header is required.

post/payouts/quotes

Headers

Idempotency-Keystring required
Example:payout-quote-aed-20260824

A unique key that makes this quote request safe to retry.

Request body

account_idstring

Account to pay out from, prefixed biz_. Provide exactly one of account_id or user_id.

amountnumber float required

The amount to pay out in the specified currency.

currencystring

The currency to pay out. When omitted, uses usd if that balance can cover a withdrawal, otherwise the account's only other funded currency.

payout_method_idstring required

The saved payout method to quote (a potk_ identifier).

platform_covers_feesboolean

Whether the parent platform covers the payout fee instead of the account being paid out.

speed'standard' | 'instant'

How fast the funds should arrive.

statement_descriptorstring nullable

Text that appears on the recipient's bank statement. Must be 5-22 alphanumeric characters (A-Z, a-z, 0-9). Omit or pass null to use the default descriptor.

user_idstring

User to pay out from, prefixed user_. Provide exactly one of account_id or user_id.

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "amount": 6762.41,
  "currency": "eur",
  "payout_method_id": "potk_xxxxxxxxxxxxxx",
  "speed": "standard",
  "statement_descriptor": "MYCOMPANY"
}

Response

payout quote created

exchange_ratenumber float required

Quoted exchange rate from the source currency to the destination currency.

expires_atstring date-time required

When the quote expires.

idstring required

Provider-backed payout quote ID, prefixed pout_.

object'payout_quote' required
quote_tokenstring required

Server-signed quote token to submit to POST /payouts.

Example response

{
  "amount": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "destination_amount": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "exchange_rate": 4.13978443,
  "expires_at": "2026-01-01T12:00:00.000Z",
  "fee": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "id": "pout_aed_quote",
  "net_amount": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "object": "payout_quote",
  "quote_token": "signed-payout-quote"
}

Changes

Changed in 3 of the 74 revisions of this API.13

Of the 74 revisions, 1 has no diff computed.