Fired every time a payment settles successfully — the first payment and every renewal alike

Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

invoiceIdstring

The invoice ID.

invoiceNumberstring

The human-readable invoice number.

invoiceTotalnumber

Invoice total in cents (100 = $1.00).

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

subscriptionIdstring | null

The subscription ID.

paymentTransactionIdstring | null

The payment transaction ID.

provider"stripe" | "commet" | "dlocal" | null

The payment provider the charge was routed to: stripe, commet, or dlocal. Null for billing-only charges with no Commet ledger row.

grossAmountnumber | null

Gross amount in cents before fees.

currencystring | null

The payment currency code.

orgNetAmountnumber | null

Net amount after fees in cents.

customerEmailstring | null

The customer email used for this payment.

paidAtstringoptional

ISO 8601 datetime when the payment was received.

{
  "event": "payment.received",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-06-23",
  "data": {
    "invoiceId": "inv_n4o5p6",
    "invoiceNumber": "INV-0043",
    "invoiceTotal": 9900,
    "customerId": "user_123",
    "subscriptionId": "sub_1a2b3c4d",
    "paymentTransactionId": "txn_q7r8s9",
    "provider": "stripe",
    "grossAmount": 9900,
    "currency": "usd",
    "orgNetAmount": 9200,
    "customerEmail": "billing@acme.com",
    "paidAt": "2026-04-25T00:05:00.000Z"
  }
}