platform-guideline checked

Stripe API Reference: Idempotent requests

Documents idempotency keys for safely retrying create and update requests without performing the same operation twice.

Open source

Pattern Decisions This Source Supports

Pattern Supported decision Required contract Claim note
Checkout Choose checkout when the primary task is completing a purchase or order from selected items or priced services. Changing quantity, address, delivery method, discount, or payment route updates the order summary and total before commit. Stripe supports idempotency for duplicate-safe payment and order-like request retries.
Payment collection Choose payment collection when the main task is taking or reconciling money for a known amount and reference. Every payment attempt is tied to a stable service reference, amount, currency, and payer context that remains visible before and after provider handoff. Stripe supports idempotency keys to avoid duplicate effects during payment retries.
Regenerate / retry Choose regenerate / retry when the task is rerunning an AI response attempt, creating a new answer version, continuing a failed generation, or recovering from failed AI source or tool work. Retry same prompt repeats the submitted prompt and visible context unless the UI explicitly shows which context changed. Supports idempotency concerns when retries can repeat side-effecting tool calls.
Retry Choose retry when a specific failed operation can plausibly succeed if attempted again under the same scope. Retry repeats the same failed operation against the same request scope unless users explicitly edit that scope first. Stripe documents idempotency keys for safely repeating create and update requests without duplicate operations.

Evidence Role

This source is treated as platform-guideline evidence. Use it to validate the decision rules above, not as a visual style reference.

Publisher: Stripe. Last checked: .