Mercado Pago

Pour utiliser le système de paiement Mercado Pago, complétez les paramètres ci-dessous dans votre tableau de bord Mercado Pago Developers, puis saisissez les détails dans les paramètres d’intégration.

Application et jeton d’accès

1. Connectez-vous à Mercado Pago et ouvrez la section Developers (Développeurs / Vos intégrations).

2. Créez une application (Vos intégrations → Créer une application) si vous n’en avez pas encore.

3. Copiez votre Jeton d’accès de production ou Jeton d’accès de test — ce jeton sera utilisé comme jeton API principal.

Pour plus d’informations sur les types de jetons et l’endroit où les trouver, voir : Identifiants.

Webhooks (notifications de paiement)

1. Dans les paramètres d’intégration, ouvrez la section Webhooks / notifications (voir : Webhooks).

2. Définissez l’URL de notification :

https://chatter.mavibot.ai/mercado_pago_callback/result

1. Abonnez-vous aux événements Paiements afin de pouvoir recevoir des notifications sur la création des paiements et les mises à jour de statut.

2. Enregistrez le secret du webhook — il doit être saisi dans les paramètres d’intégration.

Connexion à Mavibot

Dans la section Acquiring, sélectionnez Mercado Pago.

Puis saisissez :

• Jeton d’accès — le jeton que vous avez copié.

• secret du webhook — le secret utilisé pour vérifier les webhooks.

Génération du lien de paiement

Fonction de calcul : get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)

Paramètres	Description
! amount	Montant du paiement. Ce paramètre est obligatoire.
description	Description du paiement. Ce paramètre est facultatif.
currency	Code de devise ISO (par ex. BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — facultatif ; la valeur par défaut est BRL.
customer_email	E-mail du client — facultatif.
product_name	Nom alternatif du produit — facultatif ; si non fourni, la description est utilisée à la place.

La fonction renvoie un lien de paiement.

Cet exemple montre comment transmettre des paramètres à la fonction et envoyer le lien de paiement dans un message.

Paiement via bouton

Pour envoyer un bouton de paiement via Mercado Pago, sélectionnez dans le générateur de boutons un type de bouton prenant en charge les paiements et choisissez Mercado Pago comme système de paiement. Saisissez le montant, la description et la devise si nécessaire.

Rappels dans le dialogue après le paiement

Paiement réussi

Après que le client a suivi le lien et effectué un paiement réussi, un rappel peut être envoyé au dialogue au format suivant :

<first_10_characters_of_Webhook_secret>_success <amount>

Exemple : gltubgnDle_success 100 — où le préfixe correspond aux 10 premiers caractères de votre secret Webhook, et 100 est le montant du paiement.

Comment ajouter une réaction à un paiement réussi

Pour envoyer un message à votre client après un paiement réussi (par exemple, « Paiement effectué avec succès » ou tout autre message), vous devez configurer une réaction à l’aide d’un bloc avec un déclencheur et un rappel.

Étape 1

Créez un bloc avec une condition (bloc de démarrage ou bloc de déclenchement).

Voici le bloc de démarrage avec un rappel dans le champ Trigger

Voici le bloc de déclenchement avec un rappel dans le champ Trigger

Étape 2

Indiquez une partie du rappel (si vous devez réagir à tous les paiements, par exemple lorsque vous avez plusieurs produits différents), ou le rappel complet (si vous souhaitez configurer une réaction uniquement pour la vente d’un produit spécifique).

Si vous devez configurer une réponse à n’importe quel paiement dans le projet, laissez une partie du rappel et sélectionnez le type de correspondance « Correspondance des mots-clés »

Étape 3

Rédigez le message de réponse pour un paiement réussi et enregistrez le bloc.

Paiement échoué

Si le paiement n’est pas effectué avec succès (refusé, annulé, etc., selon le statut dans l’API), un rappel peut être envoyé au format suivant :

<first_10_characters_of_Webhook_secret>_fail <amount>

Exemple : gltubgnDle_fail 100 — où le préfixe correspond aux 10 premiers caractères de votre secret Webhook, et 100 est le montant.

Comment ajouter une réaction à un paiement échoué

Pour envoyer un message à votre client après un paiement échoué (par exemple, « Paiement échoué » ou tout autre message), vous devez configurer une réaction à l’aide d’un bloc avec un déclencheur et un rappel.

Une réaction à un paiement échoué se configure de la même manière qu’une réaction à un paiement réussi.

Étape 1

Créez un bloc avec une condition (bloc de démarrage ou bloc de déclenchement).

Étape 2

Indiquez une partie du rappel (si vous devez réagir à tous les paiements, par exemple lorsque vous avez plusieurs produits différents), ou le rappel complet (si vous souhaitez configurer une réaction uniquement pour la vente d’un produit spécifique).

Étape 3

Rédigez le message de réponse pour un paiement échoué et enregistrez le bloc.

Variables client après un paiement réussi

Variables	Description
mercado_pago_callback_data	Informations de paiement reçues du système de paiement.
mercado_pago_payment_completed	« True » — le paiement a été traité comme réussi.
mercado_pago_payment_id	Identifiant de paiement Mercado Pago