# Coinpayments

* [Comment connecter](#podklyuchenie) lien How to connect
* [Comment générer un lien de paiement](#kak-sformirovat-ssylku-na-oplatu) lien How to generate a payment link
* [Comment traiter le résultat](#obrabotka-rezultata) lien How to process the result
* [Comment vérifier le statut du paiement](#proverka-statusa-platezha) lien How to check the payment status

## Comment connecter

Pour connecter le système de paiement Coinpayments, vous aurez besoin de quatre valeurs : l'ID du vendeur, le secret IPN (pour les webhooks), la clé privée API et la clé publique API. Vous devrez également définir l'URL du webhook.

Accédez à l'espace personnel de Coinpayments -> Paramètres du compte <https://www.coinpayments.net/index.php?cmd=acct_settings>

![](https://lh3.googleusercontent.com/xACTDovKtHxhj7vrWkS0u2TpAy_mK1VU7fR7k2KAD_6lL9OHyKsn4Np54iD4jb7Gjackry858WfaABz37i6tkfn5HZW94n4SKqDq3ooRToxaeXQPRbhvgnKG-KrAssSlHy2lrSSQ)

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

![](/files/71a82cfdf79be66c5b54bc1511a45ee820098848)

Ensuite, allez dans l'onglet « Paramètres du vendeur » et créez puis saisissez une clé secrète IPN - **secret IPN** ( Ceci sert à vérifier que le webhook provient bien de nous). Utilisez une chaîne sécurisée et complexe, difficile à deviner

Le lien IPN est l'URL des webhooks, ajoutez ce qui suit : **<https://chatter.salebot.pro/coinpayments\\_callback/result>**

![](https://lh6.googleusercontent.com/K939LTpXmntuJKU1tTN6NTBgl2ziiQTG7okWMRAdOMMQa0K7LbH0X3l7FWmd74FPqY9NOOGl89tbK99fgCpFLva4NJ8VVZVwwGfaE9YYKQ5EOkkb72Qz3FO5jPisxWxrAX8Ac94p)

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

![](https://lh6.googleusercontent.com/4Y9V4YRgYAvMJNelxlO5bhynVt1er0a5F-QNnOitbBrWFfOLPwJpOM8BHKgMcXxlKzwE9rc32Coxo-iVB_kvGRrgf0XXEjSsop5Uic8CP-8ey8Ll7a_CkvB7D3tcpcEgUo0Dbz7N)

Enregistrez tous les paramètres, copiez les données et allez dans les paramètres de Mavibot. Ouvrez la section « Acquisition », sélectionnez Coinpayments.

<figure><img src="/files/3d53ef75bd8c3004a996973082c4debdc1234a37" alt=""><figcaption></figcaption></figure>

Vous devez saisir les données reçues.

<figure><img src="/files/259a6fb971d6278a782eb867623b146a199bc036" alt="" width="563"><figcaption></figcaption></figure>

Pour générer un lien de paiement, vous devez définir la valeur des variables requises :

<table><thead><tr><th width="201">Variables</th><th width="228">Valeur de la variable</th><th>Remarque</th></tr></thead><tbody><tr><td> <strong>original_currency</strong> </td><td>La devise d'origine de la transaction.</td><td></td></tr><tr><td><strong>sending_currency</strong></td><td>La devise que le client enverra.</td><td>Par exemple, si vos produits sont tarifés en USD, mais que vous recevez des BTC, vous devez utiliser original_currency = USD et sending_currency = BTC. original_currency et sending_currency peuvent avoir une seule valeur si la conversion de devise n'est pas requise.</td></tr><tr><td><strong>buyer_email</strong> </td><td>Adresse e-mail du client.</td><td>Pour envoyer des notifications si le paiement est d'un montant inférieur et doit être complété, ou pour les remboursements. Si cette variable n'est pas définie, l'adresse e-mail sera prise automatiquement à partir de la variable email, si l'utilisateur en a une dans Mavibot.</td></tr></tbody></table>

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

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.

**payment\_description** - le nom du produit sera affiché sur la page d'informations de paiement et dans l'IPN de la transaction.

**buyer\_name** - nom du client

Voici à quoi ressemble la page de paiement.

![](https://lh3.googleusercontent.com/Yn1a6_JOW4wkj2SqNwkkJYMBZoh4JcR1HEinzP67O6WmYBcCV3IdRw_JCEQI0L7OV-8IuH_JdMEdOaduymc0vs5QAmpfcgrU0tFD9ZrT6V_B8vvQqe-sQcUDMsd9PJRa_uUsJAsX)

## Comment générer un lien de paiement

Créer un lien de paiement d'un montant de 0.0256

<figure><img src="/files/a1f432efba6226c117995425b80bd0f643429cae" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Attention :** \
\- Tout d'abord, spécifiez l'adresse e-mail\
-Ensuite, les paramètres optionnels  **first\_name, payment\_description** et ainsi de suite.\
\- Enfin, attribuez une valeur à la **payment\_sum** variable.
{% endhint %}

Veuillez noter que nous définissons d'abord les variables pour les paramètres, puis **payment\_sum.** Les variables peuvent être définies plus tôt dans la chaîne, plutôt que dans un seul bloc ; voici un exemple.

Ensuite, nous affichons la **coinpayments\_pay\_url** variable à l'endroit approprié, qui contient le lien

<figure><img src="/files/be5b35e73058a75d5a366f9a802c01a72e3e12a1" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="warning" %}
Pour effectuer un paiement répété, vous devez réinitialiser payment\_sum, le lien précédemment généré, puis réattribuer la variable payment\_sum afin d'obtenir un nouveau lien.
{% endhint %}

## Comment traiter le résultat

Après un paiement réussi, des callbacks seront envoyés au bot, ce qui vous informera que le paiement a été effectué avec succès. Vous voyez ces callbacks dans le système comme des messages de l'utilisateur. Pour empêcher l'utilisateur de les envoyer, ils se composent des 10 premiers caractères de la clé secrète et du suffixe \_success, par exemple : **16831CF4b5\_success**

{% hint style="success" %}
Ces callbacks NE SONT PAS VISIBLES pour l'utilisateur, ils ne sont affichés qu'à 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.

Par exemple, vous pouvez traiter un paiement réussi dans un bloc conditionnel et afficher le message correspondant à l'utilisateur :

<figure><img src="/files/2e633bcc8dbc3567c0fe917c1805eb115161352d" alt=""><figcaption></figcaption></figure>

Une fois le paiement effectué, la variable **coinpayments\_payment\_callback** la variable sera ajoutée au client et contiendra les données de la réponse du système de paiement à la transaction terminée. Vous pouvez extraire les données requises du dictionnaire résultant à l'aide de la **get** .

## Comment vérifier le statut du paiement

Pour vérifier le statut du paiement, utilisez **coinpayments\_get\_payment\_status()** méthode dans le champ Calculatrice.

Exemple :

<figure><img src="/files/68d39db7c916e6bf6cc3a9f3b644b106eecf4e47" alt="" width="563"><figcaption></figcaption></figure>

> **Exemple de statut**:
>
> En attente des fonds de l'acheteur...
>
> Fonds reçus et confirmation de l'envoi vers vous sous peu…
>
> Terminé


---

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