Skip to main content
PATCH
TypeScript

Autorisations

Authorization
string
header
requis

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:update_destination

En-têtes

Api-Version-Date
string

Pins the request to a dated API version.

Exemple:

"2026-11-17"

Paramètres de chemin

id
string
requis

Payout method ID, prefixed potk_.

Corps

application/json
address
object

The payout address to keep on file for this payout method. Only the fields you send are changed; blank fields are ignored.

is_default
enum<boolean>

Set to true to make this the account's default payout method. false is not accepted.

Options disponibles:
true
Exemple:

true

nickname
string

New label for the payout method, with at least one non-whitespace character and a maximum of 100 characters.

Required string length: 1 - 100
Exemple:

"Primary checking"

Réponse

payout method updated

account_reference
string | null
requis

Masked identifier for the destination.

Exemple:

"••••0472"

bank_verification_state
enum<string> | null
requis

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

Options disponibles:
checking,
verified,
no_data,
warning,
broken,
null
Exemple:

"checking"

created_at
string<date-time>
requis
Exemple:

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

destination_currency
string
requis
Exemple:

"usd"

estimated_arrival
object | null
requis

null after an update. List payout methods to retrieve arrival estimates.

Exemple:

null

fee_structure
object | null
requis

null after an update. List payout methods to retrieve the configured fee terms.

Exemple:

null

id
string
requis

Payout method ID, prefixed potk_.

Exemple:

"potk_xxxxxxxxxxxxxx"

institution_name
string | null
requis
Exemple:

"Frost Bank"

is_clone
boolean
requis

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

Exemple:

false

is_default
boolean
requis
Exemple:

true

last_paid_out_at
string<date-time> | null
requis

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.

Exemple:

null

linked_via_plaid
boolean
requis

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

Exemple:

false

needs_plaid_reconnect
boolean
requis

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

Exemple:

false

nickname
string | null
requis

User-defined label for the payout method.

Exemple:

"Primary checking"

object
enum<string>
requis
Options disponibles:
payout_method
Exemple:

"payout_method"

payer_name
string | null
requis
Exemple:

"ACH Bank Deposit"

quote
object | null
requis

Always null after an update.

Exemple:

null

status
enum<string>
requis

created — saved, no payout has completed through it yet. active — a payout through it completed. broken — a payout through it failed with an error attributable to the method, and it no longer accepts payouts; a later successful payout returns it to active.

Options disponibles:
created,
active,
broken
Exemple:

"created"

status_reason
string | null
requis

Machine-readable code for why the method is broken — the newest failure recorded through it, whether a payout error or a pre-payout rejection. null unless the method is broken, or when it was disabled without a recorded failure.

Exemple:

null

supported_payout_method
object | null
requis
type
enum<string>
requis

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.

Options disponibles:
external,
whop_card
Exemple:

"external"

unavailable_reason
enum<string> | null
requis

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.

Options disponibles:
destination_retired,
null
Exemple:

"destination_retired"

recipient
object

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