Skip to main content
POST
Cancel Payout

Autorizaciones

Authorization
string
header
requerido

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.

Scopes

payout:withdraw_funds

Encabezados

Idempotency-Key
string

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

Maximum string length: 255
Ejemplo:

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

Api-Version-Date
string

Pins the request to a dated API version.

Ejemplo:

"2026-11-17"

Parámetros de ruta

id
string
requerido

Payout ID, prefixed wdrl_, or the cofr_ payout request ID returned by POST /payouts — both cancel the same payout.

Parámetros de consulta

account_id
string

Owning account ID, prefixed biz_. Provide exactly one of account_id or user_id.

user_id
string

Owning user ID, prefixed user_. Provide exactly one of account_id or user_id.

Respuesta

payout canceled and funds returned

amount
string<decimal>
requerido

The payout amount in whole currency units, as a decimal string.

Ejemplo:

"500.0"

cancelable
boolean
requerido

Whether POST /payouts/{id}/cancel would act on this payout right now: true while it is in_review, while it is processing with nothing yet submitted to the payout provider, or while a submitted payout can still be asked to cancel at the provider. false once the money has arrived or the payout has already ended.

Ejemplo:

false

conversion
object | null
requerido

How the balance was converted into the payout currency before the payout was sent. null when the payout was sent from a balance in its own currency.

created_at
string<date-time>
requerido

When the payout was created.

Ejemplo:

"2026-07-29T18:22:00.000Z"

currency
string
requerido

Payout currency.

Ejemplo:

"usd"

destination_amount
string<decimal> | null
requerido

The amount delivered in the destination currency, as a decimal string. Assigned when the payout is processed, so it is null before then and on payouts without a recorded conversion.

Ejemplo:

"461.7"

destination_currency
string | null
requerido

Currency the funds are delivered in, taken from the payout method when the payout is created. On a payout funded by a conversion request it follows the settlement payout minted alongside it — the GET /payouts row carrying this payout's id as payout_request_id — and is null only when no settlement payout exists.

Ejemplo:

"eur"

estimated_arrival
string<date-time> | null
requerido

Estimated time the funds become available in the destination account.

Ejemplo:

"2026-08-03T00:00:00.000Z"

exchange_rate
number<float> | null
requerido

Exchange rate from the payout currency to the destination currency. Assigned when the payout is processed, so it is null before then and on payouts without a recorded rate.

Ejemplo:

0.9234

failure
object | null
requerido

Why the payout ended without paying, or why it reversed after settlement. Present on failed, canceled, denied, and reversed payouts; null otherwise.

fee_amount
string<decimal>
requerido

The fee charged for the payout, in the payout currency, as a decimal string.

Ejemplo:

"0.25"

fee_paid_by
enum<string>
requerido

Who bore the payout fee: the account itself, or its parent platform.

Opciones disponibles:
self,
platform
Ejemplo:

"self"

id
string
requerido

Payout ID, prefixed wdrl_ for a payout returned by GET /payouts, cofr_ for a payout request returned by POST /payouts, or pay_ for a payout funded by a card payment that has not been submitted yet.

Ejemplo:

"wdrl_xxxxxxxxxxxxx"

markup_fee
string<decimal>
requerido

Whop's markup on the provider fee, in the payout currency, as a decimal string. "0.0" when none applies.

Ejemplo:

"0.0"

metadata
object
requerido

Key-value data attached at creation and echoed on every read. At most 50 keys, key names up to 40 characters, string values up to 500 characters.

Ejemplo:
net_amount
string<decimal>
requerido

The planned net for the destination, in the payout currency: amount minus fee_amount minus markup_fee when fee_paid_by is self; equal to amount when the platform covers the fees. A payout that ends denied, canceled, or failed delivered nothing — most keep the planned figure and failure says where the funds are, but a canceled payout funded by a conversion request can report the settled outcome instead: amount carries what stayed in the balance, fees are zero because none were charged, and net_amount is 0 because nothing was delivered.

Ejemplo:

"49.75"

notes
string | null
requerido

Free-form notes attached by the payout creator, or null when none were provided. Maximum 255 characters.

Maximum string length: 255
Ejemplo:

"Detailing supplies restock"

object
enum<string>
requerido
Opciones disponibles:
payout
Ejemplo:

"payout"

payer_name
string | null
requerido

Name of the entity processing the payout.

Ejemplo:

"ACH Bank Deposit"

payout_method
object | null
requerido

The saved payout method used. Requires payout:destination:read; null without it.

payout_request_id
string | null
requerido

Payout request ID, prefixed cofr_, returned by POST /payouts. For a request retrieved by its own cofr_ ID, this equals id. Returns null for payouts not created by POST /payouts.

Ejemplo:

"cofr_xxxxxxxxxxxxx"

source
enum<string> | null
requerido

How the payout was created. automatic means a scheduled auto-payout. null when the payout has no recorded source.

Opciones disponibles:
api,
dashboard,
automatic,
null
Ejemplo:

"api"

speed
enum<string>
requerido

Payout delivery speed.

Opciones disponibles:
standard,
instant
Ejemplo:

"standard"

statement_descriptor
string | null
requerido

The payment description sent with the payout, or null if no descriptor was set. When set, 5-80 printable ASCII characters.

Required string length: 5 - 80
Ejemplo:

"MYCOMPANY"

status
enum<string>
requerido

Current payout status.

Opciones disponibles:
requested,
in_review,
processing,
completed,
reversed,
canceled,
failed,
denied
Ejemplo:

"canceled"

status_detail
string
requerido

The finest machine phase under status — for example awaiting_provider_acceptance vs in_transit under processing, or the conversion phase under requested. Informational vocabulary: values can be added without a version bump; status is the versioned contract.

Ejemplo:

"awaiting_provider_acceptance"

trace_code
string | null
requerido

Payment network reference for this payout, such as an ACH trace number, an RTP or FedNow end-to-end ID, a wire IMAD, or a SWIFT UETR. null until the reference is available, and on payouts that have none.

Ejemplo:

"021000021234567"