Setting Up YooKassa (Yandex Kassa)

What You Need to Connect

• A YooKassa account (yookassa.ru)
• Sole proprietor, LLC/JSC, or self-employed status (individuals without status cannot accept payments)
• A bank account linked to YooKassa

YooKassa is available on all tikento plans, including Free.

Step 1. YooKassa Registration

Go to yookassa.ru and create an account. To access production payments, you will need to pass verification: upload documents (for sole proprietors — passport and certificate, for LLCs — charter and appointment order).

Test mode (test payments without real money) is available immediately after registration without verification.

Step 2. Creating a Store

In the YooKassa dashboard:

1. Go to the Stores section.
2. Click "Create store".
3. Fill in the details: name, website URL (enter app.tikento.com), activity description.
4. In the "Connection method" section, select HTTP notifications (not widget).
5. Save the settings.

Step 3. Obtaining API Keys

In the created store's settings:

1. Open the "API Keys" tab.
2. Copy the shopId — the store's numeric identifier (e.g., 123456).
3. Click "Create secret key", enter confirmation. Copy the secretKey in the format test_XXXX... (test) or live_XXXX... (production).

The secret key is shown only once. If lost, create a new one — the old one will become invalid.

Step 4. Configuration in tikento

1. Open your organization's Settings in tikento.
2. Go to the Payments → YooKassa section.
3. Enter shopId and secretKey.
4. Click "Test connection" — tikento will make a test request to the YooKassa API.

On a successful test, a green "Connected" status will appear.

Step 5. Webhook Configuration

After a successful test, tikento will display a webhook URL for your store (in the format https://app.tikento.com/webhooks/yookassa/{shopId}).

In the YooKassa store settings:

1. Open "HTTP notifications".
2. Add the webhook URL.
3. Select events to send:
   • payment.succeeded — payment completed successfully
   • payment.canceled — payment canceled
   • refund.succeeded — refund completed

Step 6. Testing

For testing, use the test key (starting with test_). YooKassa test cards:

Expiry date — any future date, CVV — any 3 digits.

Step 7. Switching to Production Mode

When testing is complete:

1. In YooKassa, submit a production mode request (button in the store dashboard).
2. Upload the required documents.
3. After approval, YooKassa will send a notification.
4. Replace the test secretKey with the production one in tikento settings.

Approval usually takes 1-3 business days for sole proprietors and 3-5 days for LLCs.