altairsama2_best-practices

[rare lake]

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1295946814104666176

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

[past slate]

checkout session's payment status did not indicate whether the client paid successfully

but rather were the funds available in my account

in this case, is it recommended to actually look for the paymentintent status instead?

our usecase will be cards only for the forseeable future

also, for card declines on client's end, should we look for payment_intent webhooks for checkout? and we are ad-hoc invoicing our clients with auto pay, in this case also, will invoice's payment_failed and payment_succeeded events suffice for us, keeping in mind, we will only be doing cards only for now

[next bison]

Hi! For Checkout you can look at payment_status to check if the payment is successful [0]. Basically, funds available in my account == payment suceeds. You can also listen to payment_intent.succeeded or charge.succeeded events.

[0] https://docs.stripe.com/checkout/fulfillment#create-fulfillment-function

also, for card declines on client's end, should we look for payment_intent webhooks for checkout? and we are ad-hoc invoicing our clients with auto pay, in this case also, will invoice's payment_failed and payment_succeeded events suffice for us, keeping in mind, we will only be doing cards only for now
Regarding above, are you invoicing your customers via Checkout sessions or creating an Invoice via the Dashboard / API?

[past slate]

hey, we are creating invoices via api only

[past slate]

this is applicable for cards only right? which is a synchronous payment method

and we dont need to take care of the nuance in this one? the documentation wording was a little specific, so I thought there would be a difference between funds available in my account vs payment succeeding, assuming stripe places some kind of hold on the funds before releasing them to my account

[next bison]

this is applicable for cards only right? which is a synchronous payment method
payment_status also works for asynchronous payment methods. Additionally, you can also listen for checkout.session.async_payment_succeeded

[past slate]

ah, so its just documentation issue and there's no nuance? appreciate it, thanks, I assumed async events were for something like ach debit, where payment reconciliation takes time'

[next bison]

hey, we are creating invoices via api only
invoice.payment_failed and invoice.paid are sufficient if your are only interested in invoice payment results. Similarly here, you can also listen to payment_intent.succeeded, which will be fired when an invoice payment succeeds.

[past slate]

ah, that simplifies a lot of things, thanks

[next bison]

ah, so its just documentation issue and there's no nuance? appreciate it, thanks, I assumed async events were for something like ach debit, where payment reconciliation takes time'
Could you point out which nuance you are referring to and I can help to elaborate further?

[past slate]

this is what I was talking about in the above ss, The payment funds are not yet available in your account. this is under unpaid for payment_status for a checkout session

the documentation was really specific here about funds not yet available in the account vs customer couldnt pay for x reason and payment failed

[next bison]

Got it! So unpaid basically indicates that the payment is not yet successful. It will only transition to paid once the payment is successful. This could be immediately for synchronous payment method (e.g. card) or a little later for asynchronous payment method (e.g. ACH)

[past slate]

ah, and if we want to listen for specifically, if the payment itself failed, then payment intent is the way to go?

[next bison]

Yes!

[past slate]

for e.g. card got declined

thanks! really appreciate the help here!

[next bison]

Happy to help!