Skip to main content
creator.payment.succeeded fires when an on-platform payment to the creator settles: a paid post, a locked (PPV) message, a media purchase, or a tip. It is the successor to the legacy purchase.new and tip.new events, carrying the full money breakdown in one payload.
Event (type)ResourceFires when
creator.payment.succeededpaymentAn on-platform payment to the creator succeeds
Requires the read:creator scope. Delivered in the Standard-Webhooks envelope; the fields below describe the data object.
Recurring subscription money is reported on the subscription resource, not here. Checkout-link sales fire the separate checkout_link.payment.succeeded event.

​
Payment resource

FieldTypeDescription
objectstringAlways "payment"
idstringFanvue payment / invoice identifier
statusstringAlways "succeeded" for this event
sourcestringWhat was bought: post, message, media, or tip
billing_reasonstringone_time, subscription_initial, or subscription_renewal
grossintegerGross amount in minor units
netinteger | nullCreator net after fees, in minor units
feesobject{ fanvue_fee, transaction_fee }, each integer minor units or null
currencystring | nullISO 4217 currency code
paid_in_fullbooleanWhether the payment settled in full
client_reference_idstring | nullYour passthrough reference from the original purchase
transaction_idstring | nullPayment-processor transaction id
created_atstring | nullISO 8601 time the payment was created
paid_atstring | nullISO 8601 time the payment settled
purchaserobject{ uuid, email } of the buyer (email may be null)
creatorobject{ uuid } of the creator
metadataobjectYour passthrough metadata map

​
Example: creator.payment.succeeded

{
  "id": "f1a2b3c4-1111-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "creator.payment.succeeded",
  "timestamp": "2026-06-09T08:39:33.139Z",
  "data": {
    "object": "payment",
    "id": "FV-12345",
    "status": "succeeded",
    "source": "message",
    "billing_reason": "one_time",
    "gross": 1999,
    "net": 1799,
    "fees": { "fanvue_fee": 200, "transaction_fee": 0 },
    "currency": "USD",
    "paid_in_full": true,
    "client_reference_id": "your-crm-id-123",
    "transaction_id": "txn_abc",
    "created_at": "2026-06-09T08:39:33.000Z",
    "paid_at": "2026-06-09T08:39:33.139Z",
    "purchaser": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": { "campaign": "spring-promo" }
  }
}