Transfers

Create Transfer

Changed on

Moves money between Whop balances, sends USDT from an account's wallet, or funds a claim link anyone with the URL can redeem. The type you send decides which object comes back.

post/transfers

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/transfers
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

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

Request body

OR

Example request

{
  "amount": 25,
  "currency": "usd",
  "destination_id": "user_xxxxxxxxxxxxxx",
  "feed_id": "feed_shineclub",
  "feed_type": "chat_feed",
  "idempotence_key": "shine-refund-1042",
  "metadata": {
    "order_id": "SHINE-1042"
  },
  "notes": "Refund for the rescheduled interior detail",
  "origin_id": "biz_xxxxxxxxxxxxxx",
  "type": "balance"
}

Response

money movement created

OR

Example response

{
  "amount": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "destination": {
    "id": "biz_xxxxxxxxxxxxxx",
    "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/shine-time-logo",
    "name": "Shine Time Auto Detailing",
    "object": "account"
  },
  "fee": {
    "amount": "-1234.56",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "id": "ctt_xxxxxxxxxxxxxx",
  "metadata": {
    "order_id": "SHINE-1042"
  },
  "notes": "Refund for the rescheduled interior detail",
  "object": "transfer",
  "origin": {
    "id": "biz_xxxxxxxxxxxxxx",
    "logo_url": "https://whop-assets-example.s3.amazonaws.com/uploads/image/2026-01-01/shine-time-logo",
    "name": "Shine Time Auto Detailing",
    "object": "account"
  },
  "status": "succeeded",
  "tracking_url": "https://whop.com/ctt_xxxxxxxxxxxxxx/"
}

Changes

  • d94adec84933Revision changes
    • info

      the security scope payout:transfer_funds was added to the endpoint's security scheme bearerAuth

    • info

      the security scope airdrop_link:manage was removed from the endpoint's security scheme bearerAuth

  • 54dbb42f6781Revision changes
    • info

      the security scope payout:transfer_funds was added to the endpoint's security scheme bearerAuth

    • info

      the security scope airdrop_link:manage was removed from the endpoint's security scheme bearerAuth