User Guide

Interface Overview

• Sidebar: "Dashboard", "Files", "Payouts", "Settings", language toggle RU/EN.
• Header/mobile: offcanvas menu, quick actions: "Create Payout", "Upload File".
• Dashboard: metrics cards, success/error payout chart, recent files.

Dashboard

Section with key metrics for uploads and payouts. Contains aggregated metrics, chart dynamics, and list of recent files for quick access.

• Metrics cards: number of files, number of payouts, total amount, conversion rate (successful/all).
• Chart: trend of successful and failed payouts by periods; legend allows comparing curves.
• Recent files: table with name, date, processing status, brief statistics and amount.

Authorization and Session

• Login through login page. On successful login — redirect to dashboard.
• Inactivity timeout: 30 minutes; after — logout and session end notification.
• CSRF token for protected operations, session ID regeneration after login.

Uploading Payout Files

Upload Process

1. Click "Upload File" (button available on Dashboard, in "Files", "Payouts", and in mobile menu).
2. Select CSV file in one of the supported formats and confirm upload. Upload indicator shows progress.
3. After upload, an entry appears in files list with status: created → processing → completed.

Tips: drag&drop available on supported screens; recent files visible on dashboard.

Supported File Formats

The system supports CSV file uploads in three different formats depending on your needs:

- file for uploading payouts only to recipient card numbers;

- file for uploading payouts only through the Fast Payment System (SBP);

- file for uploading payouts to card numbers and through SBP in one file.

Parameters used in files:

• card_number - recipient's card number;
• sbp_phone - recipient's phone number;
• sbp_bank_id - recipient's bank identifier;
• sbp_full_name - recipient's full name;
• amount - payout amount;
• description - payout description.

File Examples

card_number;amount;description
4111111111111111;1500,50;Refund for goods
5555555555554444;2300,00;Expense compensation

sbp_phone;sbp_bank_id;sbp_full_name;amount;description
79001234567;100000000004;Ivanov Ivan Ivanovich;1500,50;Expense refund
79123456789;100000000008;Petrova Maria Sergeevna;2300,00;Delivery compensation

type;pan;sbp_phone;sbp_bank_id;sbp_full_name;amount;description
card;4111111111111111;;;;1500,50;Refund for goods
sbp;;79001234567;100000000004;Ivanov Ivan Ivanovich;2300,00;Expense compensation

Validation and Restrictions

Card Payouts

• Card number: 13-19 digits, passes Luhn algorithm check
• Amount: from 1.00 to 9,999,999.99 rubles
• Description: up to 256 characters

SBP Payouts

• Phone number: format 7XXXXXXXXXX (11 digits, starts with 7)
• Bank ID: 9 to 12 digits
• Full name: first and last name in Russian (2-255 characters)
• Amount: from 1.00 to 9,999,999.99 rubles
• Description: up to 256 characters

General Limitations

• Maximum rows per file: 5,000 (excluding header)
• File size: recommended up to 5 MB
• Encoding: UTF-8
• Separator: semicolon (;)
• Decimal separator: comma (,) or dot (.)

File Details

Open file from list to see aggregated metrics (sum, count, success/error/ignore) and line-by-line payouts.

• Confirm payouts: if there are positions with "uploaded" status, click "Confirm"; with 2FA enabled, code required.
• File download: available for a limited time (usually 3 days).

Payouts List

Contains all payouts: from files and single. For SBP — phone masking and bank; for cards — number mask, payment system and bank. Status badge success helps quickly distinguish statuses.

Quick payout retry available per row (retry icon).

Single Payout

1. Click "Create Payout" (button on dashboard/lists). Modal window opens.
2. Select tab: "Card Payout" or "SBP Payout".
3. Fill form: card number and amount/description, or SBP phone, bank, full name, amount and description.
4. If needed, enter 2FA code and submit.

Card number validation by Luhn algorithm, amount formatting, SBP bank suggestions.

Filters, Search, Export

• Files: status, period (including custom dates), search by name, list export. Filter chip example Status: all.
• Payouts: status, dates, search by last 4 card digits, recipient bank (suggestions), payment system, payment type.
• Dashboard: quick period, status filter, success/error chart.

Settings and Integrations

• Profile: interface theme (light/dark/system), general account information.
• Integrations (VTB, SBP): client_id/client_secret, merchant authorization (for dev/uat environments), access token and expiration display, public keys.
• General: behavior options (e.g., create single payout in new file).
• Security: password change from modal window (complexity requirements), notifications.

2FA and Security

• Enable 2FA for login and/or specific operations (payouts, password change, single payouts).
• 2FA codes requested in modal windows when confirming payouts and in forms.
• 30-minute inactivity timeout, session fixation protection, CSRF tokens.

Common Issues and Solutions

• Statuses not updating: wait for background check or refresh page; ensure status check process is active.
• File unavailable for download: after time limit (≈3 days) download is disabled.
• Single payout error: check card number/phone correctness, amount, 2FA, integration access.
• No bank suggestions: check network or try typing more characters.

FAQ