# INXY payments

## Inscription

Après l’inscription au service [https://auth.inxy.io/ ](<https://auth.inxy.io/ >) allez dans le menu de l’API de passerelle de paiement et renseignez les informations suivantes :

1. Nom et description du portefeuille, icône.
2. 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

<figure><img src="/files/1c86abb5f8031f16f8e7778ed602644b3aa5ea33" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/7ef4439a1140b9b2bfc49b6f86288fc99eee8917" alt=""><figcaption></figcaption></figure>

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.

{% hint style="success" %}
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).
{% endhint %}

Dans le champ Postback Url (2), indiquez l’URL des webhooks <https://chatter.salebot.pro/inxy\\_callback/result>

<figure><img src="/files/d360f2b37c1194cbabd29202fa66700ffee16f68" alt=""><figcaption></figcaption></figure>

## Paramètres de connexion&#x20;

Ensuite, allez dans Mavibot → section « Acquiring » → INXY et cliquez sur <mark style="background-color:blue;">**connecter**</mark>. Saisissez les clés API et Secret reçues dans les champs.

<figure><img src="/files/9de7fede7795a751f0f2e77df07608b2a9176aed" alt=""><figcaption><p>section « Acquiring » dans Mavibot </p></figcaption></figure>

<figure><img src="/files/6cfec084999ebc2ebe717c4a946fc0ee790ee96c" alt=""><figcaption><p>Paramètres INXY dans la section « Acquiring » de Mavibot</p></figcaption></figure>

## 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 ».

{% hint style="warning" %} <mark style="color:red;">**ATTENTION !!!**</mark> 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.
{% endhint %}

Le lien ressemble à ceci : [https://pay.inxy.io/sessions/umLf9cJWBRiaNwowGCE1 ](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é.

{% hint style="info" %}
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.&#x20;
{% endhint %}

Valeurs disponibles : 'BTC', 'ETH', 'LTC', 'DOGE', 'USDT', 'USDC', 'DAI'

<figure><img src="/files/bc56a0e365e69fe32747b4ab475bbb572f3059e9" alt=""><figcaption></figcaption></figure>

**inxy\_description** – description du paiement

<figure><img src="/files/bf55e608151de56b0e20a8e8ed4dafed8a2b5379" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**À noter**</mark>! Tout d’abord, les variables supplémentaires sont définies pour les paramètres, puis payment\_sum.
{% endhint %}

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.

<figure><img src="/files/074cb83a6a1756c0da16f00bff267fcce53fe418" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**Attention !**</mark> 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.
{% endhint %}

<figure><img src="/files/81a1fb9da91fbc95dd009d1795f14f753286fb03" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:red;">**Attention !!!**</mark> 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.
{% endhint %}

## 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 :

1. Les callbacks de réussite se composent des 10 premiers caractères du jeton et du suffixe de réussite, par exemple : uc8zsjNN1x\_success

<figure><img src="/files/21d934d65b69f9dc681f3451f1397503ac289280" alt=""><figcaption><p>Un callback de paiement réussi dans une conversation avec le client</p></figcaption></figure>

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.

{% hint style="warning" %}
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.
{% endhint %}

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 :

<figure><img src="/files/808a6ea5aeeb295c57c585087a1d096f1df6afcb" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/ec6aa81beef6a6b285992fb0d2b1137718dcc705" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/63a71eb377de568125906fa712a383e87ba08992" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
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.
{% endhint %}

## 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)

<figure><img src="/files/5db15e9f32a1a46a4d93ab310f6149b76568333e" alt=""><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
F**onctionnalité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.
{% endhint %}

{% hint style="warning" %}
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.
{% endhint %}

<figure><img src="/files/8adcb20466fa08cc3a8ef99efd2a4caa495a8e29" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/53479d99213fc76f7893075cb1430251690d2a0d" alt="" width="385"><figcaption></figcaption></figure>

## 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é.

<figure><img src="/files/1245d1c1bdedded1844b43276ef688e7a7ecd2cd" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/8a1478eee3c7a26f44c7f93442fbd22bc5a876b3" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/paiement/inxy-payments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.