#JCoDog-SubscriptionWebhooks
civic cargo
See https://stripe.com/docs/billing/subscriptions/webhooks for the list of situations to handle
(plus the links at the bottom of that article)
digital light
I have my stripe setup to send the customer emails, so do I need to also send them?
civic cargo
Do you mean Stripe is sending the emails, or you have set it up that you manually send your own custom ones?
digital light
stripe is sending I think. I set it up
civic cargo
https://stripe.com/docs/receipts#receipts-with-billing details what we send for Subscriptions then
digital light
Does stripe send anything about the upcoming payment?
civic cargo
That's one of the options on https://dashboard.stripe.com/settings/billing/automatic (take a look at that page to see what we can send)
civic cargo
It should
digital light
Can I send data into the subscription via meta to link it to specific things in my database?
civic cargo
Sure, metadata is perfect for that.
digital light
So in the create-checkout-session I would just add "meta" => "value" right?
civic cargo
https://stripe.com/docs/api/metadata has the details and you'd use the field in https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-subscription_data-metadata which sets it on the Subscription (instead of the CheckoutSession itself)
digital light
Ok. What is create-portal-session doing?
civic cargo
Can you elaborate? Not sure what you mean by create-portal-session
civic cargo
Ah, that's the BillingPortal (which is different from a CheckoutSession). https://stripe.com/docs/billing/subscriptions/customer-portal
digital light
Ok so other than the method it shows, can I call the portal using a customer ID?
linked via the meta, or do I need to save the checkout session ID?
civic cargo
If and when you want to send them to the BillingPortal, you use the Customer's id, yes.
digital light
So when the subsctiption is made, I can use the webhook to save their customer ID?
I also dont see anywhere with my lookup ID for the subscription I made
civic cargo
The webhook events will have the Subscription details, yes. The subscription will have a customer field with the Customer id as well.
digital light
Ok and with the lookupID is that just product ID?
civic cargo
Where are you seeing lookupID?
digital light
civic cargo
Not 100% sure what that is but I'd guess it's passed for metadata.
digital light
No...
Its used to start the checkout
Sorry have to brb, but I cant find a lookup key
civic cargo
digital light
Ok how do I add a lookup key to a price or product to use that?
civic cargo
You'd update https://stripe.com/docs/api/prices/update#update_price-lookup_key on the Price
civic cargo
Not on the Dashboard, no. It's not exposed there.
digital light
ok... can I make the checkout show two prices the user selects there via a product lookup key instead?
or do I have to start checkout with the price id
civic cargo
You'd need to use the Price ids and pass them in https://stripe.com/docs/api/customer_portal/configurations/create#create_portal_configuration-features-subscription_update-products-prices
wait, no, that's the Billing Portal, misread your question
You can't offer a selection in Checkout, just a specific setup.
digital light
Ok thank you
Just reading about somethign i am setting up to get metadata to pass in
How do I update the price? I cant see where to do that...
civic cargo
There's only a small set of parameters you can update in https://stripe.com/docs/api/prices/update -- anything else you'd just create a new price
digital light
No I mean to make it show the lookup key. How do I update that? From command line?
civic cargo
When you say "update that" do you mean change what a given Price's lookup_key is set to be?
digital light
yes
civic cargo
and you're using stripe-cli right?
digital light
No I have a php website
Does it matter what I use to update it because I can use the CLI if it is easier
civic cargo
Oh no it doesn't matter, just making sure what you mean by using the CLI.
The POST request is https://stripe.com/docs/api/prices/update?lang=php#update_price-lookup_key (there's a cURL version in the examples as well if that's what you want)
digital light
I can install the stripe CLI
it might be easier as I dont want to mess with my site to update a price
civic cargo
Either way works.
civic cargo
The format for updating the lookup_key would be (filling in your own Price's id and desired lookup_key value):
stripe prices update price_abc123 -d lookup_key=testing_key
digital light
ok seems the \ confused me in the docs
Will checkout let me add multiple things to it for payment, or just one product?
Because I have a setup fee for the service and want to get the first payment of subscription with setup fee
Or is it not possible to do a subscription and a one time payment at the same time?
civic cargo
So for line_items (https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-line_items) you can pass any combination of recurring and one-time Prices. Checkout will know which is which and use the one-time ones as "just the first invoice" items alongside your recurring ones.
civic cargo
yes