Inscription

Après vous être inscrit sur https://auth.inxy.io/, allez dans le menu latéral à la section API de passerelle de paiement et remplissez les données suivantes : nom, description du portefeuille et icône. Le lien vers votre site est facultatif. Sélectionnez toutes les cryptomonnaies que vous souhaitez accepter à l'aide des cases à cocher, puis cliquez sur Enregistrer les modifications.

Après l'enregistrement, la fenêtre contenant les données de connexion s'ouvre. Générez ensuite une clé API en cliquant sur le bouton Générer (1) et saisissez le code envoyé par e-mail. Conservez la variable obtenue dans un endroit sûr. Copiez la clé secrète générée au même endroit. En cas de perte, les clés peuvent être régénérées (dans ce cas, n'oubliez pas de modifier les données dans le projet). Saisissez l'URL pour les webhooks https://chatter.salebot.pro/inxy\_callback/result dans le champ URL de postback (2).

Configuration de la connexion

Ensuite, allez dans Mavibot — Systèmes de paiement — INXY et cliquez sur le bouton Connecter. Saisissez les clés API et secrètes reçues dans les champs.

Capture d'écran de la connexion depuis Mavibot

Génération du lien de paiement

Pour générer un lien de paiement, saisissez la valeur de la variable payment_sum (par exemple : 1), après quoi la variable inxy_pay_url apparaîtra. Vous pouvez ajouter cette variable sur l'écran sous forme de lien ou l'intégrer dans un bouton Payer.

REMARQUE ! Le système fonctionne avec l'USD ! Le montant dans la variable payment_sum est considéré comme étant en USD dans le système de paiement INXY.

Le lien ressemble à ceci : https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1

De plus, avant de saisir le montant pour la variable payment_sum, vous pouvez saisir les variables facultatives suivantes pour la configuration du paiement :
inxy_currency — la cryptomonnaie qui sera utilisée pour le paiement. Vous pouvez saisir l'une des cryptomonnaies disponibles que vous avez sélectionnées avec une case à cocher lors de la génération de la clé API. Si laissé vide, les joueurs choisissent eux-mêmes la cryptomonnaie parmi la liste des cryptomonnaies sélectionnées. Valeurs disponibles : 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'.

inxy_description – description du paiement.

REMARQUE ! Saisissez d'abord les variables facultatives pour la configuration, puis la variable payment_sum.

Les variables peuvent être saisies plus tôt dans la chaîne, et non dans un seul bloc. La variable inxy_pay_url, qui contient le lien, doit être affichée au bon endroit. Ce lien ouvre le formulaire de paiement.

REMARQUE ! La ligne Montant total affiche la valeur en USD, qui correspond à payment_sum. La ligne Montant total en crypto ci-dessous affiche la valeur dans la cryptomonnaie choisie. Elle varie en fonction du taux de change actuel. C'est le montant que votre client doit vous payer depuis son portefeuille.

REMARQUE ! L'adresse du portefeuille pour le paiement lors d'une session unique est réservée au client pour seulement 2 heures. Recommandez au client de vérifier que le temps n'est pas écoulé et que l'adresse du portefeuille est toujours valide au moment du paiement. Si le temps de la session est écoulé, tout le processus de paiement doit être recommencé.

Callback de paiement

Après un paiement réussi, le bot recevra un callback vous informant que le paiement a été effectué avec succès. Vous voyez ce callback dans le système comme un message de l'utilisateur, de sorte que l'utilisateur ne peut pas l'envoyer. Les utilisateurs eux-mêmes NE PEUVENT PAS voir le callback, seul l'opérateur peut le voir. INXY propose plusieurs types de callbacks :

  1. Les callbacks de succès se composent des 10 premiers symboles du token suivis de 'success', par exemple : uc8zsjNN1x_success

Un tel callback est envoyé si le client a payé le montant total et qu'aucun problème n'est survenu pendant le paiement. Avec ce callback, deux variables seront ajoutées au projet : inxy_payment_completed est égal à True ; et inxy_payment_status avec la valeur paid.

Pendant le processus, la variable inxy_payment_status change de valeur. Après que l'utilisateur a ouvert le formulaire, elle passe à waiting_payment, pendant le traitement du paiement, elle passe à waiting_confirmation, et après le traitement réussi, elle prend la valeur paid ou partially_paid.

Lors du traitement du callback, le type de comparaison doit être Correspondance exacte. Par exemple, vous pouvez configurer le traitement du paiement réussi comme un bloc avec une condition et afficher un message pertinent à l'utilisateur :

2. Parfois, les taux de change des cryptomonnaies changent ou les portefeuilles prélèvent des frais supplémentaires sur les opérations, de sorte que le montant final que vous avez reçu n'est pas complet. Dans ce cas, la variable inxy_payment_status prendra la valeur partially_paid et le système recevra un callback qui ressemble à ceci :


Dans ce cas, vous devrez contacter le client pour lui demander de couvrir le montant manquant. Par exemple, vous pouvez définir une condition pour le début de votre callback et, lors de sa réception, envoyer au client une URL pré-générée avec un lien de paiement, ou vous pouvez définir une condition pour que le bloc s'active lorsque la valeur de la variable inxy_payment_status est partially_paid.

N'oubliez pas que le lien de paiement n'est valide que pendant 2 heures ! Si le client ne paie pas le montant manquant à temps, il ne peut pas être ouvert. Comme INXY, à ce stade, traitera le premier paiement partiel, l'argent ne sera pas retourné au client. Pour le retourner, vous devrez vous rendre sur votre compte INXY et effectuer l'opération de retour.

Création d'un abonnement

Le système INXY permet aux utilisateurs de créer des abonnements. Pour ce faire, ajoutez n'importe quelle valeur à la variable inxy_subscription_payment, et un abonnement mensuel sera créé. Si vous souhaitez définir une période différente, utilisez les variables suivantes :
inxy_subscription_interval égal à 'day' — crée un intervalle d'abonnement en jours (par défaut, c'est le mois)
inxy_subscription_period — ajoutez une variable égale de 1 à 30 pour définir la période. Par exemple, pour créer un paiement d'abonnement tous les 15 jours, définissez inxy_subscription_interval = 'day' et inxy_subscription_period = 15, et pour que le paiement soit effectué deux fois par an, définissez inxy_subscription_period = 6 (car inxy_subscription_interval est par défaut égal au mois).

Le lien ouvrira également le formulaire de paiement, mais il sera différent : d'abord, sur le côté, il sera indiqué que le paiement est basé sur un abonnement avec la période affichée, ensuite, le formulaire proposera au client d'ajouter un dépôt pour plusieurs paiements à l'avance.

Spécificités d'INXY : Si le client paie х2 ou х3 du montant, Mavibot recevra un message concernant un seul montant. Le reste sera déposé sur le solde du client et sera utilisé pour les paiements à venir. Comme le taux de change des cryptomonnaies varie, ce montant peut finalement être insuffisant pour l'un des paiements suivants, entraînant un abonnement impayé. Dans ce cas, vous recevrez un callback indiquant 'fail' et vous pourrez configurer un rappel pour votre client.

L'abonnement ne peut pas être payé partiellement. Le solde du client est vérifié avant le paiement. S'il n'y a pas assez de fonds, le paiement n'est pas effectué du tout.

Après un abonnement réussi, les variables du client incluront inxy_subscribtion_id (numéro de référence) et inxy_subscription_status.

Annulation de l'abonnement

Pour annuler un abonnement, utilisez la fonction suivante inxy_remove_subscription(inxy_subscription_id). Saisissez le numéro d'identification de l'abonnement comme inxy_subscribtion_id dans la fonction et l'abonnement sera annulé.

En cas de succès, vous recevrez un callback 'Statut de l'abonnement inxy_subscription_id - supprimé' et la variable inxy_subscription_status passera à la valeur correspondante.