Skip to main content
POST
TypeScript

Autorisaties

Authorization
string
header
vereist

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

payment:resolution_center

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Voorbeeld:

"2026-11-17"

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"

Padparameters

id
string
vereist

The resolution center case ID (reso_ tag).

Body

application/json
attachments
object[]

Up to 3 evidence files, by existing file id or direct_upload_id.

message
string

An optional note to the customer, recorded on the case timeline.

Voorbeeld:

"Refunding the deposit in full — we could not make the Austin booking window."

terminate_membership
boolean

Whether to also terminate the customer's membership.

Voorbeeld:

false

Respons

case accepted

account
object | null
vereist

The account the case was filed against.

amount
number
vereist

The amount in question, in whole units of currency.

Voorbeeld:

249

available_actions
enum<string>[]
vereist

What you can do to this case right now, named for the endpoint that does it. Resolved for the calling credential, so a merchant and a customer reading the same case see their own options.

Beschikbare opties:
accept,
deny,
request_info,
reply,
appeal,
withdraw
buyer
object
vereist

The customer who opened the case.

created_at
string
vereist

When the case was opened, as an ISO 8601 timestamp.

Voorbeeld:

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

currency
string | null
vereist

Three-letter ISO currency code of the amount.

Voorbeeld:

"usd"

customer_appealed
boolean
vereist

Whether the customer has appealed a decision on this case.

Voorbeeld:

false

escalated
boolean
vereist

Whether Whop is involved — either reviewing the case, or waiting on the side named by status for something it asked for while reviewing.

Voorbeeld:

false

id
string
vereist

Resolution center case ID, prefixed reso_.

Voorbeeld:

"reso_xxxxxxxxxxxxxx"

line_items
object[]
vereist
outcome
enum<string> | null
vereist

Who prevailed on the claim. null until the case closes. Read refund for whether any money actually moved.

Beschikbare opties:
customer_won,
merchant_won,
withdrawn,
null
Voorbeeld:

"merchant_won"

payment
object
vereist

The payment the case was opened against.

product_id
string | null
vereist

The product the payment was for, prefixed prod_.

Voorbeeld:

"prod_xxxxxxxxxxxxxx"

reason
enum<string>
vereist

What the customer says went wrong. Shares the /disputes vocabulary, so a case that later becomes a chargeback reports the same complaint.

Beschikbare opties:
fraudulent,
product_not_received,
not_as_described,
product_unacceptable,
subscription_canceled
Voorbeeld:

"product_not_received"

refund
enum<string> | null
vereist

Whether money moved and off whose balance: none, merchant, or platform (Whop refunded the customer and the merchant kept the funds). Independent of outcome — a case the merchant won can still carry a platform refund. null while the case is open, and on older closed cases that predate this being recorded.

Beschikbare opties:
none,
merchant,
platform,
null
Voorbeeld:

"none"

response_due_at
string | null
vereist

When the next response is due, as an ISO 8601 timestamp.

Voorbeeld:

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

status
enum<string>
vereist

Who the case is waiting on. awaiting_merchant and awaiting_customer name the side that owes a response, under_review means Whop is deciding, and closed means it is settled — read outcome for how.

Beschikbare opties:
awaiting_merchant,
awaiting_customer,
under_review,
closed
Voorbeeld:

"closed"

updated_at
string
vereist

When the case was last changed, as an ISO 8601 timestamp.

Voorbeeld:

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

variant_id
string | null
vereist

The variant the payment was made on, prefixed plan_.

Voorbeeld:

"plan_xxxxxxxxxxxxxx"