# Coinpayments

* [Comment connecter ](#how-to-connect)
* [Comment créer un lien de paiement ](#how-to-create-a-link-to-payment)
* [Comment traiter le résultat ](#how-to-process-the-result)
* [Comment vérifier le statut du paiement](#how-to-check-the-payment-status)

## Comment connecter&#x20;

Pour connecter le système de paiement Coinpayments, il faudra 4 valeurs : l’ID du vendeur, le secret IPN (pour les webhooks), la clé API privée et la clé API publique, ainsi que définir l’URL du webhook.&#x20;

Allez dans le compte Coinpayments -> Paramètres&#x20;

<https://ww.coinpayments.net/index.php?cmd=acct_settings>

![](/files/0178da4524e060c16f5da03c92755bcfc7405cc4)

Dans le premier onglet, copiez l’ID du vendeur **(ID du vendeur)**

Puis allez dans l’onglet Paramètres du vendeur et trouvez et saisissez la clé secrète IPN - secret IPN (elle est utilisée pour confirmer que le webhook provient de nous ; utilisez une chaîne complexe fiable qui sera difficile à deviner.)&#x20;

**Lien IPN** - adresse URL pour les webhooks, ajoutez ce qui suit : <https://chatter.salebot.pro/coinpayments_callback/result>

Ensuite, allez dans la **Clés API** section et générez une paire de clés pour accéder à l’API.

![](/files/23c7b6f47d865408f83d4f179b57d5b1f70ae813)

**Enregistrer** tous les paramètres, copiez les données et allez dans les paramètres de Salebot. Ouvrez la section sur les systèmes de paiement, sélectionnez **Coinpayments**.

&#x20;                                            ![](/files/0e336d50df92043cd1cbbefc01d745b3d9183091)

Nous devons saisir les données.

![](/files/544c8eb36e6debaff730609a46f69baf3fe85fb0)

Pour générer un lien de paiement, vous devez définir la valeur des variables requises : **original\_currency** - Devise d’origine de la transaction. **sending\_currency** - Devise envoyée par l’acheteur. Par exemple, si vos produits sont tarifés en USD mais que vous recevez du BTC, vous devez utiliser original\_currency = USD et sending\_currency = BTC. original\_currency et sending\_currency peuvent avoir la même valeur si la conversion de devise n’est pas nécessaire.

**buyer\_email** est l’adresse e-mail de l’acheteur. Pour envoyer des notifications si le paiement est insuffisant et que vous devez payer un supplément ou pour les remboursements. Si cette variable n’est pas spécifiée, le courrier sera pris automatiquement à partir de la variable email, si l’utilisateur en a une dans salebot.&#x20;

Après cela, vous devez définir la valeur de la **payment\_sum** variable (par exemple, 10 ou 0.0055 (**avec un point !**)), juste après cela la **paycoinments\_pay\_url** variable apparaîtra. Cette variable peut être affichée sous forme de lien ou placée sur le bouton avec le texte « Payer ». Le lien est : **<https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey\\&e7782d2ce24f7d03815606a5c4a882eb>**

De plus, avant de définir la valeur payment\_sum, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.&#x20;

**payment\_description** - le nom du produit, il figurera sur la page d’informations de paiement et dans l’IPN de la transaction.&#x20;

**buyer\_name** - le nom de l'acheteur&#x20;

## Comment créer un lien de paiement&#x20;

Créer un lien pour le paiement de 0.44444

&#x20;                                ![](/files/ab186751003fe2d8cd5828d9376c42d0b01d10e4)

{% hint style="info" %}
Veuillez noter :

* Spécifiez d'abord l'e-mail
* Paramètres optionnels suivants **first\_name, payment\_description**, etc.
* Et enfin, attribuez la valeur de la **payment\_sum** variable
  {% endhint %}

Remarque : nous définissons d'abord les variables pour les paramètres, puis payment\_sum. Vous pouvez définir des variables plus tôt dans une chaîne, pas dans un seul bloc ; c'est un exemple.&#x20;

Ensuite, au bon endroit, affichez la variable **coinpayments\_pay\_url** qui contient le lien

&#x20;                                              ![](/files/1cf0c91f16125a0ee34a138bc225e100da3f9505)

{% hint style="warning" %}
Pour effectuer un paiement répété, vous devez réinitialiser payment\_sum, le lien généré précédemment, puis, après avoir réinitialisé la variable payment\_sum, obtenir un nouveau lien
{% endhint %}

## Comment traiter le résultat&#x20;

Après un paiement réussi dans le bot, des kolbeks arriveront, grâce auxquels vous pouvez comprendre qu’un paiement a été effectué avec succès. Ces colbeks dans le système apparaissent comme des messages de l’utilisateur ; afin qu’ils ne puissent pas être envoyés par l’utilisateur, ils se composent des 10 premiers caractères de la clé secrète et de la mention \_success, par exemple : 16831CF4b5\_success

{% hint style="success" %}
Ces colbeks NE SONT PAS VISIBLES par l’utilisateur, ils sont affichés uniquement à l’opérateur.
{% endhint %}

{% hint style="danger" %}
Le type de comparaison doit être « Correspondance exacte »
{% endhint %}

De plus, après un paiement réussi, la variable coinpayments\_payment\_completed est définie sur true&#x20;

Par exemple, vous pouvez créer un bloc de traitement d'un paiement réussi avec une condition et afficher le message correspondant à l'utilisateur :

&#x20;

![](/files/7092e8e9266719020105b29e1f8801e695b83d63)

À la fin du paiement, un **coinpayments\_payment\_callback** la variable sera ajoutée au client, contenant les données de réponse du système de paiement pour la transaction terminée. Vous pouvez extraire les données nécessaires du dictionnaire en utilisant le **get** .

## Comment vérifier le statut du paiement&#x20;

Pour vérifier l’état du paiement, vous devez appeler **coinpayments\_get\_payment\_status()** dans le champ Calculatrice&#x20;

Exemple :

&#x20;                                           ![](/files/dcd363130f1064d10a07d43ffbf4481f9819d624)

&#x20;                                          ![](/files/e3a72b69f5fa41571953420010b53bfea29a1d18)

Exemples des statuts :

*En attente des fonds de l'acheteur...*&#x20;

*Fonds reçus et confirmation de l'envoi vers vous sous peu…*&#x20;

*Terminé*&#x20;


---

# 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/integrations/payment/coinpayments.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.
