Skip to main content
PATCH
TypeScript

Autorisationer

Authorization
string
header
påkrævet

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

Overskrifter

Api-Version-Date
string

Pins the request to a dated API version.

Eksempel:

"2026-11-17"

Sti-parametre

id
string
påkrævet

Payout method ID, prefixed potk_.

Krop

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.

Tilgængelige muligheder:
true
Eksempel:

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

"Primary checking"

Svar

payout method updated

account_reference
string | null
påkrævet

Masked identifier for the destination.

Eksempel:

"••••0472"

bank_verification_state
enum<string> | null
påkrævet

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

Tilgængelige muligheder:
checking,
verified,
no_data,
warning,
broken,
null
Eksempel:

"checking"

created_at
string<date-time>
påkrævet
Eksempel:

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

destination_currency
string
påkrævet
Eksempel:

"usd"

estimated_arrival
object | null
påkrævet

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

Eksempel:

null

fee_structure
object | null
påkrævet

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

Eksempel:

null

id
string
påkrævet

Payout method ID, prefixed potk_.

Eksempel:

"potk_xxxxxxxxxxxxxx"

institution_name
string | null
påkrævet
Eksempel:

"Frost Bank"

is_clone
boolean
påkrævet

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

Eksempel:

false

is_default
boolean
påkrævet
Eksempel:

true

last_paid_out_at
string<date-time> | null
påkrævet

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.

Eksempel:

null

linked_via_plaid
boolean
påkrævet

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

Eksempel:

false

needs_plaid_reconnect
boolean
påkrævet

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

Eksempel:

false

nickname
string | null
påkrævet

User-defined label for the payout method.

Eksempel:

"Primary checking"

object
enum<string>
påkrævet
Tilgængelige muligheder:
payout_method
Eksempel:

"payout_method"

payer_name
string | null
påkrævet
Eksempel:

"ACH Bank Deposit"

quote
object | null
påkrævet

Always null after an update.

Eksempel:

null

status
enum<string>
påkrævet

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.

Tilgængelige muligheder:
created,
active,
broken
Eksempel:

"created"

status_reason
string | null
påkrævet

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.

Eksempel:

null

supported_payout_method
object | null
påkrævet
type
enum<string>
påkrævet

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.

Tilgængelige muligheder:
external,
whop_card
Eksempel:

"external"

unavailable_reason
enum<string> | null
påkrævet

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.

Tilgængelige muligheder:
destination_retired,
null
Eksempel:

"destination_retired"

recipient
object

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