Skip to main content
GET
TypeScript

인증

Authorization
string
header
필수

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

헤더

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

경로 매개변수

id
string
필수

The transfer ID.

응답

transfer retrieved

A transfer between Whop accounts or users.

amount
object | null
필수

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

created_at
string<date-time>
필수

When the transfer was created.

예시:

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

destination
TransferParty · object | null
필수

Business account or user receiving the transfer.

failed_at
string<date-time> | null
필수

Recorded failure time. Null unless the transfer has failed.

예시:

null

failure_code
string | null
필수

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

예시:

null

failure_reason
string | null
필수

Failure explanation. Null unless the transfer has failed.

예시:

null

fee
object | null
필수

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

id
string
필수

Transfer ID.

예시:

"ctt_xxxxxxxxxxxxxx"

metadata
object
필수

Custom metadata attached to the transfer.

예시:
notes
string | null
필수

Transfer note.

예시:

"Refund for the rescheduled interior detail"

object
enum<string>
필수

The object type.

사용 가능한 옵션:
transfer
예시:

"transfer"

origin
TransferParty · object | null
필수

Business account or user sending the transfer.

status
enum<string>
필수

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.

사용 가능한 옵션:
processing,
succeeded,
failed
예시:

"succeeded"

status_changed_at
string<date-time> | null
필수

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

예시:

null

succeeded_at
string<date-time> | null
필수

Recorded success time. Null when unknown.

예시:

null

tracking_url
string<uri>
필수

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

예시:

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