Traitement des paiements YooKassa

Intégration de YooKassa : guide de traitement des paiements

Connectez votre iSales AI Chatbot à YooKassa pour proposer une large gamme de moyens de paiement localisés populaires en Russie et dans les pays de la CEI. Ce guide vous aidera à configurer l’intégration YooKassa afin que votre bot puisse traiter les paiements de vos produits et services de manière fluide.

Statut d’intégration YooKassa :

• Statut YooKassa : (par exemple, 🟡 Désactivé / Inactif) – Cet indicateur montre si le traitement des paiements YooKassa est actuellement activé ou non pour votre chatbot IA.

Paramètres essentiels de connexion YooKassa :

Pour lier votre iSales AI Chatbot à votre compte YooKassa, vous aurez besoin des identifiants suivants :

• ID de compte YooKassa : (par exemple, non renseigné)

  • Ce que c’est : votre identifiant unique pour votre boutique ou compte dans le système YooKassa.
  • Comment le trouver : connectez-vous à votre compte personnel YooKassa (tableau de bord marchand). Votre Account ID (souvent appelé shopId) sera disponible dans les paramètres de votre compte ou dans les détails d’intégration.

• Clé secrète YooKassa : (par exemple, non renseignée)

  • Ce que c’est : une clé API secrète fournie par YooKassa qui authentifie les requêtes envoyées par le bot iSales AI à votre compte YooKassa. Conservez cette clé confidentielle.
  • Comment la trouver : dans votre compte personnel YooKassa, allez dans les paramètres d’intégration, plus précisément dans la section des clés API (souvent intitulée “Integration” -> “API keys”). Générez ou récupérez votre clé secrète ici.

❗ Prérequis crucial : configuration du webhook

Important avant de commencer : pour que le bot iSales AI reçoive les informations sur les factures payées et mette à jour correctement les statuts de transaction, vous devez configurer un webhook de notification HTTP dans votre compte personnel YooKassa.

• URL du webhook YooKassa (fournie par iSales AI) : https://api.isales.ai/payment/yookassa (ou une URL unique similaire fournie dans votre tableau de bord iSales AI).

• Comment le configurer dans YooKassa :

  1. Connectez-vous à votre compte personnel YooKassa.
  2. Allez dans la section “Integration”.
  3. Recherchez “HTTP-notifications” (ou une formulation similaire pour les webhooks).
  4. Saisissez l’URL du webhook YooKassa fournie par iSales AI dans le champ approprié.
  5. Enregistrez les paramètres. Assurez-vous d’activer les notifications pour les paiements réussis et les autres événements pertinents.

Configuration fiscale et produit :

Adaptez le traitement des paiements aux exigences fiscales de votre entreprise :

• TVA (taxe sur la valeur ajoutée) : (par exemple, without_vat) – Indiquez le taux de TVA applicable à vos ventes. Les options incluent généralement :

  • Sans TVA (par défaut / sélectionné sur la capture)
  • TVA 0 %
  • TVA 10 %
  • TVA 20 %
  • Choisissez l’option qui correspond à vos obligations fiscales.

• Système fiscal : (par exemple, common_system) – Sélectionnez le système fiscal sous lequel votre entreprise opère. Les options courantes peuvent inclure :

  • TVA commune / common_system (par défaut / sélectionné sur la capture)
  • TVA sur le revenu
  • TVA revenu-dépenses
  • TVA brevet
  • Choisissez le système applicable à votre entité juridique dans votre région.

• Type de produit : (par exemple, product) – Définissez la nature générale de ce que vous vendez.

  • Produit (par défaut / sélectionné sur la capture) : généralement pour des biens tangibles ou des éléments numériques distincts.
  • Service : pour les prestations fournies.

Gestion de votre intégration YooKassa :

L’interface propose plusieurs boutons pour configurer et gérer l’intégration :

• 🔑 Mettre à jour la clé secrète YooKassa (bouton) : cliquez pour saisir ou mettre à jour votre clé secrète YooKassa.
• 🆔 Mettre à jour l’ID de compte YooKassa (bouton) : cliquez pour saisir ou mettre à jour votre ID de compte YooKassa (shopId).
• Traitement YooKassa
  • 🟢 Activer / Désactiver (boutons bascule) : active ou désactive YooKassa comme moyen de paiement.
• TVA
  • Boutons pour Sans TVA, TVA 0 %, TVA 10 %, TVA 20 % afin de sélectionner le taux approprié.
• Système fiscal
  • Boutons pour TVA commune, TVA sur le revenu, TVA revenu-dépenses, TVA brevet afin de sélectionner votre système fiscal.
• Type de produit
  • Boutons pour Produit et Service afin de définir le type d’article par défaut.
• ↩️ Retour (bouton) : revient au menu principal « Payment Processing for AI Bot ».

En saisissant correctement vos identifiants YooKassa, en configurant le webhook crucial et en réglant les détails fiscaux et produits, vous pouvez intégrer YooKassa de manière fluide à votre iSales AI Chatbot et offrir à vos clients une expérience de paiement familière et pratique. Référez-vous toujours à la documentation officielle de YooKassa pour obtenir les informations les plus à jour sur les paramètres et les clés API.