Connexion de YooKassa (Yandex Kassa)

Prérequis

• Un compte YooKassa (yookassa.ru)
• Le statut d'entrepreneur individuel, de société (SARL/SA) ou d'auto-entrepreneur (pour les particuliers sans statut, l'acceptation des paiements n'est pas disponible)
• Un compte courant bancaire lié à YooKassa

YooKassa est disponible sur tous les forfaits tikento, y compris Free.

Étape 1. Inscription sur YooKassa

Rendez-vous sur yookassa.ru et créez un compte. Pour accéder aux paiements en production, vous devrez passer une vérification : télécharger des documents (pour un entrepreneur individuel -- passeport et certificat, pour une société -- statuts et décision de nomination).

Le mode test (paiements tests sans argent réel) est disponible immédiatement après l'inscription, sans vérification.

Étape 2. Création de la boutique

Dans l'espace personnel YooKassa :

1. Accédez à la section Boutiques.
2. Cliquez sur "Créer une boutique".
3. Remplissez les données : nom, URL du site (indiquez app.tikento.com), description de l'activité.
4. Dans la section « Mode de connexion », sélectionnez Notifications HTTP (pas le widget).
5. Enregistrez les paramètres.

Étape 3. Obtention des clés API

Dans les paramètres de la boutique créée :

1. Ouvrez l'onglet "Clés API".
2. Copiez le shopId -- l'identifiant numérique de la boutique (par exemple, 123456).
3. Cliquez sur « Créer une clé secrète », saisissez la confirmation. Copiez le secretKey au format test_XXXX... (test) ou live_XXXX... (production).

La clé secrète ne s'affiche qu'une seule fois. En cas de perte, créez-en une nouvelle ; l'ancienne sera invalidée.

Étape 4. Configuration dans tikento

1. Ouvrez les Paramètres de votre organisation dans tikento.
2. Accédez à la section Paiements -> YooKassa.
3. Saisissez le shopId et le secretKey.
4. Cliquez sur "Vérifier la connexion" -- tikento effectuera une requête test vers l'API YooKassa.

En cas de vérification réussie, un statut vert « Connecté » apparaît.

Étape 5. Configuration du webhook

Après la vérification réussie, tikento affiche l'URL du webhook pour votre boutique (au format https://app.tikento.com/webhooks/yookassa/{shopId}).

Dans les paramètres de la boutique YooKassa :

1. Ouvrez "Notifications HTTP".
2. Ajoutez l'URL du webhook.
3. Sélectionnez les événements à envoyer :
   • payment.succeeded -- paiement réussi
   • payment.canceled -- paiement annulé
   • refund.succeeded -- remboursement effectué

Étape 6. Test

Pour les tests, utilisez la clé test (commençant par test_). Cartes de test YooKassa :

Date d'expiration -- n'importe quelle date future, CVV -- 3 chiffres quelconques.

Étape 7. Passage en mode production

Lorsque les tests sont réussis :

1. Dans YooKassa, soumettez une demande de passage en mode production (bouton dans le tableau de bord de la boutique).
2. Téléchargez les documents requis.
3. Après approbation, YooKassa enverra une notification.
4. Remplacez le secretKey test par celui de production dans les paramètres tikento.

L'approbation prend généralement 1 à 3 jours ouvrables pour un entrepreneur individuel et 3 à 5 jours pour une société.