The YooKassa connector synchronizes payment transactions, invoices, and payout information from YooKassa payment gateway into your knowledge base. Each transaction is converted to a document with payment details, amounts, and settlement data.
Authentication
API Key — requires:
- YooKassa merchant account
- API key with transaction and payout read access
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Shop ID | Input | Yes | Your YooKassa shop identifier |
| Transaction Status | Dropdown | No | Filter by status (succeeded/pending/canceled) |
| Date Range | Date Picker | Yes | Sync transactions from date range |
| Min Amount | Input | No | Minimum transaction amount in RUB |
How It Works
- Account Validation — Verifies API access to YooKassa shop
- Transaction Listing — Retrieves payments with pagination (100 per page)
- Payout Fetching — Downloads settlement and payout data
- Document Generation — Transactions become searchable documents
Document Format
Payment ID: 2126d1f7-041f-4a81-a1a5-ff79c5b84f2f
Customer: John Doe
Amount: 10,000 RUB
Currency: RUB
Status: Succeeded
Payment Method: Card
Card: ****1234
Date: 2026-05-21 14:30:00
Settlement: 2026-05-23
Fee: 300 RUB
Net: 9,700 RUBMetadata Tags
| Tag | Type | Description |
|---|---|---|
| Payment ID | Text | YooKassa payment identifier |
| Status | Category | Succeeded, Pending, Canceled |
| Payment Method | Category | Card, Bank Transfer, eWallet |
Pagination
Uses payment ID offset. Cursor format: offset:{payment_id}.
Limitations
- Real-time sync has 5-10 minute delay
- Payment data retained for 4 years
- Refunds shown as separate payment records