momo_webhooks

[sweet pawn]

👋 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/1384083385403838566

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

[idle sail]

👋 happy to help

[golden bobcat]

hi

[idle sail]

we have introduced a breaking change in our API version basil https://docs.stripe.com/changelog/basil/2025-03-31/add-support-for-multiple-partial-payments-on-invoices to support multiple partial payments on invoices

you can now use the Invoice Payment endpoints to retrieve the invoice ID for a Charge or a PaymentIntent https://docs.stripe.com/changelog/basil/2025-03-31/add-support-for-multiple-partial-payments-on-invoices#use-the-new-for-payments-and-invoice-connection

[golden bobcat]

However, what we need is to retrieve the corresponding invoice ID or subscription ID using the payment_intent ID from the charge.refunded webhook, and this documentation does not meet our requirement.
Also, please confirm whether the refunded amount can be returned to the user's original payment method.

[idle sail]

However, what we need is to retrieve the corresponding invoice ID or subscription ID using the payment_intent ID from the charge.refunded webhook, and this documentation does not meet our requirement.
it does

did you read it?

Also, please confirm whether the refunded amount can be returned to the user's original payment method.
it can only be returned to the original payment method

[golden bobcat]

Yes, the List all payments for an invoice API requires an invoice_id to perform the query. However, the issue is that the charge.refunded webhook does not include the invoice_id, so we have no way to obtain that information and therefore cannot use this API.

[idle sail]

that's not the one I sent

did you read the code snippet?

the List all payments for an invoice API has many ways to be used

you can use the https://docs.stripe.com/api/invoice-payment/list#list_invoice_payments-payment to filter by payment_intent ID

and then you'll get the invoice ID

[golden bobcat]

ok，we will try

[golden bobcat]

So just to confirm:

Refunds in subscriptions will not be returned to the credit_balance by default, right?

For subscription-related refunds, the webhook event we need to monitor is charge.refunded, correct?

[idle sail]

Refunds in subscriptions will not be returned to the credit_balance by default, right?
not ever

For subscription-related refunds, the webhook event we need to monitor is charge.refunded, correct?
correct

[golden bobcat]

Can we monitor these webhooks for subscription payment events?

[idle sail]

yes

[golden bobcat]

Is there a better way for us to monitor subscription refund events that allows us to associate the refund details with the related subscription ID?

[idle sail]

no

[golden bobcat]

we can only try this way to associate the refund details with the related subscription?

[idle sail]

yes

[golden bobcat]

And I would like to know if the invoice.paid webhook includes the subscription ID associated with the invoice?

[idle sail]

yes

[golden bobcat]

but I did not find the corresponding subscription parameter information in the documentation.😭

[idle sail]

it's directly on the invoice

[golden bobcat]

https://docs.stripe.com/api/invoices/object?api-version=2025-03-31.basil
I did not find the corresponding subscription parameter information

[idle sail]

oh yes in basil you need to access it through https://docs.stripe.com/api/invoices/object?api-version=2025-05-28.basil#invoice_object-parent-subscription_details-subscription

[golden bobcat]

I’d like to confirm whether the same PaymentIntent ID could be associated with different Invoice IDs.

[shut moth]

Hey! Taking over for my colleague.

[golden bobcat]

hi

[shut moth]

I’d like to confirm whether the same PaymentIntent ID could be associated with different Invoice IDs.
No each PaymentIntent Id can be associcated with one single invoice

[golden bobcat]

ok,I will try,thank you

[golden bobcat]

Does this mean that one PaymentIntent ID corresponds to one Invoice ID?

[shut moth]

Not always, a PaymentIntent can be not ættached to an invoice

[vestal yacht]

hello! fyi i'm taking over this thread, let me know if there are any further questions

[golden bobcat]

However, what we need is to retrieve the corresponding invoice ID or subscription ID using the payment_intent ID from the charge.refunded webhook,

So in a subscription scenario, does one PaymentIntent ID correspond to one Invoice ID?

[vestal yacht]

in the current state yes, there would be a 1:1 relationship between PaymentIntents and Invoices (as long as the PaymentIntent came from an Invoice or a Subscription).

we're working towards adding support for multiple Invoice Payments per invoice, so in the future there might be multiple PaymentIntents per invoice, but there would still only be one Invoice per PaymentIntent

[golden bobcat]

In a subscription scenario, if we want to track the payment status of an order, should we monitor the invoice, the payment intent, or the charge?

[vestal yacht]

here's a guide that goes over some options for tracking subscriptions:
https://docs.stripe.com/billing/subscriptions/webhooks#active-subscriptions

the short answer is subscription status and invoice payment status are the two most relevant things to track

[golden bobcat]

Is it possible to include the associated invoice ID in the charge.refunded webhook? This would allow us to quickly identify which invoice the refund is related to in the case of a subscription refund.

[vestal yacht]

depends on which API version you're in - in all basil versions you need to use the list invoice payments API to retrieve it, but in acacia and prior versions the invoice is listed on the charge

[golden bobcat]

I’d like to understand in which specific subscription scenario this situation would occur?

[vestal yacht]

it's a pretty new feature so my team doesn't have a ton of detail on it, but it won't be the default behavior for subscriptions

this page has some details on it if you're curious, but i don't think it's relevant to your use case:
https://docs.stripe.com/invoicing/payment-plans