For Stripe, reusing an idempotency key with a different amount is not a valid retry: the changed parameters do not match the original request, so Stripe documents that it returns an idempotency error. The key is meant to retry the same logical operation, not submit a modified one. Other payment APIs may handle mismatches differently, so check the specific provider and endpoint.
What an idempotency key does
An idempotency key lets an API recognize retries of the same request. If a client times out or loses the response, it can resend the unchanged logical request with the same key rather than risk creating a duplicate operation. The key does not authorize changing the original request while treating it as a retry.
As an Amazon Associate I earn from qualifying purchases.
Providers differ in how they validate, store, and replay requests. A “same response” is not a universal guarantee: it depends on the provider’s rules and whether the first request reached the point where its result is recorded.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Fix the driver behind crashes, sound loss and screen glitches3Repair Windows errors before they cause bigger problemsWhat Stripe does when the amount changes
Stripe compares the parameters of a subsequent request with those of the original request associated with the key. Reusing the key with a changed amount creates a parameter mismatch, and Stripe documents an idempotency error for a request that does not match the first request’s endpoint and parameters. See Stripe’s idempotent requests documentation and its error code reference.
#1 Best Overall
- With Square Terminal, you can ring up sales, accept payments, and print receipts, all with one device. Use it at the counter or ring up customers anywhere in your store.
- Accept all major credit and debit cards and pay one low rate with no hidden fees and no long-term contracts.
- Process chip cards in just two seconds.
- Get your money as soon as the next business day.
- Use it cordlessly with the built-in battery, designed to last all day.
For matching requests, Stripe saves and returns the first status code and response body after endpoint execution begins. This means the replay can be the original result, including an error; it does not mean the operation is guaranteed to have succeeded. Validation failures before execution and certain concurrent conflicts are not saved as idempotent results.
How the documented behavior differs by provider
The following comparison is limited to the cited API documentation; it should not be read as a rule for every endpoint offered by each provider.
Rank #2
- Use the, easy-to-use, and customizable POS to get started.
- Accept contactless payments, chip cards, Apple Pay, and Google Pay from anywhere, with improved connectivity, extended battery life, and enhanced security. Pay one low rate for every tap or dip.
- No long-term commitments or contracts, no monthly fees- and with offline payments, keep taking payments for up to 24 hours.
- Safely and securely accepts payments anywhere. Plus, get data security, 24/7 fraud prevention, and payment-dispute management at no extra cost.
- Use the, easy-to-use, and customizable POS to get started.
| Provider | Retry and mismatch behavior | Scope and retention limits |
|---|---|---|
| Stripe | Replays the first status and body for a recorded request. A later request with different parameters errors. | Keys may be pruned once they are at least 24 hours old. Results are saved only after endpoint execution begins; pre-execution validation failures and certain concurrent conflicts are not saved. Stripe documentation; Stripe error reference. |
| Adyen | If a request was already processed, retrying with the same key returns the first response without duplicating the action. The cited guidance does not establish a universal changed-amount response for all cases. | Applies to POST requests; keys are scoped to the company account and valid for 7 to 14 days. Concurrent calls can return a transient error or an in-progress/processed conflict, for which the documented error handling applies. Adyen API idempotency documentation. |
| PayPal | For supported REST calls, reusing the same PayPal-Request-Id returns the original result while the ID is stored. The cited documentation does not establish a universal changed-amount response for every endpoint. | The ID is stored for up to 45 days, and support must be checked for the specific API call. PayPal idempotency documentation; PayPal API request guidance. |
What to do when the amount changes
- For a retry after an uncertain outcome, resend the same logical request with the original key and unchanged parameters, subject to that provider’s endpoint rules.
- For a genuinely new payment or a changed amount, create a new logical request and use a fresh idempotency key. Do not reuse the old key to try to turn the original operation into a different one.
- If you do not know whether the first request completed, consult the provider’s response and error handling for that endpoint before deciding whether to retry. Concurrent requests and failures before a result is recorded may be treated differently from a completed request.
- Check retention and endpoint support, because an old key may no longer identify the original request, and not every API call necessarily supports idempotency in the same way.
Why a replay may not look like success
Idempotency prevents duplicate execution under the provider’s documented conditions; it does not promise a successful payment. A replay can return the first request’s stored failure. Nor should a client assume every failed or simultaneous attempt was stored: Stripe distinguishes results saved after execution starts from validation failures and certain concurrent conflicts, while Adyen documents special handling for concurrent requests.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Retention is provider-specific. Stripe says keys may be removed after they are at least 24 hours old; Adyen documents a validity period of 7 to 14 days; PayPal says it stores request IDs for up to 45 days. These are different providers’ documented limits, not interchangeable defaults.
Quick Recap
Best Value
- A complete countertop point of sale — Combine dual responsive touchscreens, built-in POS software, and durable hardware for a fast, reliable checkout experience.
- Serve customers faster — Run smoothly through busy shifts, complex menus, and big orders with high-speed processing, memory, and responsive touchscreen displays.
- Accept every way they pay — Take all major cards at one simple rate, with no hidden fees or long-term contracts. Receive funds as soon as the next business day.
- Handle real-world demands — Resist everyday spills, dust, and wear with a durable, IP54-rated design.
- Stay reliable through every rush — Maintain strong connectivity and consistent performance through your busiest hours.
Rank #4
- The Clover Compact and Clover Mini /Station sync with each other through the Clover Dashboard and cloud-based network. This allows you to manage transactions, track sales, and access business data across both devices seamlessly. Plug in, not battery/mobile. Requires New Processing account through Powering POS. (US, PR, USVI). CANNOT be used with a different Processor. Rate match guarantee. Contact us for questions
Rank #3
- With Square Handheld, you can accept payments, take tableside orders, or scan barcodes anywhere. With a slim design and comfortable grip, the POS is easy to carry in your palm or pocket. Square Handheld is designed to withstand water splashes and dust. Add an optional protective case for accidental drops. A long-lasting battery and offline payments let you keep selling.
- Slim, pocketable, and lightweight so you can accept payments wherever your customers are.
- Take tableside orders, bust lines, or use the built-in barcode scanner, all with one sleek device.
- A battery that can power through your shift and offline payments let you keep selling, even if your internet is down.
- Accept all major credit and debit cards and pay one simple rate with no hidden fees and no long-term contracts required.
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
