duplicate_transactionAn identical payment was just made

Stripe's duplicate_transaction decline means a payment with the same amount and card was submitted very recently. Check for it before you retry.

Next step
Check your own setup
Hard decline
Not on Stripe's list
Share the reason
Yes

What does duplicate_transaction mean?

A payment with the same amount and card details was submitted very recently.

What Stripe says to do

Check whether a recent payment already exists.

What to tell the customer

Check Stripe first. If the earlier payment succeeded, tell the customer they've already paid.

Example wording
It looks like this payment was already made a moment ago. We're checking and will confirm shortly.

Should you retry duplicate_transaction?

Only after you confirm the earlier payment didn't go through. It isn't on Stripe's hard decline list, so Stripe Billing retries follow your Smart Retries or custom schedule.

Before any retry, check the charge's outcome.advice_code. try_again_later means the issuer allows a retry, do_not_try_again means don't use the card again for this transaction, and confirm_card_data means some card details need checking.

Where duplicate_transaction shows up

On a failed PaymentIntent, read last_payment_error.decline_code. On the Charge, the same code is in outcome.reason. Card declines usually come with the error code card_declined and the reason in decline_code.

With local payment methods

Stripe also returns duplicate_transaction for local payment methods, with the Charge's outcome.reason set to partner_duplicate_transaction. Stripe's message: "A payment with identical details was submitted recently."

Get failed payments in Slack

ChargeBell posts a Slack alert when a Stripe payment fails, with the amount, the customer, and Stripe's decline message. Open the payment from the alert to see its decline code, such as duplicate_transaction, and follow up from there.

Related decline codes

All Stripe decline codes