invoice.paid

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "invoice.paid",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "invoice_id": "inv_1a2b3c4d5e",
    "subscription": { "subscription_id": "sub_1a2b3c4d5e" },
    "customer": { "customer_id": "cust_1a2b3c4d5e6f", "email": "jane@example.com", "name": "Jane Doe" },
    "charge": null,
    "status": "paid",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "subtotal": "10.00",
    "total": "10.00",
    "amount_paid": "10.00",
    "amount_remaining": "0.00",
    "period_start": "2026-04-01T00:00:00Z",
    "period_end": "2026-05-01T00:00:00Z",
    "attempt_count": 0,
    "next_payment_attempt": "2026-04-01T00:05:00Z",
    "created_at": "2026-04-01T00:00:00Z",
    "metadata": {}
  }
}

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "invoice.paid",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "invoice_id": "inv_1a2b3c4d5e",
    "subscription": { "subscription_id": "sub_1a2b3c4d5e" },
    "customer": { "customer_id": "cust_1a2b3c4d5e6f", "email": "jane@example.com", "name": "Jane Doe" },
    "charge": null,
    "status": "paid",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "subtotal": "10.00",
    "total": "10.00",
    "amount_paid": "10.00",
    "amount_remaining": "0.00",
    "period_start": "2026-04-01T00:00:00Z",
    "period_end": "2026-05-01T00:00:00Z",
    "attempt_count": 0,
    "next_payment_attempt": "2026-04-01T00:05:00Z",
    "created_at": "2026-04-01T00:00:00Z",
    "metadata": {}
  }
}

Sent when an invoice is paid. Use it to extend the subscription period or mark the bill settled.

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "invoice.paid",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "invoice_id": "inv_1a2b3c4d5e",
    "subscription": { "subscription_id": "sub_1a2b3c4d5e" },
    "customer": { "customer_id": "cust_1a2b3c4d5e6f", "email": "jane@example.com", "name": "Jane Doe" },
    "charge": null,
    "status": "paid",
    "collection_method": "charge_automatically",
    "currency": "USD",
    "subtotal": "10.00",
    "total": "10.00",
    "amount_paid": "10.00",
    "amount_remaining": "0.00",
    "period_start": "2026-04-01T00:00:00Z",
    "period_end": "2026-05-01T00:00:00Z",
    "attempt_count": 0,
    "next_payment_attempt": "2026-04-01T00:05:00Z",
    "created_at": "2026-04-01T00:00:00Z",
    "metadata": {}
  }
}

Event fields

string

The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.

string

Always invoice.paid.

string

When the event occurred, in UTC.

string

Your account’s ID.

string

The invoice’s ID.

object | null

The subscription this invoice belongs to, or null for a one-off.

object

The customer the invoice is for.

object | null

The payment that collected the invoice, once collection is attempted.

string

Invoice status: draft, open, paid, uncollectible, or void.

string

How the invoice is collected, e.g. charge_automatically.

string

The invoice currency, as an ISO 4217 code.

string

The subtotal before credits, as a decimal string.

string

The total due, as a decimal string.

string

Amount paid so far.

string

Amount still due.

string

Start of the billing period, in UTC.

string

End of the billing period, in UTC.

integer

Number of collection attempts made.

string | null

When the next collection attempt is scheduled.

object

Your own key-value data on the invoice.

Concepts

Events

Endpoint API

invoice.paid

Event fields

​Event fields

Event fields