YooKassa (Yandex Kassa) anbinden

Voraussetzungen

• Konto bei YooKassa (yookassa.ru)
• Status als Einzelunternehmer, GmbH/AG oder Selbstständiger (für Privatpersonen ohne Status ist die Zahlungsannahme nicht verfügbar)
• Mit YooKassa verbundenes Geschäftskonto

YooKassa ist bei allen tikento-Tarifen verfügbar, einschließlich Free.

Schritt 1. Registrierung bei YooKassa

Gehen Sie auf yookassa.ru und erstellen Sie ein Konto. Für den Zugang zu Live-Zahlungen müssen Sie eine Verifizierung durchlaufen: Dokumente hochladen (für Einzelunternehmer — Reisepass und Zertifikat, für GmbH — Satzung und Ernennungsbeschluss).

Der Testmodus (Testzahlungen ohne echtes Geld) ist sofort nach der Registrierung ohne Verifizierung verfügbar.

Schritt 2. Shop erstellen

Im YooKassa-Dashboard:

1. Gehen Sie zum Bereich Shops.
2. Klicken Sie auf «Shop erstellen».
3. Füllen Sie die Daten aus: Name, Website-URL (geben Sie app.tikento.com an), Tätigkeitsbeschreibung.
4. Wählen Sie im Abschnitt «Verbindungsmethode» HTTP-Benachrichtigungen (nicht Widget).
5. Speichern Sie die Einstellungen.

Schritt 3. API-Schlüssel erhalten

In den Einstellungen des erstellten Shops:

1. Öffnen Sie den Reiter «API-Schlüssel».
2. Kopieren Sie die shopId — die numerische Kennung des Shops (z. B. 123456).
3. Klicken Sie auf «Geheimen Schlüssel erstellen» und bestätigen Sie. Kopieren Sie den secretKey im Format test_XXXX... (Test) oder live_XXXX... (Live).

Der geheime Schlüssel wird nur einmal angezeigt. Wenn Sie ihn verloren haben — erstellen Sie einen neuen, der alte wird dabei ungültig.

Schritt 4. Einrichtung in tikento

1. Öffnen Sie die Einstellungen Ihrer Organisation in tikento.
2. Gehen Sie zum Bereich Zahlungen → YooKassa.
3. Geben Sie shopId und secretKey ein.
4. Klicken Sie auf «Verbindung prüfen» — tikento sendet eine Testanfrage an die YooKassa-API.

Bei erfolgreicher Prüfung erscheint der grüne Status «Verbunden».

Schritt 5. Webhook einrichten

Nach erfolgreicher Prüfung zeigt tikento die Webhook-URL für Ihren Shop an (im Format https://app.tikento.com/webhooks/yookassa/{shopId}).

In den YooKassa-Shop-Einstellungen:

1. Öffnen Sie «HTTP-Benachrichtigungen».
2. Fügen Sie die Webhook-URL hinzu.
3. Wählen Sie die zu sendenden Ereignisse:
   • payment.succeeded — Zahlung erfolgreich ausgeführt
   • payment.canceled — Zahlung storniert
   • refund.succeeded — Rückerstattung ausgeführt

Schritt 6. Testen

Verwenden Sie zum Testen den Testschlüssel (beginnt mit test_). YooKassa-Testkarten:

Ablaufdatum — beliebiges zukünftiges Datum, CVV — beliebige 3 Ziffern.

Schritt 7. In den Live-Modus wechseln

Wenn die Tests erfolgreich abgeschlossen sind:

1. Stellen Sie in YooKassa einen Antrag auf Umstellung in den Live-Modus (Schaltfläche im Shop-Dashboard).
2. Laden Sie die erforderlichen Dokumente hoch.
3. Nach der Genehmigung sendet YooKassa eine Benachrichtigung.
4. Ersetzen Sie den Test-secretKey durch den Live-Key in den tikento-Einstellungen.

Die Genehmigung dauert in der Regel 1–3 Werktage für Einzelunternehmer und 3–5 Tage für GmbH.