Inscription
Après vous être inscrit dans le service https://auth.inxy.io/ , allez dans le menu API de la passerelle de paiement et remplissez les informations suivantes :
- Nom du portefeuille, description et icône.
- Le lien vers le site web est placé à votre demande.
Cochez tous les types de crypto-monnaies acceptés et cliquez sur Enregistrer les modifications.
Après l'enregistrement, un champ de données de communication s'ouvrira.
Ensuite, générez une clé API en cliquant sur Générer(1) et saisissez le code envoyé à votre adresse e-mail.
La variable reçue doit être stockée dans un endroit sécurisé. Copiez également la clé secrète ici.
Les clés, en cas de perte, peuvent être régénérées (si cela se produit, n'oubliez pas de modifier les données dans le projet).
Dans le champ Postback Url (2), spécifiez l'URL pour les webhooks https://chatter.salebot.pro/inxy\\_callback/result
Paramètres de connexion
Ensuite, allez dans Mavibot → section "Acquiring" → INXY et cliquez sur connect. Saisissez les clés API et secrète reçues dans les champs.
Génération d'un lien de paiement
Pour générer un lien de paiement, vous devez définir la valeur de la variable payment_sum (par exemple, 1). Ensuite, la variable inxy_pay_url apparaîtra. Cette variable peut être affichée avec un lien ou placée dans le bouton "Payer".
ATTENTION !!! Le système fonctionne avec des dollars ! Le montant spécifié dans payment_sum sera accepté par le système de paiement INXY comme des dollars.
Le lien ressemble à : https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1
De plus, avant de définir la valeur de la variable payment_sum, vous pouvez définir les variables optionnelles suivantes pour configurer le paiement :
inxy_currency - la crypto-monnaie dans laquelle le paiement sera effectué.
Vous pouvez spécifier l'une des crypto-monnaies possibles que vous avez cochées lors de la création de la clé API. Si vous laissez vide, le payeur choisira la crypto-monnaie parmi celles qui ont été marquées..
Valeurs disponibles : 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description – description du paiement
Attention ! D'abord, les variables supplémentaires sont définies pour les paramètres, puis payment_sum.
Les variables peuvent être définies plus tôt dans la chaîne, plutôt que toutes dans un seul bloc. Et la variable inxy_pay_url, qui contient le lien, doit être affichée au bon endroit. Lorsque vous cliquez dessus, un formulaire de paiement s'ouvrira.
Attention ! La ligne du montant total contient une valeur en dollars égale à payment_sum. Ci-dessous, dans le montant total en crypto, se trouve la valeur dans la crypto-monnaie sélectionnée. Elle change fréquemment en fonction du taux de change actuel. C'est la valeur que le client doit vous payer depuis son portefeuille.
Attention !!! L'adresse du portefeuille pour le paiement, au sein d'une même session, est réservée au client pour seulement 2 heures. Recommandez au client de s'assurer que le temps n'a pas expiré et que l'adresse du portefeuille est valide au moment du paiement. Si le temps de la session est écoulé, vous devez relancer le processus de paiement.
Traitement du résultat du paiement (callback de paiement)
Après un paiement réussi, un callback sera envoyé au bot, qui vous informera que le paiement a réussi. Vous voyez ce callback dans le système comme un message de l'utilisateur, de sorte que l'utilisateur ne puisse pas les envoyer. Ce callback n'est PAS visible par l'utilisateur lui-même, il est affiché uniquement à l'opérateur. INXY a plusieurs types de callbacks :
- Les callbacks réussis se composent des 10 premiers caractères du token et du postscript success, par exemple : uc8zsjNN1x_success
Ce callback est reçu si le client a entièrement payé la somme et qu'il n'y a aucun problème avec le paiement. Avec ce callback, la variable inxy_payment_completed sera ajoutée aux variables du projet, qui est définie sur True. Et la variable inxy_payment_status prendra la valeur paid.
La variable inxy_payment_status peut changer de valeur pendant toute la période de traitement du paiement. Après que l'utilisateur a ouvert le formulaire, elle prendra le statut waiting_payment, puis pendant le traitement de son paiement, elle prendra la valeur waiting_confirmation, et après un traitement réussi, elle aura la valeur paid ou partially_paid.
Lors du traitement d'un callback, le type de comparaison doit être "Correspondance exacte".
Par exemple, vous pouvez traiter un paiement réussi dans un bloc conditionnel et afficher le message correspondant à l'utilisateur :
2. Il existe des cas où le taux de change de la crypto a changé ou le portefeuille a prélevé une commission sur l'opération, ce qui fait qu'un montant incomplet est crédité sur votre compte. Dans ce cas, la variable inxy_payment_status prendra la valeur partially_paid et un callback sera envoyé au système.
Dans ce cas, vous devrez envoyer une notification au client demandant un paiement supplémentaire.
Par exemple, vous pouvez définir une condition pour le début du callback et, après l'avoir reçu, renvoyer l'URL déjà générée avec un lien de paiement au client, ou définir une condition pour que le bloc se déclenche lorsque la variable inxy_payment_status est égale à partially_paid.
Veuillez noter que le lien de paiement n'est valable que pendant 2 heures ! Si le client n'a pas le temps de payer la partie restante, il ne peut plus l'ouvrir. Comme INXY traitera déjà le premier paiement incomplet à ce stade, l'argent ne sera pas remboursé au client. Pour le rembourser, vous devrez vous rendre dans votre compte personnel INXY et effectuer une opération de remboursement.
Création d'un abonnement
Des abonnements peuvent être créés dans le système INXY. Pour ce faire, attribuez n'importe quelle valeur à la variable inxy_subscription_payment, puis un abonnement mensuel sera créé.
Si vous souhaitez spécifier une période différente, utilisez les variables suivantes : inxy_subscription_interval égal à 'day' - définit l'intervalle en jours (par défaut, c'est un mois)
inxy_subscription_period - spécifiez une variable de 1 à 30 pour définir la fréquence.
Par exemple, pour créer un prélèvement d'abonnement une fois tous les 15 jours, vous devez définir inxy_subscription_interval ='day' et inxy_subscription_period=15, et pour que le paiement soit prélevé tous les six mois, il suffit de spécifier inxy_subscription_period=6 (car inxy_subscription_interval est par défaut un mois)
En suivant le lien, l'utilisateur verra la même page de paiement, mais avec quelques différences : d'abord, il y aura une note sur le côté indiquant que le paiement fait partie d'un abonnement avec la fréquence spécifiée ; ensuite, la page de paiement proposera au client l'option de payer deux ou trois sommes à l'avance.
Fonctionnalités du système de paiement INXY : Si le client paie x2 ou x3 de la somme, Mavibot recevra une notification de paiement pour un seul d'entre eux. Le montant restant sera envoyé sur le solde du client, d'où la somme sera prélevée lors des débits suivants. Comme le taux de change de la crypto-monnaie change constamment, cette somme peut ne pas être suffisante pour le débit suivant, ce qui entraînera une situation d'abonnement incomplètement payé. Dans ce cas, vous recevrez un callback "fail" et vous pourrez configurer un rappel au client.
Il ne peut y avoir de paiement partiel selon le calendrier. Le solde est vérifié avant le paiement, et si le solde n'est pas suffisant, l'argent ne sera pas débité du compte du client.
Après un abonnement réussi, la variable inxy_subscription_id apparaîtra dans les variables du client, indiquant le numéro d'abonnement et inxy_subscription_status avec son statut.
Annulation de l'abonnement
Pour annuler votre abonnement, utilisez la fonction inxy_remove_subscription(inxy_subscription_id). Insérez l'ID d'abonnement inxy_subscription_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 changera à la valeur appropriée.
