Skip to main content

I use webhooks to credit users for purchases in my app, I noticed I started to receive a new event type, INVOICE_ISSUANCE. I looked at the documentation but I have no idea what I would use this event for. The documentation says: 

A new invoice has been issued for the purchase. This event is sent when a new invoice is created for a subscription or non-renewing purchase that has not yet been paid. This event is only available for Web Billing purchases.

Does this mean a user saw the web paywall or they clicked purchase and you just haven’t collected the funds? Will other events still be emitted? Would love a bit more documentation about why someone might care about the event.

Hi there,

This event corresponds to an invoice being created by the billing system, which doesn’t necessarily mean a new purchase is happening in the checkout. You could use this as an indication that we’re attempting to charge the customer’s payment method.

Generally speaking, an invoice is issued:

  • During the very small window between attempting a payment and that payment being completed, during the purchase process
  • When an active subscription or trial renews and a new charge is attempted (the invoice is first created, then payments are attempted during a period of time, then a receipt is issued once the payment succeeds)

A “payment happened” is associated to the INITIAL_PURCHASE or RENEWAL events.

Thanks for your feedback on the documentation here — I’ve added a small clarification to the description of that event.

Reply


Terms & ConditionsCookie settings