INXY Payments

Plateforme de cryptoprocessing avec fonctionnalités récurrentes

Inscription

Après vous être inscrit sur le service https://auth.inxy.io/, allez dans API de passerelle de paiement dans le menu de gauche et renseignez les données suivantes : le nom et la description du portefeuille ainsi que l’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 avec les données de connexion s’ouvrira. Ensuite, générez la clé API en cliquant sur le bouton Générer (1) et saisissez le code envoyé à votre adresse e-mail. Enregistrez la variable obtenue en lieu sûr. Copiez la Secret Key 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 des webhooks https://chatter.salebot.pro/inxy_callback/result dans le champ Postback URL (2).

Configuration de la connexion

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

capture d’écran de la connexion depuis Salebot

Génération du lien de paiement

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

ATTENTION ! 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 ce qui suit variables optionnelles pour la configuration du paiement inxy_currency — cryptomonnaie qui sera utilisée pour le paiement. Vous pouvez saisir l’une des cryptomonnaies disponibles que vous avez choisies à l’aide des cases à cocher lors de la génération de la clé API. Si elle est laissée vide, les joueurs choisissent eux-mêmes la cryptomonnaie dans la liste des cryptomonnaies sélectionnées. Valeurs disponibles : ‘BTC’,‘ETH’,‘LTC’,‘DOGE’,‘USDT’,‘USDC’,‘DAI’

inxy_description – description du paiement.

ATTENTION ! D’abord, vous saisissez les variables facultatives pour la configuration, puis payment_sum.

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

ATTENTION ! 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.

ATTENTION ! L’adresse du portefeuille pour le paiement au cours d’une session unique est réservée au client pendant seulement 2 heures. Il est recommandé 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é depuis le début.

Callback de paiement

Après le paiement réussi, le bot recevra un callback indiquant que le paiement a bien été effectué. Vous voyez ce callback dans le système comme un message de l’utilisateur, afin que l’utilisateur ne puisse pas l’envoyer. Les utilisateurs eux-mêmes NE PEUVENT PAS VOIR le callback, seul l’opérateur peut le voir. INXY dispose de plusieurs types de callbacks :

1. Les callbacks de succès se composent des 10 premiers symboles du jeton suivis de « success », par ex. : 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 prendra la valeur True ; et inxy_payment_status avec la valeur payée.

Pendant le processus, la inxy_payment_status variable change de valeur. Après l’ouverture du formulaire par l’utilisateur, elle passera à waiting_payment ; pendant le traitement du paiement, elle passera à waiting_confirmation ; et après le traitement réussi, elle prendra la valeur paid ou partially_paid.

Pendant le traitement du callback, le type de comparaison doit être Correspondance exacte. Par ex. : vous pouvez faire du traitement de paiement réussi un bloc avec 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 reçu n’est pas complet. Dans de tels 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 envoyer au client un message lui demandant de couvrir le montant manquant. Par ex. : vous pouvez définir une condition au 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 valable que pendant 2 heures ! Si le client ne règle pas à temps le montant manquant, il ne pourra plus être ouvert. Comme INXY traitera à ce stade le premier paiement partiel, l’argent ne sera pas retourné au client. Pour le restituer, vous devrez aller dans votre compte INXY et effectuer l’opération de remboursement.

Création d’un abonnement

Le système INXY permet aux utilisateurs de créer des abonnements. Pour cela, ajoutez n’importe quelle valeur à inxy_subscription_payment la variable, et un abonnement mensuel sera créé. Si vous souhaitez définir une autre période, utilisez les variables suivantes : inxy_subscription_interval égal à ‘day’ — créera un intervalle d’abonnement égal à des jours (la valeur par défaut est month) inxy_subscription_period — ajoutez une variable égale de 1 à 30 pour définir la période. Par ex. 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 égal à month par défaut)

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 suggérera au client d’ajouter un acompte pour plusieurs paiements à l’avance.

Spécificités INXY: Si le client paie х2 ou х3 du montant, Salebot recevra un message concernant un montant unique. Le reste sera crédité sur le solde du client et sera utilisé pour les paiements à venir. Comme le taux de change des cryptomonnaies varie, à terme ce montant peut être insuffisant pour l’un des paiements suivants, ce qui entraînera un abonnement impayé. Dans un tel cas, vous recevrez un callback indiquant « fail » et vous pourrez mettre en place un rappel pour votre client.

Un 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 « Subscription status inxy_subscription_id - deleted » et la variable inxy_subscription_status changera pour la valeur correspondante.