yookassa

name	yookassa
description	[RU: интеграция ЮKassa] YooKassa by ЮMoney — API v3, Checkout.js widget, payment lifecycle (pending→waiting_for_capture→succeeded), Idempotence-Key, webhook IP-allowlist + payment re-fetch, saved methods, 54-ФЗ receipt. Use when: yookassa, юкасса, @a2seven/yoo-checkout, /v3/payments, /v3/refunds, /v3/payment_methods, /v3/receipts, Idempotence-Key, save_payment_method, payment_method_id, vat_code, payment_subject, СБП, SberPay. SKIP: CloudPayments/Tinkoff/Stripe/Robokassa (use respective skill); YooMoney P2P (→yoomoney); bank-direct СБП (→sbp).
stacks	["yookassa","russian-payments","nodejs","typescript"]
packages	["@a2seven/yoo-checkout","@appigram/yookassa-node"]
tags	["payments","russian-payments","yookassa","yoomoney","54-fz","fiscalization","subscriptions","sbp","webhook","idempotence"]
manifests	["package.json"]
source	vechkasov-global-skills
risk	high-stakes

🎯 Version Requirements (May 2026)

Primary pins:

• Node.js: 24.x (Active LTS)
• TypeScript: 6.0.x

Source of truth: STACK_VERSIONS.md — verified 2026-05-16

Usage

Loaded automatically when its description matches the active task. Read only the section you need, then follow the link to the relevant reference file for full detail.

Use this skill when

• Building a YooKassa / ЮKassa checkout — embedding Checkout.js widget or calling REST v3 directly
• Creating a payment with POST /v3/payments — passing Idempotence-Key, confirmation, amount, receipt, metadata
• Implementing two-stage payments (capture: false → POST /v3/payments/{id}/capture) for marketplaces / pre-orders
• Setting up webhooks for payment.succeeded, payment.canceled, payment.waiting_for_capture, refund.succeeded
• Verifying webhook authenticity via IP allowlist + re-fetching the payment by ID (GET /v3/payments/{id})
• Saving a payment method for one-click rebill (save_payment_method: true → payment_method.id → reuse via payment_method_id)
• Building recurring subscriptions on top of saved payment methods (no built-in subscription API — merchant orchestrates schedule)
• Building 54-ФЗ fiscal receipts using YooKassa's receipt object (vat_code, payment_subject, payment_mode, tax_system_code)
• Handling Russian payment methods: bank_card, sbp, sberbank, tinkoff_bank, yoo_money, mobile_balance, cash, sber_loan
• Issuing refunds via POST /v3/refunds with attached receipt for 54-ФЗ
• Working with @a2seven/yoo-checkout SDK (YooCheckout class) or constructing raw HTTPS calls