AIKraft/Skills/Идемпотентность платежей

Идемпотентность платежей

Apply when implementing idempotency logic in payment connector code or handling duplicate payment requests. Covers paymentId as idempotency key, payment state machine transitions, retry semantics for cancellation and refund operations, and requestId handling. Use for preventing duplicate charges and ensuring correct Gateway retry behavior across Create Payment, Cancel, Capture, and Refund endpoint

vtex official Разработка

Что делает навык

Применять при реализации логики идемпотентности в коде платёжного коннектора или обработке дублирующихся платёжных запросов. Охватывает paymentId в качестве ключа идемпотентности, переходы состояний платёжного state machine, семантику повторов для операций отмены и возврата, а также обработку requestId. Использовать для предотвращения повторных списаний и обеспечения корректного поведения Gateway при retry по эндпоинтам Create Payment, Cancel, Capture и Refund

Как подключить

1Скачать навык
# возьмите папку навыка «payment-idempotency» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r payment-idempotency/ ~/.claude/skills/payment-idempotency/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.