Coinpayments
Comment connecter lien How to connect
Comment générer un lien de paiement lien How to generate a payment link
Comment traiter le résultat lien How to process the result
Comment vérifier le statut du paiement 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
Dans le premier onglet, copiez l'ID du vendeur. (ID du vendeur)
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
Ensuite, allez dans la section Clés API et générez une paire de clés pour accéder à l'API.
Enregistrez tous les paramètres, copiez les données et allez dans les paramètres de Mavibot. Ouvrez la section « Acquisition », sélectionnez Coinpayments.
Vous devez saisir les données reçues.
Pour générer un lien de paiement, vous devez définir la valeur des variables requises :
original_currency
La devise d'origine de la transaction.
sending_currency
La devise que le client enverra.
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.
buyer_email
Adresse e-mail du client.
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.
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.
Comment générer un lien de paiement
Créer un lien de paiement d'un montant de 0.0256
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.
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
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.
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
Ces callbacks NE SONT PAS VISIBLES pour l'utilisateur, ils ne sont affichés qu'à l'opérateur.
Le type de comparaison doit être « Correspondance exacte »
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 :
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 :
Exemple de statut:
En attente des fonds de l'acheteur...
Fonds reçus et confirmation de l'envoi vers vous sous peu…
Terminé
Mis à jour