YooKassa-Zahlungsabwicklung

YooKassa integrieren: Leitfaden zur Zahlungsabwicklung

Verbinde deinen iSales AI Chatbot mit YooKassa, um eine breite Palette lokalisierter Zahlungsmethoden anzubieten, die in Russland und den GUS-Ländern beliebt sind. Dieser Leitfaden hilft dir, die YooKassa-Integration zu konfigurieren, damit dein Bot Zahlungen für deine Produkte und Dienstleistungen reibungslos verarbeiten kann.

Integrationsstatus von YooKassa:

• YooKassa-Status: (z. B. 🟡 Aus / Inaktiv) – Diese Anzeige zeigt, ob die YooKassa-Zahlungsabwicklung derzeit für deinen KI-Chatbot aktiviert ist oder nicht.

Wichtige YooKassa-Verbindungsdaten:

Um deinen iSales AI Chatbot mit deinem YooKassa-Konto zu verbinden, benötigst du die folgenden Zugangsdaten:

• YooKassa-Konto-ID: (z. B. nicht gesetzt)

  • Was es ist: deine eindeutige Kennung für deinen Shop oder dein Konto im YooKassa-System.
  • So findest du sie: Melde dich in deinem persönlichen YooKassa-Konto (Händler-Dashboard) an. Deine Account ID (oft als shopId bezeichnet) findest du in den Kontoeinstellungen oder den Integrationsdetails.

• YooKassa-Geheimschlüssel: (z. B. nicht gesetzt)

  • Was es ist: ein geheimer API-Schlüssel von YooKassa, der Anfragen des iSales AI Bots an dein YooKassa-Konto authentifiziert. Halte diesen Schlüssel vertraulich.
  • So findest du ihn: Gehe in deinem persönlichen YooKassa-Konto zu den Integrationseinstellungen, insbesondere zum Bereich für API-Schlüssel (oft mit “Integration” -> “API keys” bezeichnet). Erzeuge oder rufe hier deinen geheimen Schlüssel ab.

❗ Wichtige Voraussetzung: Webhook-Konfiguration

Wichtig vor dem Start: Damit der iSales AI Bot Informationen über bezahlte Rechnungen erhält und Transaktionsstatus korrekt aktualisiert, musst du einen HTTP-Benachrichtigungs-Webhook in deinem persönlichen YooKassa-Konto einrichten.

• YooKassa-Webhook-URL (von iSales AI bereitgestellt): https://api.isales.ai/payment/yookassa (oder eine ähnliche eindeutige URL, die in deinem iSales-AI-Dashboard bereitgestellt wird).

• So richtest du es in YooKassa ein:

  1. Melde dich in deinem persönlichen YooKassa-Konto an.
  2. Gehe zum Bereich “Integration”.
  3. Suche nach “HTTP-notifications” (oder einer ähnlichen Bezeichnung für Webhooks).
  4. Gib die von iSales AI bereitgestellte YooKassa-Webhook-URL in das entsprechende Feld ein.
  5. Speichere die Einstellungen. Stelle sicher, dass du Benachrichtigungen für erfolgreiche Zahlungen und andere relevante Ereignisse aktivierst.

Steuer- und Produktkonfiguration:

Passe die Zahlungsabwicklung an die steuerlichen Anforderungen deines Unternehmens an:

• MwSt. (Mehrwertsteuer): (z. B. without_vat) – Gib den auf deine Verkäufe anwendbaren MwSt.-Satz an. Die Optionen umfassen typischerweise:

  • Ohne MwSt. (Standard / im Screenshot ausgewählt)
  • MwSt. 0 %
  • MwSt. 10 %
  • MwSt. 20 %
  • Wähle die Option, die zu deinen steuerlichen Verpflichtungen passt.

• Steuersystem: (z. B. common_system) – Wähle das Steuersystem, unter dem dein Unternehmen arbeitet. Übliche Optionen sind:

  • Allgemeine MwSt. / common_system (Standard / im Screenshot ausgewählt)
  • Einkommens-MwSt.
  • Einnahmen-Ausgaben-MwSt.
  • Patent-MwSt.
  • Wähle das System, das für deine juristische Person in deiner Region gilt.

• Produkttyp: (z. B. product) – Definiere die allgemeine Art dessen, was du verkaufst.

  • Produkt (Standard / im Screenshot ausgewählt): typischerweise für materielle Waren oder eigenständige digitale Artikel.
  • Dienstleistung: für erbrachte Services.

Deine YooKassa-Integration verwalten:

Die Oberfläche bietet mehrere Schaltflächen zum Konfigurieren und Verwalten der Integration:

• 🔑 YooKassa-Geheimschlüssel aktualisieren (Schaltfläche): Klicke, um deinen YooKassa-Geheimschlüssel einzugeben oder zu aktualisieren.
• 🆔 YooKassa-Konto-ID aktualisieren (Schaltfläche): Klicke, um deine YooKassa-Konto-ID (shopId) einzugeben oder zu aktualisieren.
• YooKassa-Verarbeitung
  • 🟢 Aktivieren / Deaktivieren (Umschalter): Aktiviert oder deaktiviert YooKassa als Zahlungsmethode.
• MwSt.
  • Schaltflächen für Ohne MwSt., MwSt. 0 %, MwSt. 10 %, MwSt. 20 % zur Auswahl des passenden MwSt.-Satzes.
• Steuersystem
  • Schaltflächen für Allgemeine MwSt., Einkommens-MwSt., Einnahmen-Ausgaben-MwSt., Patent-MwSt. zur Auswahl deines Steuersystems.
• Produkttyp
  • Schaltflächen für Produkt und Dienstleistung, um den Standardtyp des Artikels festzulegen.
• ↩️ Zurück (Schaltfläche): kehrt zum Hauptmenü „Payment Processing for AI Bot“ zurück.

Wenn du deine YooKassa-Zugangsdaten korrekt eingibst, den wichtigen Webhook einrichtest und die steuerlichen sowie produktbezogenen Details konfigurierst, kannst du YooKassa nahtlos mit deinem iSales AI Chatbot integrieren und deinen Kunden ein vertrautes und bequemes Zahlungserlebnis bieten. Konsultiere immer die offizielle YooKassa-Dokumentation für die aktuellsten Informationen zu Einstellungen und API-Schlüsseln.