Tip Received Webhook

​

When this fires

​

Payload

​

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. 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

{
  "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

{
  "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"
}