[Doc] Stripe Module Provider page should mention what webhook events are needed.

[SneakySensei]

What Medusa version and documentation are you using?

v2

Preliminary Checks

• This issue is not a duplicate. Before opening a new issue, please search existing issues: https://github.com/medusajs/medusa/issues

Issue Summary

https://docs.medusajs.com/resources/commerce-modules/payment/payment-provider/stripe
This page mentions that we need to create a webhook in Stripe dashboard but it doesn't mention which events are needed.

I had to look at the source to figure this out:

medusa/packages/modules/providers/payment-stripe/src/core/stripe-base.ts

Lines 329 to 360 in 7c773fc

	switch (event.type) {
	case "payment_intent.amount_capturable_updated":
	return {
	action: PaymentActions.AUTHORIZED,
	data: {
	session_id: intent.metadata.session_id,
	amount: getAmountFromSmallestUnit(
	intent.amount_capturable,
	currency
	), // NOTE: revisit when implementing multicapture
	},
	}
	case "payment_intent.succeeded":
	return {
	action: PaymentActions.SUCCESSFUL,
	data: {
	session_id: intent.metadata.session_id,
	amount: getAmountFromSmallestUnit(intent.amount_received, currency),
	},
	}
	case "payment_intent.payment_failed":
	return {
	action: PaymentActions.FAILED,
	data: {
	session_id: intent.metadata.session_id,
	amount: getAmountFromSmallestUnit(intent.amount, currency),
	},
	}
	default:
	return { action: PaymentActions.NOT_SUPPORTED }
	}
	}

Events that Medusajs depends upon are:

1. payment_intent.amount_capturable_updated
2. payment_intent.succeeded
3. payment_intent.payment_failed

How can this issue be resolved?

Add the required event types to the doc.

Are you interested in working on this issue?

• I would like to fix this issue