romerocox-Subscription

[narrow frigate]

Hello! I think you're looking for invoice.upcoming: https://stripe.com/docs/api/events/types#event_types-invoice.upcoming

But it could also be the trial will end, depending on what you mean by "expiring".

[errant sapphire]

I'm monitoring the trial_end, so I wanted to be notified when the subscription is 3 days from ending

[sturdy forge]

Hi @errant sapphire then you can listen to customer.subscription.trial_will_end https://stripe.com/docs/api/events/types#event_types-customer.subscription.trial_will_end

[errant sapphire]

I saw that the subscription_schedule.expiring will be triggered 7 days away, right?

Perfect!

that is exactly what I was looking for! Thank you!

Guys, if the trial ends is there another event triggered?

[sturdy forge]

You will receive a customer.subscription.updated event. The easiest way to try it out yourself is to using the test clocks https://stripe.com/docs/billing/testing/test-clocks

[errant sapphire]

Yeah, I'm working on that, the only thing is that I'd love to differentiate a trial_end from a "paid" subscription that wasn't renewed

One other question, I noticed that I can send the payment link once the trial has ended, is it possible to get that link from the trigger event and send it using my own method?

[sturdy forge]

What do you mean by trial_end from a paid subscription? Your customer doesn't need to pay if the subscription is in trial.

By payment link do you mean invoice?

[errant sapphire]

Yes, sorry!

lets tackle one at a time 😄 my bad

[sturdy forge]

No apologies needed 🙂

[errant sapphire]

How should I approach this? Is it possible to get that invoice link and send it to the Customer using my own method?

[sturdy forge]

You can listen to invoice.finalized event (https://stripe.com/docs/api/events/types#event_types-invoice.finalized) and get the URL from the hosted_invoice_url property https://stripe.com/docs/api/invoices/object#invoice_object-hosted_invoice_url

[errant sapphire]

and by using the customer_id I should be able to match them right?

every time a trial_ends, will this invoice be created?

[sturdy forge]

Yes you can check the invoice's customer to know which customer is this invoice issued to

[errant sapphire]

great

after X days if the invoice is not paid, then the subscription gets an update as well, right?

[sturdy forge]

Yes, and based on the settings (https://stripe.com/docs/billing/subscriptions/overview#settings) subscription's status will be canceled, unpaid or past_due .

[errant sapphire]

great, thanks!

how do I create a subscription with "send invoice after trial" instead of charge default payment ?

This is my sub creation:

            'customer' => $customer_id,
            'items' => [[
                'price' => $price_id,
            ]],
            'payment_behavior' => 'default_incomplete',
            'payment_settings' => ['save_default_payment_method' => 'on_subscription', 'payment_method_types'=>['card']],
            'expand' => ['pending_setup_intent'],
            "metadata" => ["cliente_id" => $membro->memberID],
            "trial_end"=> $unix
            
        ]);```

[sturdy forge]

Set the subscription's collection_method to send_invoice

[errant sapphire]

What about the payment methods? Would the payment method type do the trick for that too? Or do I need an extra parameter?

[sturdy forge]

You can set the payment_method_types if you want your customer to use a specific set of payment methods. But I'd suggest you to leave this param and use the invoice settings instead https://dashboard.stripe.com/settings/billing/invoice

[errant sapphire]

Thanks

[errant sapphire]

is it possible to get the previous status of a sub before an update?

[sturdy forge]

If you are listening to webhook events, you can get the previous attributes of the event object.

[errant sapphire]

I'm listening to the invoice.created but it seems like as soon as the invoice is created, it automatically updates the sub to active until the past_due date

Yeah, even before creating the invoice, the subscription is being updated to active

Not sure if this is only because I'm using the test clock

or if this is a default behavior and can be changed somewhere

[sturdy forge]

Did you set the collection_method to send_invoice ?

[errant sapphire]

Yes

Oh, it should be the default_incomplete parameter?

'payment_behavior' => 'default_incomplete',

Or this has nothing to do?

I'm still using this, not sure if I should remove it, or if it wouldn't make any difference.

[sturdy forge]

Use default_incomplete to create Subscriptions with status=incomplete when the first invoice requires payment, otherwise start as active.

[errant sapphire]

ok, what is happening here is the following:

[sturdy forge]

Details is here https://stripe.com/docs/api/subscriptions/create#create_subscription-payment_behavior

[errant sapphire]

The subscription gets created the way I want, no problem there.

When the trial ends, Stripe creates an invoice, and automatically updates the sub to active.
Then, Stripe waits for the amount of days I've chosen by default.

Because of this behavior, I cannot identify if the invoice was created for a subscription that was on trial or not.

Let me know if you understood my scenario please

As soon as the trial_ends the subscription becomes active.

I think that is whats happening