Payment Gateway Wrapper (Tinkoff)
Russian payments without the tears.
A complete TypeScript/Python wrapper for the Tinkoff payment gateway: receipts, VAT handling, recurring payments, refunds, and webhook verification. Handles every edge case their documentation skips.
Tech stack
The Problem
Tinkoff documentation has gaps that only show up in production at 2 AM
VAT and fiscal receipt formatting have undocumented edge cases
Recurring payment setup requires reverse-engineering their API flow
What's Included
Everything you need to ship production-grade code
Full API Coverage
Init, confirm, cancel, refund, get-state, and recurring charge — all endpoints wrapped.
Fiscal Receipts
FZ-54 compliant receipt generation with all required item fields and VAT codes.
Recurring Payments
Subscription charge flow: register → first payment → subsequent charges with token reuse.
Webhook Verification
HMAC signature verification and idempotent webhook processing.
Error Handling
Typed error codes with retry classification: transient vs. permanent failures.
Get the Template
One-time payment. Full source code. Lifetime updates.
Personal License
- TypeScript + Python versions
- Test suite
- README + examples
- Lifetime updates
Frequently Asked Questions
Does this work with other Russian gateways?
Tinkoff only. The patterns apply but each gateway has distinct quirks requiring separate wrappers.
Is this maintained for API changes?
Yes. Lifetime updates include API version changes.