So konfigurieren Sie Robokassa

Sehen wir uns an, wie Sie Zahlungen in einem Bot über den Robokassa-Dienst akzeptieren.

  1. Erstellen Sie einen Online-Shop in Ihrem Robokassa-Konto und geben Sie die folgenden technischen Einstellungen an:

Erstellen Sie Testpasswörter und führen Sie die Ersteinrichtung im Testmodus durch.

So verbinden Sie Robokassa mit MaviBot

Gehen Sie zum Bereich Acquiring und klicken Sie auf der Robokassa-Karte auf Verbinden:

Füllen Sie das Formular im sich öffnenden Fenster aus:

  1. Shop-ID — die Shop-ID, die Sie in den Shopeinstellungen in Ihrem Robokassa-Konto finden.
  2. Passwort #1 und Passwort #2 — eindeutige generierte Folgen von Buchstaben und Zahlen.
  3. Mehrwertsteuersatz — geben Sie den entsprechenden Code für die Übergabe des Mehrwertsteuerwerts an. Dieses Feld legt den Steuersatz in der Kasse fest. Er wird für jede Produktart separat festgelegt, gilt aber für alle Einheiten dieses bestimmten Produkts zusammen.

Verfügbare Werte:

  • Keine Mehrwertsteuer.
  • Mehrwertsteuer bei 0%.
  • Mehrwertsteuer bei 5%.
  • Mehrwertsteuer berechnet bei 12%.
  • Mehrwertsteuer berechnet bei 16%.

Sie können einen Zahlungslink in einem Block mit EINER der verfügbaren Methoden generieren:

Zahlungsbutton

Sie können einen Zahlungslink mit einem Button mit der Zahlungsfunktion generieren.

Erfahren Sie hier, wie Sie einen Button mit der Zahlungsfunktion erstellen.

Lassen Sie uns alle verfügbaren Button-Parameter durchgehen.

Erforderliche Parameter des Zahlungsbuttons

Um einen Zahlungslink zu generieren, geben Sie die folgenden erforderlichen Parameter in den Button-Einstellungen an:

  • Betrag
  • Produktname

Betrag — geben Sie den Produktpreis in Rubel an.

Produktname — dieses Feld darf nur englische oder russische Buchstaben, Zahlen und Satzzeichen enthalten. Die maximale Länge beträgt 100 Zeichen. Diese Informationen werden in der Robokassa-Oberfläche und in der elektronischen Quittung angezeigt, die der Kunde nach erfolgreicher Zahlung erhält.

VERWENDEN SIE KEINE doppelten Anführungszeichen im Produktnamen. Entfernen Sie sie oder ersetzen Sie sie durch einfache Anführungszeichen.

Kontrollkästchen für automatische Zahlung — aktiviert wiederkehrende Zahlungen.

Kontrollkästchen für Klickbenachrichtigung — aktiviert die Verfolgung von Klicks auf den Zahlungslink. Wenn aktiviert, erscheint eine Benachrichtigung über den Klick in der Kundenkonversation in MaviBot.

Sie können die weitere Bot-Logik basierend auf dieser Benachrichtigung konfigurieren.

Viele Zahlungssysteme unterstützen cloudbasierte Online-Registrierkassen, die nach Bundesgesetz Nr. 54-FZ erforderlich sind.

Überprüfen Sie die Quittungsanforderungen auf der Website Ihres ausgewählten Zahlungsanbieters, um Probleme mit den Steuerbehörden zu vermeiden.

Quittungsdaten

Öffnen Sie das Menü Quittungsdaten, um die Quittungsparameter anzuzeigen:

Produktname — erforderlich für die Generierung einer Quittung.

VERWENDEN SIE KEINE doppelten Anführungszeichen im Produktnamen. Entfernen Sie sie oder ersetzen Sie sie durch einfache Anführungszeichen.

Gesamtbetrag in Rubel — geben Sie den gesamten Zahlungsbetrag basierend auf der Produktmenge an. Wenn die Menge 1 ist, ist der Gesamtbetrag in Rubel gleich dem Wert, der im erforderlichen Feld Betrag eingegeben wurde.

Menge — die Menge oder das Gewicht des Produkts. Sie können eine ganze Zahl oder eine Dezimalzahl mit einem Punkt übergeben, zum Beispiel:

5

oder

10.3

Client-Variablen, die bei Verwendung eines Zahlungsbuttons automatisch erstellt werden

Sobald der Benutzer einen Block mit einem Zahlungsbutton erhält, werden die folgenden Client-Variablen automatisch erstellt:

Die Service-Client-Variable:

__payments

speichert den Zahlungsbetrag und die Kennung des generierten Zahlungslinks. Sie ist erforderlich, um den vom Zahlungsanbieter empfangenen Webhook zu identifizieren.

Die Service-Variable __payments DARF NICHT gelöscht oder geändert werden.

Die Client-Variable:

error_payment_button

wird erstellt, wenn beim Generieren des Zahlungsbuttons ein Fehler auftritt.

Der Wert von error_payment_button enthält entweder den Fehlertext oder die vom Zahlungsanbieter zurückgegebene Fehlerantwort.

Die Variablenwerte werden aktuell, nachdem der Benutzer zum nächsten Block wechselt.

So verarbeiten Sie das Ergebnis

Bitte beachten Sie

Robokassa sendet Benachrichtigungen nur für erfolgreiche Transaktionen über die Ergebnis-URL.

Robokassa stellt keine Rückrufe für fehlgeschlagene Zahlungen bereit.

Die Fehler-URL ist nur die Seite für fehlgeschlagene Zahlungen, zu der der Zahler weitergeleitet wird, wenn auf der Zahlungsseite ein Fehler auftritt.

Erfolgreiche Zahlung

Nachdem Sie die Zahlung korrekt konfiguriert und den Zahlungslink generiert haben, testen Sie das Setup.

Wenn die Zahlung erfolgreich ist, wird AUTOMATISCH ein Rückruf an die Kundenkonversation im Bereich Clients gesendet.

Der Rückruf besteht aus:

  • 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • dem Wort _success;
  • dem Zahlungsbetrag nach einem Leerzeichen.

Der Rückruf wird automatisch generiert. Sie müssen ihn nicht selbst erstellen oder beim Support des Zahlungsanbieters anfordern.

Beispiel:

ovg58keefc_success 2999

Wo:

  • ovg58keefc — 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • _success — das Ergebnis der Anfrageverarbeitung, das eine erfolgreiche Zahlung anzeigt;
  • 2999 — der Zahlungsbetrag.

Blockausführung:

Rückruf:

Rückrufe des Zahlungsanbieters sind für den Benutzer NICHT SICHTBAR.

Sie werden nur im Bereich Clients angezeigt und sind für den Operator oder Administrator sichtbar.

Beispiel für die Konfiguration einer Rückrufantwort

Geben Sie in einem bedingten Block, wie einem Startbedingung-Block oder einem Zustandslos mit Bedingung-Block, den nach der Zahlung empfangenen Rückruf an.

Wählen Sie entweder Exakte Übereinstimmung oder Enthält Schlüsselwörter als Übereinstimmungstyp.

Nach der Zahlung erhält der Kunde die Nachricht von dem Block, der für die Antwort auf den Rückruf konfiguriert ist:

Fehler beim Zahlungsbetrag

Wenn der in den Button-Einstellungen angegebene Betrag von dem vom Kunden gezahlten Betrag abweicht, erhält der Bot automatisch einen Rückruf, der besteht aus:

  • 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • _different_amounts;
  • der eindeutigen Zahlungs-ID nach einem Leerzeichen.

Beispiel:

ovg58keefc_different_amounts 123456

Wo:

  • ovg58keefc — 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • _different_amounts — zeigt an, dass der gezahlte Betrag vom Betrag im Zahlungslink abweicht;
  • 123456 — die eindeutige Zahlungs-ID.

get_robokassa_payment_url-Funktion im Rechner

Sie können einen Zahlungslink mit der Funktion get_robokassa_payment_url im Block Rechner generieren.

Weisen Sie im Feld Rechner das Ergebnis der Funktion get_robokassa_payment_url einer Variable zu.

Sie können den Variablennamen selbst wählen. Die Screenshots zeigen beispielhafte Variablennamen.

Der Zahlungslink wird in dieser Variable gespeichert.

Sie können die Variable als Link in einer Nachricht anzeigen oder in einen Button mit Text wie Bezahlen einfügen.

Beispiel für einen Zahlungslink:

https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda

Viele Zahlungssysteme unterstützen cloudbasierte Online-Registrierkassen, die nach Bundesgesetz Nr. 54-FZ erforderlich sind.

Überprüfen Sie die Quittungsanforderungen auf der Website Ihres ausgewählten Zahlungsanbieters, um Probleme mit den Steuerbehörden zu vermeiden.

Rechner

Beispiel 1:

Parameterbeschreibung

get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)

Funktionsparameter

Parameter Beschreibung
amount Zahlungsbetrag. Geben Sie den Produktpreis in Rubel an. Erforderlicher Parameter.
description Produktname. Dieses Feld darf nur englische oder russische Buchstaben, Zahlen und Satzzeichen enthalten. Die maximale Länge beträgt 100 Zeichen. Diese Informationen werden in der Robokassa-Oberfläche und in der elektronischen Quittung angezeigt, die der Kunde nach erfolgreicher Zahlung erhält. Erforderlicher Parameter.
products_for_receipt Parameter für die Quittungsgenerierung. Lesen Sie mehr hier.
recurrent Aktiviert wiederkehrende Zahlungen. Übergeben Sie 1, wenn wiederkehrende Zahlungen aktiviert sind, oder None, wenn sie deaktiviert sind.
currency Dreibuchstabiger Währungscode. Der Wert muss strikt mit den von Robokassa akzeptierten Parametern übereinstimmen.

USD — US-Dollar;
EUR — Euro;
KZT — Tenge.

Codebeispiele

Beispiel 1: Zahlungslink ohne Quittung

res = get_robokassa_payment_url(100, 'Kauf mich')

Beispiel 2: Zahlungslink mit Quittung

receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]

res = get_robokassa_payment_url(100, 'Kauf mich', receipt, '3', 1, 1)

Sie können die Variable als Link in einer Nachricht anzeigen oder in einen Button mit Text wie Kaufen einfügen.

Wenn der Block mehrere Zahlungslink-Funktionen enthält und ein Fehler auftritt, wird der Fehlerwert in der Variable gespeichert:

error_payment_func

Der Fehler der letzten Funktion im Rechner wird gespeichert.

Nachdem Sie die Zahlung korrekt konfiguriert und den Zahlungslink generiert haben, testen Sie das Setup.

So fügen Sie eine Zahlungsbeschreibung hinzu

Sie können eine Zahlungsbeschreibung hinzufügen, indem Sie die Variable setzen:

payment_description

Die Beschreibung wird auf dem Zahlungsformular und auf der Quittung angezeigt.

So verarbeiten Sie das Ergebnis

Wenn die Zahlung erfolgreich ist, wird AUTOMATISCH ein Rückruf an die Kundenkonversation im Bereich Clients gesendet.

Der Rückruf besteht aus:

  • 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • _success;
  • dem Zahlungsbetrag nach einem Leerzeichen.

Der Rückruf wird automatisch generiert. Sie müssen ihn nicht selbst erstellen oder beim Support des Zahlungsanbieters anfordern.

Beispiel:

ovg58keefc_success 1500

Wo:

  • ovg58keefc — 10 Zeichen des geheimen Schlüssels des Zahlungsanbieters;
  • _success — das Ergebnis der Anfrageverarbeitung, das eine erfolgreiche Zahlung anzeigt;
  • 1500 — der Zahlungsbetrag.

Bitte beachten Sie

Der Rückruf ist nur für Sie in der Kundenkonversation sichtbar.

Der Rückruf ist für den Kunden nicht sichtbar, aber Sie können eine Antwort auf eine erfolgreiche Zahlung konfigurieren.

Beispiel

Einstellungen eines Blocks, der die Funktion get_robokassa_payment_url verwendet:

1. Anzeigen des Links im Nachrichtentext

Wichtig

Der Zahlungslink ist eindeutig. Sie dürfen ihn nicht kopieren und an andere Kunden senden.

Senden Sie den Zahlungslink über eine Variable im Bot.

Rückruf nach erfolgreicher Zahlung:

2. Anzeigen des Links in einem Button

Blockausführung:

Rückruf nach erfolgreicher Zahlung: