Skip to main content
POST
TypeScript

Autorisaties

Authorization
string
header
vereist

An Account 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.

Scopes

payout:create_destination

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Voorbeeld:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

Body

application/json
supported_payout_method_id
string
vereist

The supported payout method to save (a podst_ identifier from a previous listing).

Voorbeeld:

"podst_xxxxxxxxxxxxxx"

account_id
string

The account to add the payout method for, prefixed biz_. Provide this or user_id.

Voorbeeld:

"biz_xxxxxxxxxxxxxx"

destination_currency
string
standaard:usd

Currency the supported payout method delivers payouts in.

Voorbeeld:

"usd"

fields
object

The supported payout method's required field values, keyed by field id — list them with GET /payouts/supported_methods?supported_payout_method_id=.... Field ids are stable fld_ identifiers you may hardcode; they never change for a given field. A Basis Theory token id may be passed in place of a raw value. For a U.S. bank routing-number field, a raw nine-digit value must also pass the ABA checksum. A validation failure returns the method's full required_fields schema alongside the error. Required whenever the account details are supplied directly.

Voorbeeld:
is_default
boolean
standaard:false

Whether to make this the account's default payout method.

Voorbeeld:

false

nickname
string

A label for the payout method, unique per destination.

Voorbeeld:

"Ops checking"

The token your return_url received after a Log in with PayPal session started with POST /payouts/paypal_link_sessions. Use it for a PayPal supported payout method instead of fields. Sending fields or plaid_public_token alongside it is rejected, and nickname is ignored because Whop names the method after the PayPal email. The PayPal holder's name must match the name on the account's payout setup. An account PayPal reports as unverified, or with an unconfirmed email, is saved and flagged on the method's log rather than refused. Single use; expires 15 minutes after the login.

Voorbeeld:

"pplt_mYWzcqskZuBf2-JTpooLjo5hl5HdE2P68o90dgJjWGQ"

recipient
object

Creates a recipient payout account linked to the funding ledger as a non-default account, then saves the bank method on it. No Whop user, Whop account, or recipient ledger is created. A valid recipient email is required. Recipient methods cannot be default or recurring methods and cannot use Plaid.

user_id
string

The user to add the payout method for, prefixed user_. Provide this or account_id.

Voorbeeld:

"user_xxxxxxxxxxxxxx"

Respons

payout method created

account_reference
string | null
vereist

Masked identifier for the destination.

Voorbeeld:

"••••0472"

created_at
string<date-time>
vereist
Voorbeeld:

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

destination_currency
string
vereist
Voorbeeld:

"usd"

estimated_arrival
object | null
vereist

Null on create. List payout methods to retrieve arrival estimates.

Voorbeeld:

null

fee_structure
object | null
vereist

Null on create. List payout methods to retrieve the configured fee terms.

Voorbeeld:

null

id
string
vereist

Payout method ID, usable as payout_method_id on POST /payouts.

Voorbeeld:

"potk_xxxxxxxxxxxxxx"

institution_name
string | null
vereist
Voorbeeld:

"Frost Bank"

is_default
boolean
vereist
Voorbeeld:

false

last_paid_out_at
string<date-time> | null
vereist

When the most recent completed payout was delivered to this method, as an ISO 8601 timestamp. null when nothing has been paid out to it yet.

Voorbeeld:

null

nickname
string | null
vereist

User-defined label for the payout method.

Voorbeeld:

"Ops checking"

object
enum<string>
vereist
Beschikbare opties:
payout_method
Voorbeeld:

"payout_method"

payer_name
string | null
vereist
Voorbeeld:

"ACH Bank Deposit"

quote
object | null
vereist

Always null on create.

Voorbeeld:

null

status
enum<string>
vereist

Always created on create — no payout has used the method yet.

Beschikbare opties:
created,
active,
broken
Voorbeeld:

"created"

status_reason
string | null
vereist

Always null on create.

Voorbeeld:

null

supported_payout_method
object | null
vereist
unavailable_reason
enum<string> | null
vereist

Why this method is unavailable: destination_retired means the payout provider stopped offering the destination. Whop may automatically remap an eligible method that was not linked through Plaid to a compatible replacement; otherwise, the account owner must re-add it. null means no unavailability reason is known.

Beschikbare opties:
destination_retired,
null
Voorbeeld:

"destination_retired"

bank_verification_state
enum<string> | null

Lifecycle trust state: checking (verification still running), verified (bank confirmed ownership or a payout already completed to it), no_data (verification unavailable or bank returned no ownership data), warning (bank could not confirm the destination's owner), broken (payouts failed with a permanent account error), null (never checked).

Beschikbare opties:
checking,
verified,
no_data,
warning,
broken,
null
Voorbeeld:

"checking"

is_clone
boolean

Whether this method is a copy of one saved on another of the payer's accounts.

Voorbeeld:

false

linked_via_plaid
boolean

Whether the payer added this method by signing in to their bank rather than typing account details.

Voorbeeld:

false

needs_plaid_reconnect
boolean

Whether the bank sign-in behind this method has expired and must be redone before it counts as linked.

Voorbeeld:

false

recipient
object

The recipient of a third-party payout method. Present only for recipient payout methods.

type
enum<string>

The kind of payout method. external sends funds out of Whop. whop_card moves funds onto the account's own Whop Card. A whop_card method takes standard-speed payouts only, and cannot be updated, reconnected, or deleted.

Beschikbare opties:
external,
whop_card
Voorbeeld:

"external"