Anbindung des Zahlungssystems
Anbindung auf Telegram-Seite
Schritt 1. Melden Sie sich in Ihrem Partnerkonto an
Klicken Sie auf der geöffneten Seite auf „Über Telegram anmelden“, geben Sie dann im Pop-up-Fenster „oauth.telegram.org“ Ihre Telefonnummer ein und klicken Sie auf „Anwenden“.
Es ist erforderlich, das Zahlungssystem sowohl über den Webbrowser als auch über die Anwendung zu verbinden:
- Sie erhalten eine Telegram-Nachricht mit der Aufforderung zur Autorisierung – klicken Sie auf „Anwenden“.
- Sie müssen auch im Pop-up-Fenster „oauth.telegram.org“ in einem Webbrowser auf „Anwenden“ klicken.
Es wird empfohlen, ein Konto zu verwenden, auf das die für Finanzen zuständige Person Zugriff hat. Für juristische Personen – ein bevollmächtigter Vertreter.
Schritt 2. Füllen Sie eine kurze Umfrage aus
Wenn Sie sich zum ersten Mal anmelden oder zusätzliche Informationen benötigt werden, bietet WalletPay Ihnen an, einige Fragen zu beantworten, um detailliertere Informationen zu erhalten. Es gibt zwei Schritte:
1. Fragebogen
2. KYB- (Know Your Business) oder KYC- (Know Your Customer) Prüfungen
Nach Abschluss wird Ihr Antrag bald geprüft und Sie werden über das Ergebnis informiert. Bei Erfolg sehen Sie die vom Dienst erhobene Gebühr und erhalten Zugang zu Ihrem Konto, wo Sie mit der Integration beginnen können.
Für juristische Personen kann das Formular nur von einer vertrauenswürdigen Person ausgefüllt werden: einem Geschäftsführer oder einem Mitarbeiter per Vollmacht.
Schritt 3. Erstellen Sie den ersten „Store“.
Nach erfolgreichem Abschluss der „Umfrage“ werden Sie aufgefordert, Ihren ersten Store zu erstellen.
Schritt 4. Erstellen Sie einen „API-Key“
Nach der Benennung des ersten Stores werden Sie aufgefordert, ihn einzurichten:
- Generieren Sie einen API-Key.
- Kopieren Sie Ihren API-Key und beginnen Sie mit der Integration in Mavibot.
Schritt 5. Erstellen Sie eine Bestellung und erhalten Sie einen Zahlungslink
Wenn Sie einen Link in einen Button einfügen möchten, verwenden Sie Inline-Button.
Bitte beachten Sie, dass nur die angegebene „customerTelegramUserId“ die Zahlungsseite öffnen kann.
Schritt 6. Geld abheben
Nachdem der Kunde die Zahlung bestätigt hat, wird das Geld Ihrem Guthaben gutgeschrieben und standardmäßig 48 Stunden lang einbehalten. Nach Ablauf dieser Zeit können Sie das Geld auf das Guthaben Ihres Wallets abheben, das Sie für die Anmeldung beim Wallet Pay-Dienst verwendet haben.
Schritt 7. Rückerstattung
Derzeit ist das Abheben von Geldern von Ihrem Wallet-Konto möglich, das Sie für die Anmeldung bei WalletPay verwenden. Bald wird es jedoch auch in Ihrem Merchant-Konto verfügbar sein.
Wie sieht der Zahlungsbutton aus?
Stellen Sie bei der Integration Ihres Telegram-Bots mit der „Wallet Pay API“ sicher, dass der Zahlungsbutton den folgenden Empfehlungen entspricht:
- Benannt auf eine der beiden Arten:
- 👛 Wallet Pay
- 👛 Bezahlen mit Wallet
- Oberhalb der anderen Buttons platziert (falls vorhanden).
Hinweis. 👛 — это смайлик (siehe https://emojipedia.org/purse/).
Siehe das Beispiel im [Demo Store Bot].
Verbindung zu Mavibot
Melden Sie sich im Projekt an und klicken Sie im Bereich „Zahlungssysteme“ auf die Schaltfläche „Verbinden“ für Wallet Pay.
Geben Sie im geöffneten Fenster den API-Key ein, der für Ihren WalletPay-Store generiert wurde.
- Fertig! Jetzt können Kunden Einkäufe in Ihrem Store mit Kryptowährungen (USDT, Toncoin und Bitcoin) über den Wallet Pay-Dienst bezahlen.
So generieren Sie einen Zahlungslink
Erstellen Sie einen Funnel-Constructor-Block und rufen Sie die Funktion „wallet_pay_generate_payment_url“ im Rechner auf, indem Sie die erforderlichen Parameter übergeben:
| Parameter | Parameterbeschreibung |
|---|---|
| amount | der Zahlungsbetrag in Kryptowährung oder einer anderen Fiat-Währung, die in „TON“ umgewandelt werden kann. |
| сurrency_code | Die Standardzahlungswährung ist „RUB". Liste der verfügbaren Währungen: „TON“ „BTC“ „USDT“ „EUR“ „USD“ „RUB“ |
| description | eine kurze Beschreibung der Bestellung von 5 bis 100 Zeichen. |
| timeout_seconds | Die Gültigkeitsdauer des Links in Sekunden, standardmäßig 3600 Sekunden. |
Wenn der Block in einem Chat mit einem Bot ausgelöst wird, erhält der Kunde einen Zahlungslink, und die Client-Variable wallet_pay_payment_completed wird mit dem Wert False erstellt.
Dieser Link kann nur in einem Chat mit einem Bot geöffnet werden, der mit einem WalletPay-Abrechnungskonto verbunden ist.
Zahlungsüberprüfung
Nach erfolgreicher Zahlung wird die Variable wallet_pay_payment_completed des Kunden auf True gesetzt, und der Verkäufer erhält einen Callback in Form von 4690FE98_success, der sich zusammensetzt aus:
- „4690FE98“ – dies sind die ersten 8 Zeichen des Wallet Pay API-Keys.
- dem Wort für erfolgreich
! Bei einem Zahlungsfehler erhalten Sie einen Callback mit dem Suffix „_fail“.
Adresse für Benachrichtigungen (Callbacks): https://chatter.salebot.pro/wallet_pay/payment_callback – wird in den Zahlungssystemeinstellungen eingefügt
Ein Callback kann in die Blockbedingung eingebettet werden, um dem Kunden eine Nachricht über eine erfolgreiche Zahlung (oder einen Zahlungsfehler) zu senden:
Wenn Sie den Kunden nicht aus dem Haupt-Chatbot-Schema werfen möchten, verwenden Sie den Block „Zustandslose Bedingung“. Sie können nicht zu diesem Block gehen, sodass der Kunde nach der Zahlung nicht aus dem Haupt-Funnel geworfen wird und eine Benachrichtigung über die erfolgreiche Zahlung erhält.\
Und wenn Sie den Funnel mit einer Reaktion auf eine erfolgreiche Zahlung fortsetzen müssen, verwenden Sie den Block „Startbedingung“. Dann wechselt der Kunde vom Zahlungsblock zum Block „Startbedingung“, von wo aus Sie den Funnel fortsetzen können.
Weitere Informationen zu Bedingungsblöcken finden Sie im gleichnamigen Artikel. über Bedingungsblöcke haben wir berichtet