Process YooKassa Payments and Refunds
Documentation-only Claude Code skill for YooKassa - REST API v3 reference, TypeScript examples, and 54-FZ fiscalization rules.
Why it matters
Automate financial transactions by integrating with the YooKassa API. This asset handles payments, refunds, and compliance with 54-FZ receipt requirements.
Outcomes
What it gets done
Process customer payments via YooKassa.
Initiate and manage refunds for transactions.
Generate compliant receipts for all transactions.
Handle webhook notifications for payment status updates.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/yookassa | bash Overview
YooKassa Payments
Documentation-only skill that equips Claude Code with the YooKassa REST API v3 reference, TypeScript SDK examples, and guidance on payment flows, webhooks, and Russian 54-FZ fiscalization requirements. Use it when integrating a Russian payment flow with YooKassa - one-stage or two-stage payments, refunds, webhook handling, or receipt fiscalization under 54-FZ.
What it does
The Yookassa skill is a documentation-only reference for integrating with YooKassa, a Russian payment gateway. It bundles a complete API reference for the YooKassa REST API v3, TypeScript examples built on the official @a2seven/yoo-checkout SDK, and structured guidance covering payment flow patterns (one-stage, two-stage, and refunds), webhook handling and security, Russian fiscalization requirements under 54-FZ, and error-handling/retry strategies.
When to use - and when NOT to
Use it whenever a task involves accepting or refunding payments through YooKassa: choosing between one-stage and two-stage (hold-then-capture) payment flows, building or securing a webhook endpoint, generating fiscal receipts that comply with 54-FZ, or handling API errors and retries correctly. It's also useful simply as a fast local reference the agent can search instead of re-reading YooKassa's own docs site each time. It is documentation only - it does not ship a payment backend or handle credentials for you, so any live integration still needs the shop's own YOOKASSA_SHOP_ID and YOOKASSA_SECRET_KEY configured and the SDK installed.
Inputs and outputs
Setup is a standard npm install: npm install @a2seven/yoo-checkout uuid, plus the two required environment variables, YOOKASSA_SHOP_ID and YOOKASSA_SECRET_KEY. From there, the skill's content is organized as a SKILL.md entry point backed by focused reference files - api-authentication.md (auth, headers, idempotency), payment-flow.md (payment lifecycle), payment-methods.md (supported methods), webhooks.md, receipts-fiscalization.md (54-FZ), and error-handling.md - plus ready-to-adapt TypeScript examples: quick-start.ts for a basic payment, two-stage-payment.ts for a hold-then-capture flow, webhook-handler.ts for an Express webhook endpoint, and refund-processing.ts for refunds.
Integrations
The skill is built specifically around the @a2seven/yoo-checkout TypeScript SDK and the YooKassa REST API v3, and its webhook example targets an Express-based server. Its fiscalization guidance is scoped to Russian legal requirements under 54-FZ, which govern electronic receipts for payments made in Russia.
Who it's for
Developers integrating YooKassa payments into a TypeScript/Node.js application - particularly teams that need to get one-stage or two-stage payment flows, webhooks, refunds, and 54-FZ-compliant receipts right the first time, without re-deriving the API's authentication and idempotency rules from scratch.
Source README
Yookassa Skill
A documentation-only Claude Code skill for integrating with the YooKassa Russian payment gateway.
What This Skill Provides
- Complete API reference for YooKassa REST API v3
- TypeScript examples using
@a2seven/yoo-checkoutSDK - Payment flow patterns (one-stage, two-stage, refunds)
- Webhook handling and security
- Russian fiscalization (54-FZ) requirements
- Error handling and retry strategies
Structure
yookassa/
├── SKILL.md # Main skill entry point
├── README.md # This file
├── references/
│ ├── api-authentication.md # Auth, headers, idempotency
│ ├── payment-flow.md # Payment lifecycle
│ ├── payment-methods.md # Supported payment methods
│ ├── webhooks.md # Webhook handling
│ ├── receipts-fiscalization.md # 54-FZ requirements
│ └── error-handling.md # Errors and retries
└── examples/
├── quick-start.ts # Basic payment
├── two-stage-payment.ts # Hold → capture
├── webhook-handler.ts # Express webhook endpoint
└── refund-processing.ts # Refund examples
Prerequisites
npm install @a2seven/yoo-checkout uuid
Environment Variables
YOOKASSA_SHOP_ID=your_shop_id
YOOKASSA_SECRET_KEY=your_secret_key
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.