Skip to main content
Answer

I see the new webhook event type: INVOICE_ISSUANCE, I am using web billing, what would I use this event for?

  • June 11, 2025
  • 1 reply
  • 64 views
F
Forum|alt.badge.img+2

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.

Best answer by mr_ed

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.

This post has been closed for comments

1 reply

mr_ed
RevenueCat Staff
Forum|alt.badge.img+1
  • mr_ed
  • RevenueCat Staff
  • Answer
  • June 11, 2025

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.

F
Terms & ConditionsCookie settingsAccessibility statement