#kunalmahajan710-subscription-webhooks
cunning oxide
Hello i have implemneted the recurring subscriptons from user credit card that is working fine.
I have also setup the webhook api endpoint to get the next billing cycle status but the problem is that end point is not receiving data
mossy musk
What types of events did you specify to be sent to your webhook endpoint?
cunning oxide
subscription_schedule.aborted
subscription_schedule.canceled
subscription_schedule.completed
subscription_schedule.created
subscription_schedule.expiring
subscription_schedule.released
subscription_schedule.updated
mossy musk
Ah, so those events are for Subscription Schedule objects, which are different from Subscriptions. Can you confirm if you're working Subscription Schedules? If not, you likely want to listen to the customer.subscription.XXX events, such as this customer.subscription.created one:
https://stripe.com/docs/api/events/types#event_types-customer.subscription.created
cunning oxide
See when i click on send test run it works the api end point
but when we do create a subcription at code level then the response is not coming
if customer create a subscription subscription_schedule.created i am not getting response from api endpoint
but when i manually click on send test run it works
mossy musk
That's because creating a subscription doesn't create a subscription schedule and therefore doesn't trigger the event you're listening to.
cunning oxide
mossy musk
Subscription schedules are their own type of objects:
https://stripe.com/docs/api/subscription_schedules
If you're creating subscriptions (not subscription schedules), then you're creating these objects:
https://stripe.com/docs/api/subscriptions
For Subscriptions you'll need to listen to events that start with customer.subscription. as these are the events that correlate to subscription objects.
cunning oxide
Have you seen my above screenshot?
mossy musk
Yup, it shows a subscription on a customer
mossy musk
Yup
cunning oxide
so on 1st sept i want to data receive using webhook so thats data is not coming in my server that i created the endoint
For testing i created a webhook call on subscription created also
mossy musk
Let's take a step back, we know you're creating subscriptions. What information are you trying to get sent to your endpoint and when?
cunning oxide
susbcription created information
in above screenshot you see that i created a webhook
mossy musk
Yup, I see a test mode webhook configured to receive 7 events
Can you provide me with the ID (we_XXX) for that webhook endpoint? It will be the end of the dashboard url where you got that most recent screenshot.
cunning oxide
this is test mode
mossy musk
Deleted because that was your webhook signing secret. The webhook endpoint ID should start with we_ as mentioned previously.
As shown by the label above that field, that is your webhook signing secret.
As it is secret it should not be shared in public forums.
mossy musk
This is what I'm looking for from your webhook endpoint:
mossy musk
You can't, this is so I can pull things up on my end.
cunning oxide
ok
mossy musk
Alright, so I see that webhook endpoint is still only configured to receive subscription_schedule events, and I'm not seeing any evidence that you're working with subscription schedules. Instead you seem to be working with subscriptions.
If you look at one of the events triggered when you created a subscription, you can see near the top of the page (just under the text "EVENT") that the type of this event is customer.subscription.created
https://dashboard.stripe.com/test/events/evt_1KC6doD5SW4Qmpx7DyWvSwIV
cunning oxide
i am confused now
what is difference between subscriptions and subscription schedules?
mossy musk
Subscription Schedules are used to schedule changes to subscriptions. Such as adding a discount after the first year for long-term membership, or increasing the price after the first 3 months:
https://stripe.com/docs/billing/subscriptions/subscription-schedules/use-cases
cunning oxide
But we dont need it... Our requirement is pretty simple
Suppose
User subscribe on monthly basis Dec 1 2021
and i need the status on Jan 1 2022 whetere payment created or aborted
using webhook api endpoint
how can i do that?
I am using below code for subscription
$subscription = Subscription::create([
"customer" => $stripeCus->id,
"items" => [
[
"plan" => $stripePlan,
],
],
"trial_end" => $trialEnd
]);
mossy musk
It sounds like you want to listen for invoice.paid events, which this doc discusses in more detail:
https://stripe.com/docs/billing/subscriptions/webhooks#tracking
cunning oxide
Which event will be used when subscription is created?
$subscription = Subscription::create([
"customer" => $stripeCus->id,
"items" => [
[
"plan" => $stripePlan,
],
],
"trial_end" => $trialEnd
]);
mossy musk
customer.subscription.created
mossy musk
Of course 😄
cunning oxide
$subscription = Subscription::create([
"customer" => $stripeCus->id,
"items" => [
[
"plan" => $stripePlan,
],
],
"trial_end" => $trialEnd
]);
This is our monthly subscription plan
User opt on Dec1 2021 and will charge again on Jan1 2022
so which event will be used?
mossy musk
The section of that doc I most recently linked to walks through this.
Prior to the renewal you'll receive an invoice.upcoming event. Exactly when will depend on the setting shown in the attached screenshot that can be adjusted here:
https://dashboard.stripe.com/settings/billing/automatic
Then that invoice will attempt to be paid, and there are several events that can return from this:
invoice.paid and invoice.payment_succeeded indicate that the invoice was successfully paid
invoice.payment_failed will be thrown if the payment can't be completed
or possibly invoice.payment_action_required if the payment method requires authentication
cunning oxide
The main thing we want to know is when renewal payment is made, or when it fails temporarily, or when it fails permanently, or if the customer cancels it on their side
so all future subscriptions events is related to invoice events correct?
mossy musk
That question seems very broad so I'm not exactly sure what you're asking, but no, there are other types of events related to subscriptions. Such as customer.subscription.updated and customer.subscription.deleted.
cunning oxide
User opt on Dec1 2021 and will charge again on Jan1 2022
so i will be using invoice events to get the status?
mossy musk
The status of what?
cunning oxide
that amount is debited from customer account on jan 1 2022
customer subscription
every month i want to know the ststus of each subscription cycle so i will be using the invoice.paid and invoice.payment_succeeded
correct?
mossy musk
The invoice events can be used to find the status of the invoice, and the paid and payment_succeeded events will fire if the invoice is successfully paid. You don't need to listen to both event types though, only one of them should be enough.
cunning oxide
can we have voice call?
mossy musk
I'd also suggest you take some time to review how subscriptions and their underlying objects/flows work. Understanding the flow can help you understand what events you're listening for when:
https://stripe.com/docs/billing/subscriptions/overview
Sorry, we don't do calls here.
cunning oxide
I am using subscriptions so i will be using invoice events instead of subscription scheduling?
correct
?
mossy musk
yes
cunning oxide
mossy musk
Unless you're talking about listening to when a subscription is created/updated/deleted.
cunning oxide
On sep1 2022 we will use the payment_succeeded or invoice.paid status
mossy musk
invoice.paid and invoice.payment_succeeded are event types, not statuses
cunning oxide
yes
invoice.paid and invoice.payment_succeeded so we will using these event types
correct?
on sep1 2022
mossy musk
On Sep 1st 2022, if the payment is successful, yes you will want to listen to invoice.paid
Also
we have a nice beta for testing this more easily, let me find that link for you
cunning oxide
invoice.payment_succeeded
invoice.paid
which one to use on sept 1 2022?
mossy musk
I also want to reiterate my suggestion to look into this doc of common webhook uses, as the scenario you're asking about is explained there:
https://stripe.com/docs/billing/subscriptions/webhooks#tracking
mossy musk
invoice.payment_succeeded
invoice.paid
which one to use on sept 1 2022?
That depends on whether you're going to be marking invoices as "paid out of band". Based on our convo so far it doesn't sound like you will be, so either event will work for your scenario. The nuanced difference between the two is explained in their definitions in our api spec:
https://stripe.com/docs/api/events/types#event_types-invoice.payment_succeeded
https://stripe.com/docs/api/events/types#event_types-invoice.paid