Registrierung

Nach der Registrierung im Dienst https://auth.inxy.io/ gehen Sie im linken Seitenmenü zu Payment Gateway API und füllen Sie die folgenden Daten aus - Name und Beschreibung der Wallet sowie ein Symbol. Der Link zu Ihrer Website ist optional. Wählen Sie alle Kryptowährungen, die Sie akzeptieren möchten, mit einem Häkchen aus und klicken Sie auf Änderungen speichern.


Nach dem Speichern öffnet sich das Fenster mit den Verbindungsdaten. Generieren Sie als Nächstes den API-Schlüssel, indem Sie auf die Schaltfläche Generieren (1) klicken, und geben Sie den Code ein, der an Ihre E-Mail gesendet wurde. Bewahren Sie die resultierende Variable an einem sicheren Ort auf. Kopieren Sie den generierten Secret Key an derselben Stelle. Schlüssel können bei Verlust neu generiert werden (in diesem Fall denken Sie daran, die Daten im Projekt zu ändern). Geben Sie die URL für Webhooks https://chatter.mavibot.ai/inxy\_callback/result im Feld Postback-URL (2) ein.


Verbindungseinrichtung

Gehen Sie dann zu Mavibot — Zahlungssysteme — INXY und klicken Sie auf die Schaltfläche Verbinden. Geben Sie die erhaltenen API- und Secret-Keys in die Felder ein.

Screenshot zur Verbindung aus Mavibot

Um einen Zahlungslink zu generieren, geben Sie den Wert der Variable payment_sum ein (z. B.: 1). Danach erscheint die Variable inxy_pay_url. Sie können diese Variable auf dem Bildschirm als Link hinzufügen oder in den Button Bezahlen einfügen.

HINWEIS! Das System arbeitet mit USD! Der Betrag in der Variable payment_sum wird im INXY-Zahlungssystem als USD betrachtet.

Der Link sieht so aus: https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

Außerdem können Sie vor der Eingabe des Betrags für die Variable payment_sum die folgenden optionalen Variablen für die Zahlungseinrichtung eingeben
inxy_currency — die Kryptowährung, die für die Zahlung verwendet wird. Sie können eine der verfügbaren Kryptowährungen eingeben, die Sie bei der Generierung des API-Schlüssels mit einem Häkchen ausgewählt haben. Wenn Sie das Feld leer lassen, wählen die Spieler die Kryptowährung selbst aus der Liste der ausgewählten. Verfügbare Werte: 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

inxy_description – Zahlungsbeschreibung.

HINWEIS! Zuerst geben Sie optionale Variablen für die Einrichtung ein, und dann die payment_sum.

Variablen können früher in der Kette eingegeben werden, und nicht in einem einzigen Block. Während die Variable inxy_pay_url, die den Link enthält, an der richtigen Stelle ausgegeben werden sollte. Dieser Link öffnet das Zahlungsformular.

HINWEIS! Die Zeile Gesamtbetrag zeigt den Wert in USD, der der payment_sum entspricht. Der Gesamtbetrag in Krypto unten zeigt den Wert in der gewählten Kryptowährung. Er variiert je nach aktuellem Wechselkurs. Dies ist der Betrag, den Ihr Kunde von seiner Wallet an Sie zahlen muss.

HINWEIS! Die Wallet-Adresse für die Zahlung während einer einzelnen Sitzung ist nur für 2 Stunden für den Kunden reserviert. Empfehlen Sie dem Kunden, sicherzustellen, dass die Zeit nicht abgelaufen ist und die Wallet-Adresse noch gültig ist, wenn die Zahlung erfolgt. Wenn die Sitzungszeit abgelaufen ist — muss der gesamte Zahlungsvorgang neu gestartet werden.

Zahlungs-Callback

Nach der erfolgreichen Zahlung erhält der Bot einen Callback, der Ihnen mitteilt, dass die Zahlung erfolgreich war. Sie sehen diesen Callback im System als Nachricht vom Benutzer, sodass der Benutzer ihn nicht senden kann. Benutzer selbst können den Callback NICHT sehen, nur der Operator kann ihn sehen. INXY hat mehrere Arten von Callbacks:

  1. Erfolgs-Callbacks bestehen aus den ersten 10 Symbolen des Tokens, gefolgt von 'success', z. B.: uc8zsjNN1x_success

Ein solcher Callback wird gesendet, wenn der Kunde den vollen Betrag bezahlt hat und während der Zahlung keine Probleme aufgetreten sind. Zusammen mit diesem Callback werden dem Projekt zwei Variablen hinzugefügt: inxy_payment_completed ist gleich True; und inxy_payment_status mit dem Wert paid.

Während des Prozesses ändert die Variable inxy_payment_status ihren Wert. Nachdem der Benutzer das Formular öffnet, ändert sie sich zu waiting_payment, während der Zahlungsverarbeitung zu waiting_confirmation, und nach der erfolgreichen Verarbeitung hat sie den Wert paid oder partially_paid.

Während der Callback-Verarbeitung sollte der Vergleichstyp Vollständige Übereinstimmung sein. Z. B.: Sie können die erfolgreiche Zahlungsverarbeitung als Block mit Bedingung gestalten und dem Benutzer eine relevante Nachricht anzeigen:

2. Manchmal ändern sich die Wechselkurse von Kryptowährungen oder Wallets erheben zusätzliche Gebühren für Transaktionen, sodass der resultierende Betrag, den Sie erhalten haben, nicht vollständig ist. In solchen Fällen hat die Variable inxy_payment_status den Wert partially_paid und das System erhält einen Callback, der so aussieht:


In diesem Fall müssen Sie den Kunden mit der Bitte kontaktieren, den fehlenden Betrag zu decken. Z. B.: Sie können eine Bedingung für den Beginn Ihres Callbacks festlegen und beim Erhalt dem Kunden eine vorab generierte URL mit einem Zahlungslink senden, oder Sie können eine Bedingung festlegen, dass der Block aktiviert wird, wenn der Wert der Variable inxy_payment_status partially_paid ist.

Denken Sie daran, dass der Zahlungslink nur 2 Stunden gültig ist! Wenn der Kunde die Zahlung des fehlenden Betrags nicht rechtzeitig vornimmt, kann er nicht geöffnet werden. Da INXY in dieser Phase die erste Teilzahlung verarbeitet, wird das Geld nicht an den Kunden zurückgegeben. Um es zurückzugeben, müssen Sie sich in Ihr INXY-Konto einloggen und die Rückgabeoperation durchführen.

Abonnement erstellen

Das INXY-System ermöglicht es Benutzern, Abonnements zu erstellen. Fügen Sie dazu einen beliebigen Wert zur Variable inxy_subscription_payment hinzu, und ein monatliches Abonnement wird erstellt. Wenn Sie einen anderen Zeitraum festlegen möchten, verwenden Sie die folgenden Variablen:
inxy_subscription_interval gleich 'day' — erstellt ein Abonnementintervall in Tagen (Standard ist Monat)
inxy_subscription_period — fügen Sie eine Variable von 1 bis 30 hinzu, um den Zeitraum festzulegen. Z. B. Um eine Abonnementzahlung einmal alle 15 Tage zu erstellen, setzen Sie inxy_subscription_interval ='day' und inxy_subscription_period=15, und für die Zahlung zweimal im Jahr setzen Sie inxy_subscription_period=6 (da inxy_subscription_interval standardmäßig Monat ist)

Der Link öffnet auch das Zahlungsformular, aber es wird anders sein: Erstens wird seitlich angezeigt, dass die Zahlung abonnementbasiert ist mit angezeigtem Zeitraum, zweitens schlägt das Formular dem Kunden vor, eine Einzahlung für mehrere Zahlungen im Voraus zu tätigen.

INXY-Besonderheiten: Wenn der Kunde das 2- oder 3-fache des Betrags zahlt, erhält Mavibot eine Nachricht über einen einzelnen Betrag. Der Rest wird auf dem Kundenkonto gutgeschrieben und für die kommenden Zahlungen verwendet. Da der Wechselkurs von Kryptowährungen variiert, kann dieser Betrag am Ende für eine der folgenden Zahlungen nicht ausreichen, was zu einem unbezahlten Abonnement führt. In einem solchen Fall erhalten Sie einen Callback mit 'fail' und Sie können eine Erinnerung für Ihren Kunden einrichten.

Ein Abonnement kann nicht teilweise bezahlt werden. Das Kundenkonto wird vor der Zahlung überprüft. Wenn nicht genügend Guthaben vorhanden ist, wird die Zahlung überhaupt nicht durchgeführt.

Nach dem erfolgreichen Abonnement enthalten die Kunden-Variablen inxy_subscribtion_id (Referenznummer) und inxy_subscription_status.

Abonnement kündigen

Um ein Abonnement zu kündigen, verwenden Sie die folgende Funktion inxy_remove_subscription(inxy_subscription_id). Geben Sie die Abonnement-ID-Nummer als inxy_subscribtion_id in der Funktion ein, und das Abonnement wird gekündigt.

Im Erfolgsfall erhalten Sie einen Callback 'Subscription status inxy_subscription_id - deleted' und die Variable inxy_subscription_status ändert sich auf den relevanten Wert.