- Wie verbinde ich mich?
- Wie erstelle ich einen Link?
- Wie verarbeite ich das Ergebnis?
- Wie führe ich Testzahlungen durch?
Wie verbinde ich mich?
Um das Fondy-Zahlungssystem zu verbinden, benötigen Sie eine Händler-ID und einen geheimen Schlüssel. Nachdem Sie diese erhalten haben, gehen Sie zu den Einstellungen in Mavibot.
In Mavibot öffnen Sie den Bereich Zahlungssysteme und wählen Fondy aus. Sie müssen die erhaltenen Daten eingeben.
Um einen Link zu einer Zahlung zu generieren, müssen Sie den Wert der Variable payment_sum festlegen (z. B. 150 oder 100.55 (mit einem Punkt!)), unmittelbar danach erscheint die Variable fondy_pay_url. Diese Variable kann mit einem Link angezeigt oder auf einen Button mit dem Text „Bezahlen“ gesetzt werden.
Der Link hat die Form:
Außerdem können Sie vor dem Festlegen des Werts von payment_sum die folgenden optionalen Variablen zur Konfiguration der Zahlung angeben.
Die Standardeinstellung ist UAH. Wenn Sie eine andere Währung benötigen, müssen Sie den Wert der Variable currency festlegen.
currency - Bestellwährung.
Gültige Werte:
UAH - Ukrainische Griwna
RUB - Russischer Rubel
USD - US-Dollar
EUR - Euro
GBP - Pfund Sterling
CZK - Tschechische Krone
payment_description - Bestellbeschreibung
session_timeout - Lebensdauer der Bestellung in Sekunden.
Standard (36000 Sekunden = 10 Stunden).
language - Sprache der Zahlungsseite:
ru - Russisch
uk - Ukrainisch
en - Englisch
lv - Lettisch
fr - Französisch
cs - Tschechisch
ro - Rumänisch
it - Italienisch
sk - Slowakisch
pl - Polnisch
es - Spanisch
hu - Ungarisch
de - Deutsch
Wie erstelle ich einen Link?
Erstellen Sie einen Link zur Zahlung von 122 UAH (Standard Griwna)
Bitte beachten Sie:
- Geben Sie zuerst die optionalen Parameter payment_description usw. an.
- Und zuletzt weisen Sie den Wert der Variable payment_sum zu.
Beachten Sie, dass wir zuerst die zusätzlichen Variablen für die Einstellungen festlegen, dann payment_sum. Sie können Variablen auch früher in einer Kette definieren, nicht nur in einem einzigen Block – dies ist nur ein Beispiel.
Geben Sie anschließend an der gewünschten Stelle die Variable fondy_pay_url aus, die den Link enthält.
Wie verarbeite ich das Ergebnis?
Nach erfolgreicher Zahlung kommen im Bot Callbacks an, anhand derer Sie erkennen können, dass eine erfolgreiche Zahlung stattgefunden hat. Diese Callbacks werden im System als Nachrichten vom Benutzer angezeigt, sodass sie nicht vom Benutzer gesendet werden können. Sie bestehen aus den ersten 5 Zeichen des geheimen Schlüssels und dem Wort success, z. B.: h4fd56_success
Wenn das Passwort kürzer als 5 Zeichen ist, wird das gesamte Passwort verwendet. Für Testzahlungen lautet das Passwort beispielsweise test, dann kommt der Callback test_success.
Diese Callbacks sind für den Benutzer NICHT sichtbar, sie werden nur dem Operator angezeigt.
Der Vergleichstyp sollte „Vollständige Übereinstimmung“ sein.
Außerdem wird nach erfolgreicher Zahlung die Variable fondy_payment_completed auf True gesetzt.
Sie können beispielsweise einen Block zur Verarbeitung erfolgreicher Zahlungen mit einer Bedingung erstellen und die entsprechende Nachricht an den Benutzer ausgeben:
Nach Abschluss der Zahlung wird dem Kunden die Variable fondy_callback_data hinzugefügt, die die Antwortdaten des Zahlungssystems für die abgeschlossene Transaktion enthält. Sie können die erforderlichen Daten aus dem Wörterbuch mit der get-Methode extrahieren.
Um eine erneute Zahlung durchzuführen, müssen Sie payment_sum und den zuvor generierten Link zurücksetzen. Nachdem Sie die Variable payment_sum zurückgesetzt haben, erhalten Sie einen neuen Link. Sie können einen vorherigen Wert angeben.
Wie führe ich Testzahlungen durch?
Testdaten zum Zeitpunkt der Veröffentlichung der Dokumentation:
Händler-ID: 1396424
Passwort: test
Testkartennummern
44445566661111 - Erfolgreich
4444111166665555 - Ablehnung
Gültigkeitsdauer und CVV2 beliebig
Wenn etwas nicht funktioniert, vergleichen Sie die Daten mit den Daten auf der offiziellen Website: https://docs.fondy.eu/ru/docs/page/2/2