INXY payments
Inscription
Après l’inscription au service https://auth.inxy.io/ allez dans le menu de l’API de passerelle de paiement et renseignez les informations suivantes :
Nom et description du portefeuille, icône.
Le lien vers le site web est placé à votre demande.
Tous les types de cryptomonnaies acceptés doivent être cochés, puis 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 e-mail.
La variable reçue doit être stockée dans un emplacement sécurisé. Copiez-y également la clé secrète.
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), indiquez l’URL des webhooks https://chatter.salebot.pro/inxy_callback/result
Paramètres de connexion
Ensuite, allez dans Mavibot → section « Acquiring » → INXY et cliquez sur connecter. Saisissez les clés API et Secret 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). Après cela, la variable inxy_pay_url apparaîtra. Cette variable peut être affichée sous forme de 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 à ceci : 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 cryptomonnaie dans laquelle le paiement sera effectué.
Vous pouvez spécifier l’une des cryptomonnaies possibles que vous avez cochées lors de la création de la clé API. Si vous laissez ce champ vide, le payeur choisira la cryptomonnaie parmi celles qui ont été marquées.
Valeurs disponibles : 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'
inxy_description – description du paiement
À noter! Tout 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. En dessous, dans le montant total en crypto, se trouve la valeur dans la cryptomonnaie sélectionnée. Elle change fréquemment en fonction du taux de change actuel. C’est le montant que le client doit vous payer depuis son portefeuille.
Attention !!! L’adresse du portefeuille pour le paiement, dans une même session, est réservée au client pendant seulement 2 heures. Recommandez au client de s’assurer que le délai n’a pas expiré et que l’adresse du portefeuille est bien valide au moment du paiement. Si le délai de la session est dépassé, vous devrez recommencer 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, ce qui vous indiquera que le paiement a réussi. Vous voyez ce callback dans le système comme un message de l’utilisateur, afin que l’utilisateur ne puisse pas l’envoyer. Ce callback n’est PAS VU par l’utilisateur lui-même, il est affiché uniquement à l’opérateur. INXY a plusieurs types de callbacks :
Les callbacks de réussite se composent des 10 premiers caractères du jeton et du suffixe de réussite, par exemple : uc8zsjNN1x_success
Ce callback est reçu si le client a entièrement payé le montant et qu’il n’y a aucun problème avec le paiement. Avec ce callback, inxy_payment_completed la variable sera ajoutée aux variables du projet, et sera définie sur True. Et aussi inxy_payment_status la variable prendra la valeur paid.
La variable inxy_payment_status peut changer de valeur tout au long de la période de traitement du paiement. Après que l’utilisateur ouvre 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 cryptomonnaie 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 complément de paiement.
Par exemple, vous pouvez définir une condition pour le début du callback et, après l’avoir obtenu, renvoyer au client l’URL déjà générée avec un lien de paiement, ou définir une condition selon laquelle le bloc est déclenché lorsque la variable inxy_payment_status est égale à partially_paid.
Veuillez noter que le lien de paiement est uniquement valide pendant 2 heures ! Si le client n’a pas le temps de payer le montant restant, il ne pourra plus l’ouvrir. Comme INXY traitera déjà le premier paiement incomplet à ce stade, l’argent ne sera pas remboursé au client. Pour le restituer, vous devrez vous rendre dans votre espace personnel INXY et effectuer une opération de remboursement.
Création d’un abonnement
Les abonnements peuvent être créés dans le système INXY. Pour cela, attribuez une valeur quelconque à la inxy_subscription_payment variable, puis un abonnement mensuel sera créé.
Si vous souhaitez définir une période différente, utilisez les variables suivantes : inxy_subscription_interval égal à « day » - définit l’intervalle à des 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 vous suffit de spécifier inxy_subscription_period=6 (puisque inxy_subscription_interval est un mois par défaut)
En suivant le lien, l’utilisateur verra la même page de paiement, mais avec quelques différences : premièrement, une note apparaîtra sur le côté indiquant que le paiement fait partie d’un abonnement avec la fréquence spécifiée ; et deuxièmement, la page de paiement offrira au client la possibilité de payer deux ou trois montants à l’avance.
Fonctionnalités du système de paiement INXY : Si le client paie x2 ou x3 du montant, Mavibot recevra une notification concernant le paiement d’un seul d’entre eux. Le montant restant sera envoyé au solde du client, d’où il sera prélevé lors des débits suivants. Comme le taux de change de la cryptomonnaie change constamment, ce montant peut ne pas suffire pour le débit suivant, ce qui conduira à une situation d’abonnement partiellement payé. Dans ce cas, vous recevrez un callback « fail » et vous pourrez configurer un rappel au client.
Il ne peut pas y avoir de paiement partiel selon le calendrier. Le solde est vérifié avant le paiement, et s’il est insuffisant, l’argent ne sera pas débité du compte du client.
Après un abonnement réussi, inxy_subscription_id la variable 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 le inxy_subscription_status la variable changera pour la valeur appropriée.
Mis à jour