diff --git a/docs/integrations/stripe.mdx b/docs/integrations/stripe.mdx index 11411ec2..f40bf878 100644 --- a/docs/integrations/stripe.mdx +++ b/docs/integrations/stripe.mdx @@ -448,6 +448,24 @@ To differentiate between [manually tracked lead events](/docs/quickstart/server# +## First-time order restriction + +By default, discount codes created via Dub are restricted to [first-time orders](https://docs.stripe.com/payments/advanced/discounts#limit-by-first-time-order) in Stripe. That means the code can only be redeemed by customers who have never made a purchase (Stripe treats any successful payment or paid invoice as a prior purchase). + +If your signup flow creates a trial subscription or a $0 invoice, Stripe may classify those customers as returning purchasers and reject the code. In that case, go to your Stripe integration settings and disable **Eligible for first-time order only**: + + + The Stripe integration settings page + + + + Changes will only take effect for future discount codes. Existing promotion + codes keep the restriction they were created with. + + ## Tax handling When tracking sale conversions from Stripe, Dub automatically excludes taxes from the final sale amount to ensure accurate revenue reporting. diff --git a/images/stripe/stripe-integration-settings-first-time.png b/images/stripe/stripe-integration-settings-first-time.png new file mode 100644 index 00000000..2a165eea Binary files /dev/null and b/images/stripe/stripe-integration-settings-first-time.png differ