> ## Documentation Index
> Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tip Received Webhook

> Webhook event fired when a creator receives a tip.

<Warning>
  `tip.new` is deprecated. Use [`creator.payment.succeeded`](/docs/creator/payments)
  instead (`source` is `tip`). This event continues to fire during the migration
  window; new integrations should use the `creator.*` event.
</Warning>

## When this fires

Triggered when a user sends a tip to a creator.

Amounts are in minor units (for USD, cents).

## Payload

The payload uses a [discriminated union](https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes-func.html#discriminated-unions) pattern based on the `context` field:

### Common fields

* `context`: Either `"post"` or `"message"` - indicates the tip type
* `recipientUuid`: UUID of the creator who received the tip
* `senderUuid`: UUID of the user who sent the tip
* `price`: Tip amount in minor units
* `sender`: The user who tipped (uuid, handle, displayName, avatarUrl)
* `transactionOrderId`: The Fanvue transaction/order identifier for this payment, matching the `transactionOrderId` on [`/insights/earnings`](/docs/api-reference/get-earnings-data). Lets you reconcile the event against earnings without a second call. Included when the payment has settled; omitted otherwise.
* `transactionOrderStatus`: Payout state of the transaction at the time of the event — `availableForPayout` (cleared) or `pendingBalance` (still in the chargeback/fraud retention window). This is a snapshot at event time and may change as the payment matures. Included alongside `transactionOrderId`.
* `timestamp`: ISO 8601 time the event occurred

### Post tip fields

* `postUuid`: UUID of the post that was tipped (only when `context` is `"post"`)

### Message tip fields

* `messageUuid`: UUID of the message that was tipped (only when `context` is `"message"`)

## Example payloads

### Post tip

```json theme={null}
{
  "context": "post",
  "postUuid": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "senderUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
  "price": 500,
  "sender": {
    "avatarUrl": "https://via.placeholder.com/150",
    "displayName": "Test User",
    "handle": "test-user",
    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
  },
  "transactionOrderId": "FV-ORDER-12347",
  "transactionOrderStatus": "availableForPayout",
  "timestamp": "2025-11-06T10:32:52.000Z"
}
```

### Message tip

```json theme={null}
{
  "context": "message",
  "messageUuid": "d4c3b2a1-6f5e-8b7a-0d9c-6d5c4b3a2f1e",
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "senderUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
  "price": 1000,
  "sender": {
    "avatarUrl": "https://via.placeholder.com/150",
    "displayName": "Test User",
    "handle": "test-user",
    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
  },
  "transactionOrderId": "FV-ORDER-12348",
  "transactionOrderStatus": "availableForPayout",
  "timestamp": "2025-11-06T10:32:52.000Z"
}
```