Payouts

Create Payout Quote

Changed on

Creates a short-lived, provider-backed quote of a payout's fee, exchange rate, and destination amount. No funds move until you submit the returned quote_token to POST /payouts.

post/payouts/quotes

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/payouts/quotes
  • Auth: HTTP bearer

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": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "destination_amount": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "exchange_rate": 4.13978443,
  "expires_at": "2026-01-01T12:00:00.000Z",
  "fee": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "id": "pout_aed_quote",
  "net_amount": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "object": "payout_quote",
  "quote_token": "signed-payout-quote",
  "recommended_method": {
    "country": "AE",
    "destination_currency": "eur",
    "estimated_arrival": "2026-01-01T12:00:00.000Z",
    "estimated_fee": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "estimated_savings": {
      "amount": "-1234.56",
      "currency": "usd",
      "decimals": 2,
      "display_decimals": 2
    },
    "name": "Bank Wire",
    "supported_payout_method_id": "podst_xxxxxxxxxxxxxx"
  }
}

Changes

  • de951faea120Revision changes
    • info

      added the required property to the response with the status

  • 697924df40d1Revision changes
    • breaking

      the header request parameter Idempotency-Key became required

    • info

      the request property default value usd was removed