Create Payout Quote

curl --request POST \
  --url https://api.whop.com/api/v1/payouts/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "payout_method_id": "potk_xxxxxxxxxxxxxx",
  "account_id": "biz_xxxxxxxxxxxxxx",
  "amount": 6762.41,
  "currency": "eur",
  "payment_method_id": "<string>",
  "platform_covers_fees": true,
  "recipient_amount": 123,
  "speed": "standard",
  "statement_descriptor": "ACME INV-10432",
  "user_id": "<string>"
}
'

import requests

url = "https://api.whop.com/api/v1/payouts/quotes"

payload = {
    "payout_method_id": "potk_xxxxxxxxxxxxxx",
    "account_id": "biz_xxxxxxxxxxxxxx",
    "amount": 6762.41,
    "currency": "eur",
    "payment_method_id": "<string>",
    "platform_covers_fees": True,
    "recipient_amount": 123,
    "speed": "standard",
    "statement_descriptor": "ACME INV-10432",
    "user_id": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    payout_method_id: 'potk_xxxxxxxxxxxxxx',
    account_id: 'biz_xxxxxxxxxxxxxx',
    amount: 6762.41,
    currency: 'eur',
    payment_method_id: '<string>',
    platform_covers_fees: true,
    recipient_amount: 123,
    speed: 'standard',
    statement_descriptor: 'ACME INV-10432',
    user_id: '<string>'
  })
};

fetch('https://api.whop.com/api/v1/payouts/quotes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/payouts/quotes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'payout_method_id' => 'potk_xxxxxxxxxxxxxx',
    'account_id' => 'biz_xxxxxxxxxxxxxx',
    'amount' => 6762.41,
    'currency' => 'eur',
    'payment_method_id' => '<string>',
    'platform_covers_fees' => true,
    'recipient_amount' => 123,
    'speed' => 'standard',
    'statement_descriptor' => 'ACME INV-10432',
    'user_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/payouts/quotes"

	payload := strings.NewReader("{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/payouts/quotes")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/payouts/quotes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

POST

payouts

quotes

Create Payout Quote

curl --request POST \
  --url https://api.whop.com/api/v1/payouts/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "payout_method_id": "potk_xxxxxxxxxxxxxx",
  "account_id": "biz_xxxxxxxxxxxxxx",
  "amount": 6762.41,
  "currency": "eur",
  "payment_method_id": "<string>",
  "platform_covers_fees": true,
  "recipient_amount": 123,
  "speed": "standard",
  "statement_descriptor": "ACME INV-10432",
  "user_id": "<string>"
}
'

import requests

url = "https://api.whop.com/api/v1/payouts/quotes"

payload = {
    "payout_method_id": "potk_xxxxxxxxxxxxxx",
    "account_id": "biz_xxxxxxxxxxxxxx",
    "amount": 6762.41,
    "currency": "eur",
    "payment_method_id": "<string>",
    "platform_covers_fees": True,
    "recipient_amount": 123,
    "speed": "standard",
    "statement_descriptor": "ACME INV-10432",
    "user_id": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    payout_method_id: 'potk_xxxxxxxxxxxxxx',
    account_id: 'biz_xxxxxxxxxxxxxx',
    amount: 6762.41,
    currency: 'eur',
    payment_method_id: '<string>',
    platform_covers_fees: true,
    recipient_amount: 123,
    speed: 'standard',
    statement_descriptor: 'ACME INV-10432',
    user_id: '<string>'
  })
};

fetch('https://api.whop.com/api/v1/payouts/quotes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.whop.com/api/v1/payouts/quotes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'payout_method_id' => 'potk_xxxxxxxxxxxxxx',
    'account_id' => 'biz_xxxxxxxxxxxxxx',
    'amount' => 6762.41,
    'currency' => 'eur',
    'payment_method_id' => '<string>',
    'platform_covers_fees' => true,
    'recipient_amount' => 123,
    'speed' => 'standard',
    'statement_descriptor' => 'ACME INV-10432',
    'user_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.whop.com/api/v1/payouts/quotes"

	payload := strings.NewReader("{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.whop.com/api/v1/payouts/quotes")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.whop.com/api/v1/payouts/quotes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"payout_method_id\": \"potk_xxxxxxxxxxxxxx\",\n  \"account_id\": \"biz_xxxxxxxxxxxxxx\",\n  \"amount\": 6762.41,\n  \"currency\": \"eur\",\n  \"payment_method_id\": \"<string>\",\n  \"platform_covers_fees\": true,\n  \"recipient_amount\": 123,\n  \"speed\": \"standard\",\n  \"statement_descriptor\": \"ACME INV-10432\",\n  \"user_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "account_id is required",
    "type": "bad_request",
    "code": "<string>"
  }
}

Authorizations

Authorization

string

header

required

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

Idempotency-Key

string

required

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

Maximum string length: 255

Example:

"payout-quote-aed-20260824"

Api-Version-Date

string

Pins the request to a dated API version.

Example:

"2026-10-24"

Body

application/json

payout_method_id

string

required

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

Example:

"potk_xxxxxxxxxxxxxx"

account_id

string

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

Example:

"biz_xxxxxxxxxxxxxx"

amount

number<float>

The amount to pay out in the specified currency, fees included. Provide exactly one of amount or recipient_amount.

Example:

6762.41

currency

string

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

Example:

"eur"

payment_method_id

string

A saved card of the account, prefixed payt_, to quote paying this payout from. The quote's amount is the card charge, fee adds the estimated card fees to the payout fee, and net_amount is what the recipient receives.

platform_covers_fees

boolean

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

recipient_amount

number<float>

The amount the recipient should receive, with fees added on top. When the payout method pays out in currency, the quote's destination_amount covers it; otherwise its net_amount does. Provide exactly one of amount or recipient_amount.

speed

enum<string>

default:standard

How fast the funds should arrive.

Available options:

standard,

instant

Example:

"standard"

statement_descriptor

string | null

Payment description sent with the payout, such as an invoice number or what it pays for. Must be 5-80 printable ASCII characters (letters, digits, spaces and punctuation); Whop sends it in upper case. Not all countries and banks show it on the recipient's statement, and it is not the sender name. Omit or pass null to use the default descriptor.

Required string length: 5 - 80

Pattern: ^[ -~]+$

Example:

"ACME INV-10432"

user_id

string

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

Response

payout quote created

amount

object

required

Gross payout amount.

Show child attributes

destination_amount

object

required

Exact amount quoted for delivery.

Show child attributes

exchange_rate

number<float>

required

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

Example:

4.13978443

expires_at

string<date-time>

required

When the quote expires.

Example:

"2026-01-01T12:00:00.000Z"

fee

object

required

Fee charged for the payout.

Show child attributes

string

required

Provider-backed payout quote ID, prefixed pout_.

Example:

"pout_aed_quote"

net_amount

object

required

Amount remaining after fees.

Show child attributes

object

enum<string>

required

Available options:

payout_quote

Example:

"payout_quote"

quote_token

string

required

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

Example:

"signed-payout-quote"

recommended_method

object | null

required

An optional payout method to connect for estimated savings. The quote still uses the requested saved method.

Show child attributes

Introduction

Reference

Core Resources

Payments

Money

Commerce

Websites

Ads

Analytics

Communication

Partners

Workforce

Media

Developer

Create Payout Quote

Authorizations

Headers

Body

Response