Sen-subscription-retries | Stripe Developers | Page 1

drowsy stump Dec 2, 2021, 9:21 AM

#

Hey! You'll want invoice.payment_failed: https://stripe.com/docs/api/events/types#event_types-invoice.payment_failed

Complete reference documentation for the Stripe API. Includes code snippets and examples for our Python, Java, PHP, Node.js, Go, Ruby, and .NET libraries.

pale bone Dec 2, 2021, 9:25 AM

#

But when stripe subscription plan end of the period thencustomer.subscription.updated event run right? so I need to intercept invoice.payment_failed event also??

drowsy stump Dec 2, 2021, 9:28 AM

#

Not necessarily: https://stripe.com/docs/billing/subscriptions/overview#subscription-events

How subscriptions work

Learn how subscriptions work within Stripe.

pale bone Dec 2, 2021, 9:35 AM

#

I have read the doc so that I am confused and decided to ask questions directly to you.
Like when the subscription period ends which event needs to intercept??
Please give me an exact event that I need to integrate while recurring.

drowsy stump Dec 2, 2021, 9:37 AM

#

The behaviour depends - does the payment succeed? Why not test this?

pale bone Dec 2, 2021, 9:40 AM

#

So I need to intercept more than one event when subscription recurring??

drowsy stump Dec 2, 2021, 9:42 AM

#

What exactly are you trying to do?

pale bone Dec 2, 2021, 9:47 AM

#

I think you have not understand my question.
Let's say I have created a weekly subscription plan and then the week elapses so which webhook events will be triggered from the stripe.
Generally, the flow is if successfully recurring done then will update subscription-related data into our system.

My question is I need to check how many events for this flow?

drowsy stump Dec 2, 2021, 9:53 AM

#

I do understand your question, but the events that are sent depend on a lot of factors. So let's assume the subscription is successfully renewed:

invoice.created
invoice.finalized
payment_intent.created
payment_intent.succeeded
customer.subscription.updated

#

But you don't need to listen for them all, which is why I asked what exactly are you trying to do

pale bone Dec 2, 2021, 9:56 AM

#

drowsy stump I do understand your question, but the events that are sent depend on a lot of f...

I am trying to do is if the subscription is successfully renewed, update subscription data and if renewed failed due to some reason then log that error and update subscription status inactive from my side.
Now, which event is useful as you mentioned above?

drowsy stump Dec 2, 2021, 10:01 AM

#

I guess you'd want customer.subscription.updated

#

Specifically the status & current_period_end fields

pale bone Dec 2, 2021, 10:03 AM

#

Thanks
How to know that payment is failed using customer.subscription.updated event??

drowsy stump Dec 2, 2021, 10:04 AM

#

https://stripe.com/docs/billing/subscriptions/overview#build-your-own-handling-for-recurring-charge-failures

How subscriptions work

Learn how subscriptions work within Stripe.

#

status: 'past_due'

pale bone Dec 2, 2021, 10:06 AM

#

Great, now I have used 'payment_method' => 'stripeToken' when creating a customer. So when upgrading subscription with the customer, payment will automatically deducted from customer account?

drowsy stump Dec 2, 2021, 10:09 AM

#

What do you mean by 'upgrading subscription'?

pale bone Dec 2, 2021, 10:10 AM

#

I mean switch plan from old one to new.

drowsy stump Dec 2, 2021, 10:11 AM

#

Again, it depends. What's the API call you're making to do that?

pale bone Dec 2, 2021, 10:15 AM

#

Yes, I have used Subscription::update() API. Also, set proration_behavior => none and billing_cycle_anchor=> now

drowsy stump Dec 2, 2021, 10:17 AM

#

Ok so as you're switching plans and the billing anchor, I guess your intention is to discard in prorations for the previous billing cycle?

drowsy stump Dec 2, 2021, 10:18 AM

#

pale bone Yes, I have used `Subscription::update()` API. Also, set `proration_behavior => ...

Then yes, that will invoice them immediately: https://stripe.com/docs/billing/subscriptions/upgrade-downgrade#immediate-payment

Upgrade and downgrade subscriptions

Learn how to upgrade and downgrade subscriptions by changing the price.

pale bone Dec 2, 2021, 10:18 AM

#

drowsy stump `status: 'past_due'`

If payment failed due to card error or declined then check status past_due But after some time stripe will try to make the payment again???
If so then This is important because when the customer solved the decline error from their end then payment will be deduced but my system does not know.

drowsy stump Dec 2, 2021, 10:19 AM

#

pale bone If payment failed due to card error or declined then check status `past_due` But...

That depends on if you have the retries configured

#

If a retry succeeds and payment is captured then the customer.subscription.updated event will fire eventually (which you're handling)

pale bone Dec 2, 2021, 10:21 AM

#

drowsy stump If a retry succeeds and payment is captured then the `customer.subscription.upda...

That's I looking for.

#

For canceling a subscription, at the priod_end then end of the period which event will run?

drowsy stump Dec 2, 2021, 10:23 AM

#

customer.subscription.deleted

pale bone Dec 2, 2021, 10:26 AM

#

drowsy stump `customer.subscription.deleted`

This event will run end of the period not run when customers cancel at time. Suppose the customer cancel today but the period ends will after two days then customer.subscription.deleted event fired two days after.

drowsy stump Dec 2, 2021, 10:27 AM

#

Ah, got it. You'd be looking for customer.subscription.updated, specifically: https://stripe.com/docs/api/subscriptions/object?lang=php#subscription_object-cancel_at_period_end

Stripe API reference – The subscription object – PHP

Complete reference documentation for the Stripe API. Includes code snippets and examples for our Python, Java, PHP, Node.js, Go, Ruby, and .NET libraries.

#

All of this is very easy to test 🙂

pale bone Dec 2, 2021, 10:31 AM

#

Thank you so much.
The last question is If the admin switches subscription or cancel or deleted from the stripe dashboard then how to handle that task?
I mean need to tell my system that some changes are occurred from the stripe and will update related data in my system you know.

drowsy stump Dec 2, 2021, 10:32 AM

#

The same events will fire

pale bone Dec 2, 2021, 10:38 AM

#

Ok
Like switches => customer.subscription.updated
deleted => customer.subscription.deleted
But which event for cancel => ???

drowsy stump Dec 2, 2021, 10:39 AM

#

Again, depends on when it is set to cancel

#

There's no real 'delete' action - that event fires when the subscription cancels (be that immediately or at the end of billing period)

pale bone Dec 2, 2021, 10:39 AM

#

I already said when cancel from stripe dashboard

pale bone Dec 2, 2021, 10:41 AM

#

drowsy stump There's no real 'delete' action - that event fires when the subscription *cancel...

https://prnt.sc/21dr1is

Lightshot

Screenshot

Captured with Lightshot

drowsy stump Dec 2, 2021, 10:45 AM

#

Right, but that's not a delete action as we previously discussed

#

#915894961977831464 message

#

customer.subscription.deleted only fires when it actually cancels (be that at the billing period end like you said earlier)

pale bone Dec 2, 2021, 10:47 AM

#

So when stripe admin Cancel subscription as above button then customer.subscription.deleted event triggered???
I have used stripe.js for card payment fields. So credit cards will also work or only debit card works??

drowsy stump Dec 2, 2021, 10:49 AM

#

When are you setting the subscription to cancel via the Dashboard?

pale bone Dec 2, 2021, 10:50 AM

#

drowsy stump When are you setting the subscription to cancel via the Dashboard?

yes

drowsy stump Dec 2, 2021, 10:52 AM

#

Are you cancelling it immediately? Or at the end of the period?

#

Or a specific date?

pale bone Dec 2, 2021, 11:21 AM

#

Sorry for the late respose. Both ways are possible.

#

I just want to know which webhook will trigged when above three possibility will apply.

drowsy stump Dec 2, 2021, 11:28 AM

#

Cancel immediately: customer.subscription.deleted
Cancel on specific date (or end of period): customer.subscription.updated fired immediately, followed by customer.subscription.deleted on the date you set to cancel

#

Again, this is all very easy for you to try out in test mode

pale bone Dec 2, 2021, 11:33 AM

#

Ok, I will test now.
I have used stripe.js for card payment fields. Is a credit card work the same as a debit card? Or any config needed.

drowsy stump Dec 2, 2021, 11:34 AM

#

Nope, credit/debit is indifferent. We support most major brands: https://stripe.com/docs/payments/payment-methods/overview#cards

Learn about payment methods

Accepting more payment methods helps your business expand its global reach and improve checkout conversion.

pale bone Dec 2, 2021, 11:41 AM

#

Yes, I have seen the doc. But there are no described Credit card works?
I mean like visa or Mastercard right but my visa is a debit card and Mastercard is credit. So when I will make payment through a credit card, will it work?

drowsy stump Dec 2, 2021, 11:42 AM

#

Yep, there's no difference

pale bone Dec 2, 2021, 11:45 AM

#

Ohh, Thank you!!
The last question is about 3DS payment authentication. Right now my site integration has not used this feature you know.
So any restriction faces in future. Like my integration not work.

drowsy stump Dec 2, 2021, 11:47 AM

#

Yep, you will need to account for that!

pale bone Dec 2, 2021, 11:51 AM

#

Thank you mate.
You help me a lot.

drowsy stump Dec 2, 2021, 11:52 AM

#

Np!

#Sen-subscription-retries