Comment se connecter

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

Accédez à votre compte Coinpayments -> Paramètres

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

Sur le premier onglet, copiez l'ID vendeur (seller ID)

Ensuite, allez dans l'onglet Paramètres du vendeur et inventez et saisissez la clé secrète IPN - IPN secret (Cela sert à confirmer que le webhook provient de nous, utilisez une chaîne complexe fiable qui sera difficile à deviner.)

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

Ensuite, allez dans la section API Keys 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 sur les systèmes de paiement, sélectionnez Coinpayments.

Nous devons saisir les données.

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, l'e-mail sera automatiquement pris à partir de la variable email, si l'utilisateur en a une dans mavibot.

Après cela, vous devez définir la valeur de la variable payment_sum (par exemple, 10 ou 0.0055 (avec un point !)), immédiatement après, la variable paycoinments_pay_url apparaîtra. Cette variable peut être affichée avec un 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 de payment_sum, vous pouvez spécifier les variables optionnelles suivantes pour configurer le paiement.

payment_description - le nom du produit, apparaîtra sur la page d'information de paiement et dans l'IPN pour la transaction.

buyer_name - le nom de l'acheteur

Comment créer un lien de paiement

Créez un lien pour le paiement de 0.44444

Veuillez noter :

  • Spécifiez d'abord l'e-mail
  • Ensuite les paramètres optionnels first_name, payment_description, etc.
  • Et enfin, attribuez la valeur de la variable payment_sum

Notez que nous définissons d'abord les variables pour les paramètres, puis payment_sum. Vous pouvez définir les variables plus tôt dans une chaîne, pas dans un seul bloc, ceci est un exemple.

Ensuite, à l'endroit approprié, imprimez la variable coinpayments_pay_url 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é, et après avoir réinitialisé la variable payment_sum pour obtenir un nouveau lien

Comment traiter le résultat

Après un paiement réussi, des callbacks arriveront dans le bot, sur lesquels vous pouvez comprendre qu'un paiement a été effectué avec succès. Ces callbacks dans le système sont visibles comme des messages de l'utilisateur, de sorte qu'ils ne peuvent pas être envoyés par l'utilisateur, ils se composent des 10 premiers caractères de la clé secrète et d'une notation _success, par exemple : 16831CF4b5_success

Ces callbacks NE SONT PAS VISIBLES par l'utilisateur, ils sont affichés uniquement à 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 créer un bloc de traitement de paiement réussi avec une condition et imprimer le message correspondant à l'utilisateur :

À la fin du paiement, une variable coinpayments_payment_callback 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 la méthode get.

Comment vérifier le statut du paiement

Pour vérifier le statut du paiement, vous devez appeler coinpayments_get_payment_status() dans le champ Calculatrice

Exemple :

Exemples de statuts :

En attente des fonds de l'acheteur...

Fonds reçus et confirmés, en cours d'envoi vers vous...

Terminé