YooKassa
Quick Start
- Sign up at yookassa.ru and obtain API credentials
- Create a terminal in the Admin Console with the parameters below
- Start processing — the adapter is pre-built and ready to use
Overview
YooKassa payment integration
| Provider ID | yookassa |
| Category | Card Processors |
| Website | yookassa.ru |
Authentication
Basic Auth:
Authorization: Basic base64(shop_id:secret_key)Content-Type: application/jsonIdempotence-Key: uuid(required for POST)
Configuration
Required Parameters
| Parameter | Description |
|---|---|
none | 1 (VAT-free) |
vat0 | 2 (VAT 0%) |
vat10 | 3 (VAT 10%) |
vat20 | 4 (VAT 20%) |
vat110 | 5 (settlement 10/110) |
vat120 | 6 (settlement 20/120) |
Example Configuration
{
"provider": "yookassa",
"provider_params": {
"shop_id": "123456",
"secret_key": "live_xxx...",
"webhook_url": "https://api.merchant.com/ext/yookassa/hook",
"fiscalization_mode": "inline",
"fiscalization_taxation": "osn",
"fiscalization_default_vat": "vat20"
}
}
Status Mapping
| Provider Status | 4pay Status | Description |
|---|---|---|
pending | charging | |
waiting_for_capture | authorized | |
succeeded | charged | |
canceled | failed |
Testing
Test Cards
| Card | Number | Expiry | CVV | Result |
|---|---|---|---|---|
| Success | 5555555555554444 | 12/30 | 123 | Success |
| 3DS | 4000000000003063 | 12/30 | 123 | 3DS required |
| Decline | 4000000000000002 | 12/30 | 123 | Declined |