Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

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

헤더

Idempotency-Key
string

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

Maximum string length: 255
예시:

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

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

본문

application/json
supported_payout_method_id
string
필수

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

예시:

"podst_xxxxxxxxxxxxxx"

account_id
string

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

예시:

"biz_xxxxxxxxxxxxxx"

destination_currency
string
기본값:usd

Currency the supported payout method delivers payouts in.

예시:

"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.

예시:
is_default
boolean
기본값:false

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

예시:

false

nickname
string

A label for the payout method, unique per destination.

예시:

"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.

예시:

"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.

예시:

"user_xxxxxxxxxxxxxx"

응답

payout method created

account_reference
string | null
필수

Masked identifier for the destination.

예시:

"••••0472"

created_at
string<date-time>
필수
예시:

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

destination_currency
string
필수
예시:

"usd"

estimated_arrival
object | null
필수

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

예시:

null

fee_structure
object | null
필수

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

예시:

null

id
string
필수

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

예시:

"potk_xxxxxxxxxxxxxx"

institution_name
string | null
필수
예시:

"Frost Bank"

is_default
boolean
필수
예시:

false

last_paid_out_at
string<date-time> | null
필수

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.

예시:

null

nickname
string | null
필수

User-defined label for the payout method.

예시:

"Ops checking"

object
enum<string>
필수
사용 가능한 옵션:
payout_method
예시:

"payout_method"

payer_name
string | null
필수
예시:

"ACH Bank Deposit"

quote
object | null
필수

Always null on create.

예시:

null

status
enum<string>
필수

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

사용 가능한 옵션:
created,
active,
broken
예시:

"created"

status_reason
string | null
필수

Always null on create.

예시:

null

supported_payout_method
object | null
필수
unavailable_reason
enum<string> | null
필수

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.

사용 가능한 옵션:
destination_retired,
null
예시:

"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).

사용 가능한 옵션:
checking,
verified,
no_data,
warning,
broken,
null
예시:

"checking"

is_clone
boolean

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

예시:

false

linked_via_plaid
boolean

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

예시:

false

needs_plaid_reconnect
boolean

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

예시:

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.

사용 가능한 옵션:
external,
whop_card
예시:

"external"