jojilede | Stripe Developers | Page 1

warm acornBOT Jan 9, 2023, 3:31 PM

#

arctic hare Jan 9, 2023, 3:32 PM

#

Hello 👋
Unless you set the PaymentMethod as a default payment method on customer (customer.invoice_settings.default_payment_method), no that payment method will not get automatically charged.

vestal blaze Jan 9, 2023, 3:36 PM

#

I see. Will it work if they checkout as guest?

arctic hare Jan 9, 2023, 3:39 PM

#

No it will not unfortunately.

vestal blaze Jan 9, 2023, 3:41 PM

#

I see, what about a subscription checkout?

arctic hare Jan 9, 2023, 3:42 PM

#

That should work I believe

vestal blaze Jan 9, 2023, 3:46 PM

#

Thanks! just to clarify for the subscriptionSchedule to work we need to set the customer.invoice_settings.default_payment_method set so they will be charged and that is on top of when we create them a stripe account?

arctic hare Jan 9, 2023, 3:53 PM

#

not sure what you mean by

that is on top of when we create them a stripe account?

vestal blaze Jan 9, 2023, 3:53 PM

#

sorry

arctic hare Jan 9, 2023, 3:53 PM

#

but yes, in order for a subscription schedule to charge the payment method it needs to be set as default

vestal blaze Jan 9, 2023, 3:54 PM

#

stripe customer

#

so before a checkout we need to create a stripe customer for them and make that payment a default to charge them the subscriptionSchedule?

arctic hare Jan 9, 2023, 3:57 PM

#

Yup

#

Let me see if we have any docs on this

#

This should help you create a subscription
https://stripe.com/docs/billing/subscriptions/build-subscriptions

and then you can add a schedule to the existing subscription
https://stripe.com/docs/billing/subscriptions/subscription-schedules/use-cases#existing-subscription

vestal blaze Jan 9, 2023, 3:58 PM

#

gotcha

#

what is the subscription here? is it the same as the stripe.checkout.sessions.create where mode is subscription?

arctic hare Jan 9, 2023, 4:04 PM

#

yes

vestal blaze Jan 9, 2023, 4:11 PM

#

if they checkout using that method can we add subscriptionSchedule to that to delay the next payment?

arctic hare Jan 9, 2023, 4:12 PM

#

Let's take a step back
What is your end goal? I understand you want to build a subscription integration. Can you expand a bit more on your usecase and explain why you need to use SubscriptionSchedule?

vestal blaze Jan 9, 2023, 4:12 PM

#

sure.

#

We are a property rental app that offers long term rental, we want to charge the customer the initial monthly payment when they book a property, scenario:

Date of Booking: Jan 10, 2023
Check-in: Feb 1 , 2023
Check-out: April 30, 2023
Monthly Rate: 1000 USD

We want to charge the renter on Jan 10 and that represents the payment for feb 1-28, so the next phase of payment to be charged will be on March 1, 2023 and April 1, 2023.

arctic hare Jan 9, 2023, 4:19 PM

#

Ah okay I see.

#

thinking.. It might not fit in with subscription models that we support by default
https://stripe.com/docs/billing/subscriptions/designing-integration#subscription-models

If this is only one-time then instead of using SubscriptionSchedule you could,
1/ Collect one-time charge on Jan 10. 2023 for the $xxxx amount
2/ Start a subscription with trial (from Jan 10th to March 1)
https://stripe.com/docs/billing/subscriptions/designing-integration#subscription-models
3/ When the trial expires, the next month's amount would be charged

#

In above, you don't really need to use a subscription schedule

vestal blaze Jan 9, 2023, 4:24 PM

#

then can the customer be a guest if I use that? so they wont know about the trial process?

#

and can it be done in just 1 session?

arctic hare Jan 9, 2023, 4:25 PM

#

Unfortunately, for subscriptions a customer is required.

vestal blaze Jan 9, 2023, 4:26 PM

#

it's ok

#

can it be done in just 1 session?

#

like they can only checkout once?

arctic hare Jan 9, 2023, 4:27 PM

#

Yes

#

You can specify trial information when you create a checkout session by setting
https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-subscription_data-trial_end OR
https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-subscription_data-trial_period_days

vestal blaze Jan 9, 2023, 4:28 PM

#

I see:

 const session = await stripe.checkout.sessions.create({
        line_items: [
          {
            price: 'price_1MMwbTDTISXyBnp6h3pajLFc',//req.body.init_price_id,
            quantity: 1,
          },
        ],
        mode: 'payment',
        success_url: `${req.headers.origin}/?success=true`,
        cancel_url: `${req.headers.origin}/?canceled=true`,
        automatic_tax: {enabled: true},
        metadata: {
          price_id: 'price_1MMwbTDTISXyBnp6jxGjMEQt'
        },
        payment_method_types: ['card', ],
      });

#

that is how my current checkout lookslike

#

so my code will look like this now right:

const initialPaymentsession = await stripe.checkout.sessions.create({
  line_items: [
    {
      price: 'price_1MMwbTDTISXyBnp6h3pajLFc',//req.body.init_price_id,
      quantity: 1,
    },
  ],
  mode: 'payment',
  automatic_tax: {enabled: true},
  metadata: {
    subscription_price_id: 'price_1MMwbTDTISXyBnp6jxGjMEQt'
  },
  payment_method_types: ['card', ],
});

const subscriptionSession = await stripe.checkout.sessions.create({
  line_items: [
    {
      price: 'price_1MMwbTDTISXyBnp6h3pajLFc',//req.body.init_price_id,
      quantity: 1,
    },
  ],
  mode: 'subscription',
  success_url: `${req.headers.origin}/?success=true`,
  cancel_url: `${req.headers.origin}/?canceled=true`,
  automatic_tax: {enabled: true},
  metadata: {
    subscription_price_id: 'price_1MMwbTDTISXyBnp6jxGjMEQt'
  },
  payment_method_types: ['card', ],
  subscription_data: {
    trial_end: '0000'//Feb 28, 2023
  }
});

#

is that correct? 😓

arctic hare Jan 9, 2023, 4:33 PM

#

mode is still payment

#

and why do you have two sessions?

vestal blaze Jan 9, 2023, 4:34 PM

#

sorry give me 30s to clenaup

vestal blaze Jan 9, 2023, 4:35 PM

#

arctic hare and why do you have two sessions?

because I am charging 1 time and subscription? Sorry I got lost.

arctic hare Jan 9, 2023, 4:37 PM

#

👍 trial_end timestamp needs an actual value
You can use trial_period_days instead. It would be easier to specify total days compared to calculating a timestamp

vestal blaze Jan 9, 2023, 4:40 PM

#

ah I see!

#

and how many sessions should I create?

arctic hare Jan 9, 2023, 4:42 PM

#

that depends on your usecase. I'm not sure I clearly understand your integration yet 😅 Specifically the part about "guest" customer and one-time payments

vestal blaze Jan 9, 2023, 4:42 PM

#

ah

#

the one time payment is the payment on the booking date.

#

the problem with the trial is we can't charge the customer upfront 😄

arctic hare Jan 9, 2023, 4:43 PM

#

ah gotcha. In that case, you can add that price as a line item when creating a checkout session for a subscription too

vestal blaze Jan 9, 2023, 4:45 PM

#

I see, I'm sorry to ask this , may I know from you how will that code above should look like?

arctic hare Jan 9, 2023, 4:46 PM

#

modify Checkout Session creation for a subscription to:

    {
      price: 'price_1MMwbTDTISXyBnp6h3pajLFc',//req.body.init_price_id,
      quantity: 1,
    },
    {
      price: ONE-TIME-PRICE-ID-HERE,
      quantity: 1
    }  
  ],```

vestal blaze Jan 9, 2023, 4:46 PM

#

and the mode is ?

arctic hare Jan 9, 2023, 4:47 PM

#

subscription

vestal blaze Jan 9, 2023, 4:58 PM

#

i see 😄

vestal blaze Jan 9, 2023, 5:53 PM

#

Hi sorry

#

one more, how will the second one not be charged again next billing cycle?

rare parrot Jan 9, 2023, 5:54 PM

#

Hi 👋

#

Yes that is how the API was designed to handle both scenarios. If the second price is not a recurring price, it will only be charged the first time

vestal blaze Jan 9, 2023, 5:55 PM

#

Thank you! 😄 will it also charge the one time even if there is a trial?

#

The answer to my dumb question is yes I just tried it LOL

rare parrot Jan 9, 2023, 6:00 PM

#

Yeah we make our Test mode pretty robust so developers can answer their own questions pretty easy 😁

It helps build confidence in your integration that you can just try all of this stuff with your own code

vestal blaze Jan 9, 2023, 6:02 PM

#

thank you so much. Can I ask one more question? how do I test the subscription cycle? like can I jump to a specific date in stripe dashboard?

#

I just found it on the subscription, the 'Simulation clock'

#

haha

rare parrot Jan 9, 2023, 6:05 PM

#

For that you would use a Test Clock to allow you to advance time

#

Bingo

vestal blaze Jan 9, 2023, 6:05 PM

#

yeah this is really so cool.

#

thank you , I think I can move on from here!

#jojilede