How does this skill help with payment processing?

It provides patterns to ensure that if a network failure occurs after a payment is authorized but before the client receives a response, a retry will return the existing authorization rather than creating a second charge.

Does this skill cover database-level deduplication?

Yes, it includes strategies for using unique database constraints and 'ON CONFLICT' clauses to ensure data integrity at the persistence layer even when application logic retries.

Which HTTP methods are idempotent by default?

GET, HEAD, OPTIONS, PUT, and DELETE are considered idempotent according to HTTP specifications, meaning multiple identical requests should have the same effect as a single request.

What is an idempotency key?

An idempotency key is a unique value generated by the client and sent with a request. The server uses this key to recognize subsequent retries of the same operation, ensuring it only processes the logic once while returning the same response.

Idempotency Design Patterns

Name: Idempotency Design Patterns
Author: melodic-software

bymelodic-software

•

API 개발

Provides expert architectural patterns for designing idempotent APIs and systems that handle retries safely without duplicate side effects.

This skill equips Claude with comprehensive strategies for building resilient distributed systems where operations must be executed safely across unreliable networks. It covers the implementation of idempotency keys, request fingerprinting, and database-level deduplication, ensuring that retries don't lead to double charges, duplicate orders, or data corruption. Whether you are architecting payment gateways, message queues, or RESTful APIs, this skill provides the implementation patterns needed to achieve reliable at-most-once and exactly-once processing semantics.

주요 기능

01Deduplication strategies using Redis stores, database constraints, and optimistic locking

02Architectural guidance on handling in-flight requests and concurrent race conditions

03Implementation of Idempotency Key patterns and request fingerprinting techniques

04Domain-specific patterns for payments, order management, and event-sourced systems

0512 GitHub stars

06Safe retry logic for non-idempotent HTTP methods like POST and PATCH

사용 사례

01Building payment processing systems that prevent double-charging customers during network timeouts

02Refactoring legacy REST APIs to support robust client-side retry mechanisms

03Designing microservices that require exactly-once message processing and delivery

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins idempotency-patterns

For use in Claude.ai and ChatGPT

Download Skill