Skip to main content
POST
TypeScript

Autorisationer

Authorization
string
header
påkrævet

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:transfer_funds
payout:withdraw_funds

Overskrifter

Idempotency-Key
string

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

Maximum string length: 255
Eksempel:

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

Api-Version-Date
string

Pins the request to a dated API version.

Eksempel:

"2026-11-17"

Krop

application/json

Moves credit between two Whop balances and returns a transfer. The transfer can come back processing and reach succeeded or failed asynchronously, usually within seconds.

amount
number
påkrævet

The amount to move, in the transfer currency. For example 25.00.

Eksempel:

25

currency
string
påkrævet

Currency, such as usd.

Eksempel:

"usd"

destination_id
string
påkrævet

The recipient. A user ID (user_xxx), account ID (biz_xxx), or ledger account ID (ldgr_xxx).

Eksempel:

"user_xxxxxxxxxxxxxx"

origin_id
string
påkrævet

The account sending the funds. A user ID (user_xxx), account ID (biz_xxx), or ledger account ID (ldgr_xxx).

Eksempel:

"biz_xxxxxxxxxxxxxx"

type
enum<string>
påkrævet

The kind of money movement.

Tilgængelige muligheder:
balance
Eksempel:

"balance"

feed_id
string | null

The feed the transfer was initiated from. Given with feed_type, the payment receipt posts into that feed instead of a direct message.

Eksempel:

"feed_shineclub"

feed_type
enum<string> | null

The type of the feed named by feed_id.

Tilgængelige muligheder:
dms_feed,
chat_feed,
forum_feed,
livestream_feed,
universal_post,
user,
null
Eksempel:

"chat_feed"

idempotence_key
string | null

A unique key that makes retries safe. Retrying with the same key returns the original transfer instead of moving money twice.

Eksempel:

"shine-refund-1042"

metadata
object | null

Custom key-value pairs attached to the transfer. Max 50 keys, 100 chars per key, 500 chars per string value.

Eksempel:
notes
string | null

A short note describing the transfer.

Eksempel:

"Refund for the rescheduled interior detail"

Svar

money movement created

A transfer between Whop accounts or users.

amount
object | null
påkrævet

Amount credited to the recipient. Null while the transfer has not succeeded.

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

When the transfer was created.

Eksempel:

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

destination
TransferParty · object | null
påkrævet

Business account or user receiving the transfer.

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

Recorded failure time. Null unless the transfer has failed.

Eksempel:

null

failure_code
string | null
påkrævet

Machine-readable failure code. Null unless the transfer has failed.

Eksempel:

null

failure_reason
string | null
påkrævet

Failure explanation. Null unless the transfer has failed.

Eksempel:

null

fee
object | null
påkrævet

All applicable transfer fees, including platform markup. Null when the authoritative total is unavailable.

id
string
påkrævet

Transfer ID.

Eksempel:

"ctt_xxxxxxxxxxxxxx"

metadata
object
påkrævet

Custom metadata attached to the transfer.

Eksempel:
notes
string | null
påkrævet

Transfer note.

Eksempel:

"Refund for the rescheduled interior detail"

object
enum<string>
påkrævet

The object type.

Tilgængelige muligheder:
transfer
Eksempel:

"transfer"

origin
TransferParty · object | null
påkrævet

Business account or user sending the transfer.

status
enum<string>
påkrævet

Current transfer status. A transfer can be created processing and settle a few seconds later; poll Retrieve Transfer or listen for the transfer.completed and transfer.failed webhooks instead of treating the create response as final. succeeded and failed are final.

Tilgængelige muligheder:
processing,
succeeded,
failed
Eksempel:

"succeeded"

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

Recorded time of the current transition. Null when the historical transition time is unknown.

Eksempel:

null

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

Recorded success time. Null when unknown.

Eksempel:

null

tracking_url
string<uri>
påkrævet

Tracking page for the transfer. Viewing it requires sign-in and access to the transfer.

Eksempel:

"https://whop.com/ctt_xxxxxxxxxxxxxx/"