Wie man anschließt

Um das Zahlungssystem bePaid anzuschließen, benötigen Sie Ihre Shop-ID, einen geheimen Schlüssel und einen öffentlichen Schlüssel. Nachdem Sie diese erhalten haben, fahren Sie mit den Einstellungen in MaviBot fort.

Öffnen Sie in MaviBot den Bereich "Acquiring" und wählen Sie bePaid. Sie müssen die erhaltenen Daten eingeben.

Beachten Sie, dass das letzte Feld ein Schalter für den API-Hosting-Standort ist, abhängig vom Nutzungsland: Weißrussland oder Russland.

Um einen Zahlungslink zu generieren, müssen Sie den Wert der Variable payment_sum festlegen (z.B. 150 oder 100.55 (mit Punkt!)), danach erscheint sofort die Variable bepaid_pay_url. Diese Variable kann als Link auf dem Bildschirm angezeigt oder auf einem Button mit dem Text "Bezahlen" platziert werden.

Der Link hat die Form:
https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a

Vor dem Festlegen des Wertes der Variable payment_sum können auch die folgenden optionalen Variablen zur Konfiguration der Zahlung festgelegt werden.

Standardmäßig ist der Weißrussische Rubel eingestellt. Wenn eine andere Währung benötigt wird, muss der Wert der Variable currency gesetzt werden.

Nach Abschluss der Zahlung wird dem Kunden die Variable bepaid_callback_data hinzugefügt, die die Antwortdaten des Zahlungssystems zur durchgeführten Transaktion enthält. Aus dem erhaltenen Wörterbuch können mit der Methode get die erforderlichen Daten extrahiert werden.

Wie man Zahlungen testet

Um eine Testzahlung durchzuführen, muss vor dem Festlegen der Variable payment_sum die Variable test_payments mit einem beliebigen Wert gesetzt werden.

Vergessen Sie nicht, sie zu entfernen, wenn Sie den Bot im Live-Modus starten!

Karten für Tests:

4200000000000000 success

4005550000000019 failed

Wenn etwas nicht funktioniert, vergleichen Sie die Daten mit den Daten auf der offiziellen Website: https://docs.bepaid.by/ru/test-integration#test-card-number

Erstellen wir einen Zahlungslink in Höhe von 100 weißrussischen Rubel (Standardwährung)

Beachten Sie, dass zuerst die zusätzlichen Variablen für die Einstellungen und dann payment_sum festgelegt werden. Die Variablen können auch früher in der Kette und nicht in einem Block festgelegt werden, dies ist ein Beispiel.

Anschließend wird an der gewünschten Stelle die Variable bepaid_pay_url ausgegeben, die den Link enthält.

Abonnementverwaltung

Die Integration des Zahlungssystems bietet die Möglichkeit, Abonnements für Ihre Kunden zu erstellen.

Bevor Sie die MaviBot-Funktionalität nutzen, erstellen Sie einen Abonnementplan in Ihrem bePaid-Konto.

Wenn das Menü "Pläne" und "Abonnements" in Ihrem Konto nicht angezeigt wird, wenden Sie sich an Ihren Manager.

Verwenden Sie die Funktion get_bepaid_subscription_url und übergeben Sie ihr den Parameter plan_id, wobei

Als Ergebnis erstellt die Funktion ein Abonnement und gibt einen Link zur Zahlung zurück.

Senden Sie den Link an den Kunden und warten Sie auf den Abschluss der Zahlung.

Bei erfolgreicher Zahlung wird das Abonnement aktiviert, die Variablen bepaid_subscription_id und bepaid_subscription_status werden zum Deal hinzugefügt, und der Bot erhält einen Callback (siehe Abschnitt "Wie man das Ergebnis verarbeitet").

Informationen zum Abonnement abrufen

Um die Daten des aktuellen Abonnements des Kunden zu erhalten, rufen Sie die Funktion get_bepaid_subscription_info auf und übergeben Sie ihr den Parameter subscription_id (der Wert kann aus der Variable bepaid_subscription_id entnommen werden).

Abonnement kündigen

Um ein Abonnement zu kündigen, verwenden Sie die Funktion cancel_bepaid_subscription.

Diese Funktion akzeptiert einen einzigen Parameter subscription_id (der Wert kann aus der Variable bepaid_subscription_id entnommen werden).

Bei erfolgreicher Kündigung nimmt die Variable bepaid_subscription_status den Wert “canceled” an, und der Bot erhält einen Callback (siehe Abschnitt “Wie man das Ergebnis verarbeitet”).

Abonnementstatus

Wiederkehrende Zahlungen

Sie können auch ein Abonnementsystem ohne Erstellung eines Plans in Ihrem bePaid-Konto organisieren.

Dazu benötigen Sie das Kartentoken des Kunden.

Um das Kartentoken zu erhalten, muss der Kunde eine Einrichtungszahlung über einen Link durchführen, der über payment_sum generiert wurde.

Vor dem Festlegen des Wertes von payment_sum setzen Sie die Variable bepaid_contract, in der Sie den Zweck zukünftiger Zahlungen per Token angeben: “recurring” für regelmäßige Zahlungen mit festgelegter Periodizität oder “card_on_file” für unregelmäßige Zahlungen (z.B. Nachzahlung für eine erbrachte Dienstleistung).

Die Option “card_on_file” wird nicht von allen Acquiring-Partnern unterstützt. Wenn Sie sie verwenden möchten, wenden Sie sich an Ihren Account Manager.

Nach erfolgreicher Zahlung wird dem Deal die Variable bepaid_client_card_token hinzugefügt, in der das Kartentoken des Kunden gespeichert wird. Dieses Token ermöglicht es, Geld vom Kartenkonto des Kunden ohne dessen Beteiligung abzubuchen.

Richten Sie dann den Trichter ein und legen Sie ein Datum oder eine Bedingung für die automatische Abbuchung fest und rufen Sie die Rechnerfunktion make_bepaid_token_payment auf, indem Sie die erforderlichen Parameter übergeben.

Reihenfolge der Parameter:

amount -> currency -> description -> contract

Parameterbeschreibung:

Der Wert von contract muss unbedingt dem Wert entsprechen, der bei der Erstellung des Links für die Einrichtungszahlung angegeben wurde!

Wenn die Zahlung erfolgreich war, gibt die Funktion die Meldung “Erfolgreiche Abbuchung per bePaid-Token” zurück, Sie erhalten einen Callback über die erfolgreiche Zahlung, und die Deal-Variable bepaid_token_payment_completed nimmt den Wert “True” an.

Wenn die Zahlung fehlgeschlagen ist, gibt die Funktion eine Meldung mit dem Grund der fehlgeschlagenen Zahlung zurück, der Bot erhält einen Callback mit dem Suffix “_fail”, und die Deal-Variable bepaid_token_payment_completed nimmt den Wert “False” an.

Die Bank kann den Abschluss der Zahlung durch den Kunden anfordern. In diesem Fall gibt die Funktion einen Link mit der Aufforderung zur 3-D Secure-Authentifizierung zurück.

Wie man das Ergebnis verarbeitet

Als Reaktion auf Kundenaktionen erhält der Bot Callbacks, die aus den ersten 20 Zeichen des geheimen Schlüssels und einem Suffix bestehen, das vom Typ und Ergebnis der Operation abhängt.

Im System sieht der Callback wie eine Nachricht vom Benutzer aus, der Benutzer selbst sieht sie jedoch nicht.

Für Zahlungen

Als Ergebnis einer Zahlung, die nicht zu einem Abonnement gehört, erhalten Sie eine der folgenden Nachrichten:

Schlüsselnummer_success - bei erfolgreicher Zahlung;

Schlüsselnummer_fail - bei fehlgeschlagener Zahlung;

Der Status der letzten Zahlung kann auch anhand der Variablen bepaid_payment_completed (für Zahlungen mit Kundenbeteiligung) und bepaid_token_payment_completed (für Lastschriften per Kartentoken) verfolgt werden.

Für Abonnements

Nach erfolgreicher Aktivierung eines Abonnements bei der ersten oder wiederholten Zahlung erhält der Bot die Nachricht Schlüsselnummer_success.

Wenn das Abonnement gekündigt wurde, erhalten Sie Schlüsselnummer_canceled.

Im Falle einer fehlgeschlagenen Zahlung im Rahmen eines Abonnements erhalten Sie die Nachricht Schlüsselnummer**_fail.**