Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Payload of the deprecated flat tip.new webhook, fired when a fan tips a creator, and its replacement creator.payment.succeeded with source tip.
tip.new is the deprecated flat event for a user tipping a creator. It requires the read:creator scope, and new integrations use creator.payment.succeeded instead, where source is tip.
tip.new. It keeps firing during the migration window, after which only creator.payment.succeeded is delivered. Subscribe to creator.payment.succeeded and move existing consumers before the window closes.tip.new fires when a user sends a tip to a creator.
Amounts are in minor units (for USD, cents).
context field.
| Field | Description |
|---|---|
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. 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). It is a snapshot at event time and may change as the payment matures. Included alongside transactionOrderId. |
timestamp | ISO 8601 time the event occurred |
| Field | Description |
|---|---|
postUuid | UUID of the post that was tipped (only when context is "post") |
| Field | Description |
|---|---|
messageUuid | UUID of the message that was tipped (only when context is "message") |
{
"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"
}
{
"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"
}
Was this page helpful?