Connexion de Tochka Bank

Prérequis

• Un compte courant chez Tochka Bank (tochka.com)
• Le statut d'entrepreneur individuel, de société (SARL/SA) ou d'auto-entrepreneur (les particuliers sans statut ne peuvent pas accepter de paiements)
• L'acquiring en ligne activé dans votre espace personnel Tochka

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

Étape 1. Compte courant chez Tochka

Si vous n'avez pas encore de compte chez Tochka, ouvrez-en un sur tochka.com. Les documents requis sont :

• Pour un entrepreneur individuel : passeport, numéro fiscal, certificat d'enregistrement
• Pour une société : statuts, décision de nomination du directeur, numéro fiscal de la société
• Pour un auto-entrepreneur : passeport, attestation d'inscription comme auto-entrepreneur

L'ouverture du compte prend généralement 1 jour ouvrable.

Étape 2. Activation de l'acquiring en ligne

Dans votre espace personnel Tochka :

1. Accédez à la section "Acquiring" -> "Acquiring en ligne".
2. Cliquez sur "Soumettre une demande".
3. Indiquez l'URL du site : app.tikento.com.
4. Décrivez l'activité : « Vente de billets et inscription à des événements ».
5. Attendez l'approbation (généralement 1 à 2 jours ouvrables).

Après approbation, les clés API pour l'intégration seront disponibles.

Étape 3. Obtention des clés API

Dans votre espace personnel Tochka :

1. Ouvrez "Intégration" -> "API".
2. Copiez le merchantId -- l'identifiant de votre marchand.
3. Cliquez sur "Générer une clé" et copiez l'apiKey.

La clé ne s'affiche qu'une seule fois. En cas de perte, générez-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 -> Tochka.
3. Saisissez le merchantId et l'apiKey.
4. Cliquez sur "Vérifier la connexion".

En cas de vérification réussie, un statut vert « Connecté » apparaît ainsi que la liste des modes de paiement disponibles.

Modes de paiement disponibles

Après la connexion de Tochka, les modes suivants deviennent automatiquement disponibles :

• Cartes bancaires -- Visa, Mastercard, MIR
• SBP -- paiement via l'application bancaire par QR code ou lien
• Apple Pay / Google Pay -- si configurés du côté de Tochka

Activez ou désactivez chaque mode avec les commutateurs dans la section Paiements -> Tochka -> Modes.

Étape 5. Configuration du webhook

Après la vérification réussie, tikento affiche l'URL du webhook au format :

https://app.tikento.com/webhooks/tochka/{merchantId}

Dans votre espace personnel Tochka :

1. Ouvrez "Intégration" -> "Notifications" (ou "Webhooks").
2. Ajoutez l'URL du webhook depuis tikento.
3. Sélectionnez les événements pour les notifications :
   • payment.success -- paiement réussi
   • payment.fail -- paiement échoué
   • refund.success -- remboursement réussi

Sans webhook configuré, tikento ne pourra pas mettre à jour automatiquement les statuts de paiement.

Étape 6. Test

Tochka fournit un mode test. Pour vérifier :

1. Assurez-vous que le mode test est actif dans les paramètres Tochka.
2. Créez un événement test dans tikento avec un billet payant.
3. Ouvrez le formulaire d'inscription et choisissez le paiement par carte.
4. Utilisez la carte de test : 4111 1111 1111 1111 (date -- n'importe quelle date future, CVV -- 3 chiffres quelconques).
5. Après le paiement, vérifiez que le statut du participant dans tikento est passé à « Payé ».

Si le webhook n'est pas arrivé, vérifiez l'URL et les filtres d'événements dans les paramètres Tochka. En savoir plus sur le diagnostic -- Webhook non reçu : diagnostic.

Étape 7. Passage en mode production

Lorsque les tests sont terminés :

1. Dans votre espace personnel Tochka, basculez l'acquiring en ligne en mode production.
2. Remplacez l'apiKey de test par celle de production dans les paramètres tikento (Paramètres -> Paiements -> Tochka).
3. Cliquez à nouveau sur "Vérifier la connexion".

tikento commencera alors à accepter les paiements réels via Tochka.

Commissions

tikento ne majore pas la commission d'acquiring -- elle est transmise en pass-through depuis la banque. Vous payez :

• Commission Tochka pour l'acquiring (le taux dépend de votre forfait bancaire, généralement ~2-2,5 %)
• Commission tikento sur chaque billet payé -- dépend de votre forfait tarifaire

En savoir plus -- Commissions et calculs.