NotP_Dot

[gritty wharf]

Hey there

Yep, you want to listen for customer.subscription.updated

This will fire any time a property on the Subscription changes

So you'll want to focus on the status for this

[swift coral]

I am assuming this also includes if the card is declined?

[gritty wharf]

Well if a card is declined on a renewal payment then the Subscription will move from active to past_due

If you want the specific details of a decline, you would listen for invoice.payment_failed

[swift coral]

ahh okay sounds good. Thank you for clearing that up

[gritty wharf]

You can also use customer.subscription.deleted if you specifically want to listen for a Subscription being canceled

https://stripe.com/docs/billing/subscriptions/webhooks is a helpful resource!

[swift coral]

thank you again, I'll start setting up the subscription process.

are there any docs you can provide for setting up subscriptions for the first time, I'll follow your suggestions for cancellations and payment failed

[gritty wharf]

Yep, you want to follow our integration guide here: https://stripe.com/docs/billing/subscriptions/build-subscriptions?ui=elements

[swift coral]

perfect, thank you very much

one last question

can I follow this guide for subscriptions with a 1 time payment fee, or are there additional docs for that

[gritty wharf]

As in you want to also take one-time payments alongside Subs?

[swift coral]

yes only for the first month

after the first month, its just the subscription

[gritty wharf]

Ah you can add a one-time item to the initial Subscription invoice. You would do that via the add_invoice_items param (https://stripe.com/docs/api/subscriptions/create#create_subscription-add_invoice_items) when you create the Subscription

Don't think that is specified in the above integration guide

[swift coral]

got it, this is exactly what I was looking for

thank you again bismarck