{
"webhook_type": "credit_top_up_purchase.fulfilled",
"object_type": "credit_top_up_purchase",
"organization_id": "00000000-0000-4000-8000-000000000001",
"credit_top_up_purchase": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"organization_id": "00000000-0000-4000-8000-000000000001",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "customer_123",
"credit_system_id": "00000000-0000-4000-8000-000000000004",
"credit_system_code": "ai_credits",
"top_up_package_id": "00000000-0000-4000-8000-000000000005",
"package_code": "starter_pack",
"package_name": "Starter pack",
"credit_amount": "250.0",
"amount_cents": 1000,
"currency": "USD",
"expires_after_days": null,
"invoice_id": "00000000-0000-4000-8000-000000000006",
"invoice_number": "FYN-47DD-008-001",
"invoice_amount_cents": 1000,
"payment_status": "succeeded",
"fulfillment_status": "fulfilled",
"fulfilled_at": "2026-10-27T14:12:39Z",
"payment_id": null,
"payment_provider": "stripe",
"payment_provider_type": null,
"payment_provider_code": null,
"provider_payment_id": null,
"payment_url": null,
"replayed": false,
"created_at": "2026-10-27T14:12:01Z"
}
}The credits of a paid top up can be spent
The Engine granted the credits of a paid top-up purchase, so they are in the customer’s balance and can be spent. Sent once per purchase, after the grant is committed. A paid invoice alone does not mean the credits are spendable; wait for this event or poll GET /credit-top-up-purchases/{id} until fulfillment_status is fulfilled.
{
"webhook_type": "credit_top_up_purchase.fulfilled",
"object_type": "credit_top_up_purchase",
"organization_id": "00000000-0000-4000-8000-000000000001",
"credit_top_up_purchase": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"organization_id": "00000000-0000-4000-8000-000000000001",
"customer_id": "00000000-0000-4000-8000-000000000003",
"external_customer_id": "customer_123",
"credit_system_id": "00000000-0000-4000-8000-000000000004",
"credit_system_code": "ai_credits",
"top_up_package_id": "00000000-0000-4000-8000-000000000005",
"package_code": "starter_pack",
"package_name": "Starter pack",
"credit_amount": "250.0",
"amount_cents": 1000,
"currency": "USD",
"expires_after_days": null,
"invoice_id": "00000000-0000-4000-8000-000000000006",
"invoice_number": "FYN-47DD-008-001",
"invoice_amount_cents": 1000,
"payment_status": "succeeded",
"fulfillment_status": "fulfilled",
"fulfilled_at": "2026-10-27T14:12:39Z",
"payment_id": null,
"payment_provider": "stripe",
"payment_provider_type": null,
"payment_provider_code": null,
"provider_payment_id": null,
"payment_url": null,
"replayed": false,
"created_at": "2026-10-27T14:12:01Z"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Signature of the webhook payload
"Ap¶5ɿΣ6ÐfV£Ä\u0015\u0015ºõÔõÔ[DæAâÿüÚ"
Algorithm used to generate the signature
jwt, hmac "hmac"
Unique id of the webhook. It can be used for idempotency
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Body
Details of the event
credit_top_up_purchase.fulfilled credit_top_up_purchase Unique identifier of the organization, created by Nozle.
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Purchase snapshot serialized by Nozle Core and passed through unchanged by the Engine.
Show child attributes
Show child attributes
Response
Return a 2xx status within 30 seconds to acknowledge the delivery. Any other status, a timeout or a connection error is a failed attempt; Nozle makes up to 3 attempts.