So verbinden Sie sich

Um das bePaid-Zahlungssystem zu verbinden, benötigen Sie eine Store-ID, einen geheimen Schlüssel und einen öffentlichen Schlüssel. Sobald Sie diese Anmeldedaten erhalten haben, fahren Sie mit den Einstellungen in Salebot fort.

Um die Store-ID, den geheimen Schlüssel und den öffentlichen Schlüssel zu erhalten, wenden Sie sich bitte an den technischen Support von baPaid.

Öffnen Sie in MaviBot den Abschnitt "Zahlungssystem" und wählen Sie bePaid aus. Geben Sie dann die erhaltenen Anmeldedaten ein.

Bitte beachten Sie, dass es sich beim letzten Feld um einen Schalter handelt, der den API-Hosting-Standort je nach Nutzungsland auswählt: Weißrussland oder Russland.

Um einen Zahlungslink zu generieren, müssen Sie einen Wert für die Variable payment_sum festlegen (z. B.: 150 oder 100.55 – verwenden Sie einen Punkt als Dezimaltrennzeichen).

Sobald die Variable payment_sum gesetzt ist, wird die Variable bepaid_pay_url automatisch angezeigt. Sie können diese Variable als Link auf dem Bildschirm anzeigen oder auf einer Schaltfläche mit dem Text "Bezahlen" platzieren.

Der Zahlungslink sieht wie folgt aus:
https://checkout.bepaid.by/widget/hpp.html?token=a05eabd3f9368725efbc175614c7d469da08f198cc51916b07fb75e53f9a3e1a

Bevor Sie die Variable payment_sum setzen, können Sie auch die folgenden optionalen Variablen definieren, um die Zahlung anzupassen.

Standardmäßig ist die Währung auf Weißrussischer Rubel eingestellt. Wenn Sie eine andere Währung verwenden müssen, setzen Sie einen Wert für die Variable currency.

Nach Abschluss der Zahlung wird dem Kunden die Variable bepaid_callback_data hinzugefügt. Sie enthält die Antwort des Zahlungssystems für die abgeschlossene Transaktion. Sie können die erforderlichen Daten aus diesem Wörterbuch mit der Methode get extrahieren.

So testen Sie Zahlungen

Um eine Testzahlung durchzuführen, setzen Sie vor dem Setzen der Variable payment_sum die Variable test_payments mit einem beliebigen Wert.
Denken Sie daran, sie zu entfernen, wenn Sie den Bot im Live-Modus ausführen!

Testkarten:

  • 4200000000000000 — Erfolg
  • 4005550000000019 — Fehlgeschlagen

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

Erstellen wir einen Zahlungslink für 100 Weißrussische Rubel (Standardwährung).

Hinweis: Setzen Sie zuerst die zusätzlichen Variablen für die Konfiguration, dann setzen Sie payment_sum. Variablen können auch früher im Workflow gesetzt werden, nicht unbedingt im selben Block – dies ist nur ein Beispiel.

Zeigen Sie schließlich die Variable bepaid_pay_url an der gewünschten Stelle an; sie enthält den generierten Zahlungslink.

Abonnementverwaltung

Die Integration des Zahlungssystems ermöglicht es Ihnen, Abonnements für Ihre Kunden zu erstellen.

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

Wenn die Menüs „Pläne“ und „Abonnements“ in Ihrem Konto nicht angezeigt werden, wenden Sie sich bitte an Ihren Manager.

Erstellen eines Abonnements und Generieren eines Zahlungslinks

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

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

Senden Sie den Link an den Kunden und warten Sie, bis die Zahlung abgeschlossen ist.

Sobald die Zahlung erfolgreich ist, wird das Abonnement aktiviert. Der Deal erhält die Variablen bepaid_subscription_id und bepaid_subscription_status, und ein Callback wird an den Bot gesendet (siehe Abschnitt „So verarbeiten Sie das Ergebnis“).

Abonnementinformationen abrufen

Um die aktuellen Abonnementdetails für einen Kunden zu erhalten, rufen Sie die Funktion get_bepaid_subscription_info auf und übergeben Sie 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 einzelnen Parameter: subscription_id (der Wert kann aus der Variable bepaid_subscription_id entnommen werden).

Bei erfolgreicher Kündigung wird die Variable bepaid_subscription_status auf „canceled“ gesetzt und ein Callback an den Bot gesendet (siehe Abschnitt „So verarbeiten Sie das Ergebnis“).

Abonnementstatus

Wiederkehrende Zahlungen

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

Dafür benötigen Sie das Kartentoken des Kunden.

Um das Kartentoken zu erhalten, muss der Kunde eine erste Zahlung mit einem über payment_sum generierten Link tätigen.

Bevor Sie den Wert payment_sum setzen, setzen Sie die Variable bepaid_contract, um den Zweck zukünftiger Zahlungen per Token anzugeben:

  • „recurring“ – für regelmäßige Zahlungen mit einer festgelegten Häufigkeit
  • „card_on_file“ – für einmalige oder unregelmäßige Zahlungen, z. B. Nachzahlung für eine Dienstleistung

Die Option „card_on_file“ wird nicht von allen Acquirern unterstützt. Wenn Sie sie verwenden möchten, wenden Sie sich bitte an Ihren Account Manager.

Nach einer erfolgreichen Zahlung wird dem Deal die Variable bepaid_client_card_token hinzugefügt, die das Kartentoken des Kunden speichert. Mit diesem Token können Sie die Karte des Kunden ohne dessen Beteiligung belasten.

Richten Sie als Nächstes Ihren Trichter ein und geben Sie ein Datum oder eine Bedingung für die automatische Belastung an, rufen Sie dann die Funktion make_bepaid_token_payment auf und übergeben Sie die erforderlichen Parameter.

Parameterreihenfolge:
amount → currency → description → contract

Parameterbeschreibungen

Der Wert von contract muss genau mit dem Wert übereinstimmen, der bei der Erstellung des ersten Zahlungslinks angegeben wurde!

Wenn die Zahlung erfolgreich ist, gibt die Funktion die Meldung „Successful charge via bePaid token“ zurück, Sie erhalten einen Callback für die erfolgreiche Zahlung, und die Deal-Variable bepaid_token_payment_completed wird auf „True“ gesetzt.

Wenn die Zahlung fehlschlägt, gibt die Funktion eine Meldung mit dem Grund für die fehlgeschlagene Zahlung zurück, ein Callback mit dem Suffix „_fail“ wird an den Bot gesendet, und die Deal-Variable bepaid_token_payment_completed wird auf „False“ gesetzt.

Die Bank kann verlangen, dass der Kunde die Zahlung abschließt. In diesem Fall gibt die Funktion einen Link zurück, der den Kunden auffordert, eine 3-D-Secure-Authentifizierung durchzuführen.

So verarbeiten Sie das Ergebnis

Als Reaktion auf Kundenaktionen erhält der Bot Callbacks, die aus den ersten 20 Zeichen des geheimen Schlüssels und einem Suffix bestehen, der von der Art und dem Ergebnis des Vorgangs abhängt.

Im System erscheint der Callback als Nachricht vom Benutzer, aber der Benutzer sieht ihn nicht.

Für Zahlungen

Für Zahlungen, die nicht mit Abonnements zusammenhängen, erhalten Sie eine der folgenden Nachrichten:

  • keyNumber_success – für eine erfolgreiche Zahlung
  • keyNumber_fail – für eine fehlgeschlagene Zahlung

Sie können den Status der letzten Zahlung auch mit den Variablen verfolgen:

  • bepaid_payment_completed – für Zahlungen mit Beteiligung des Kunden
  • bepaid_token_payment_completed – für automatische Zahlungen per Kartentoken

Für Abonnements

Nachdem ein Abonnement erfolgreich aktiviert wurde, entweder bei der ersten oder einer wiederkehrenden Zahlung, erhält der Bot die Nachricht keyNumber_success.

Wenn das Abonnement gekündigt wird, erhalten Sie keyNumber_canceled.

Im Falle einer fehlgeschlagenen Abonnementzahlung wird die Nachricht keyNumber_fail gesendet.