> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/fr/integrations/payment/mercado-pago.md).

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

<div data-with-frame="true"><figure><img src="/files/fbad096a2d75f4c74bdbc710dc032062eaa1e352" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Pour plus d’informations sur les types de jetons et l’endroit où les trouver, voir : [Identifiants.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Webhooks (notifications de paiement)

1. Dans les paramètres d’intégration, ouvrez la **section Webhooks / notifications** (voir : [**Webhooks**](https://www.mercadopago.com.br/developers/en/docs/your-integrations/notifications/webhooks)).
2. Définissez l’URL de notification :

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

3. Abonnez-vous aux événements **Paiements** afin de pouvoir recevoir des notifications sur la création des paiements et les mises à jour de statut.
4. Enregistrez le **secret du webhook** — il doit être saisi dans les paramètres d’intégration.

<div data-with-frame="true"><figure><img src="/files/11761be3ae9e365a66b01a159f5950d3ac54357e" alt=""><figcaption></figcaption></figure></div>

## Connexion à Mavibot

Dans la section Acquiring, sélectionnez **Mercado Pago**.

<div data-with-frame="true"><figure><img src="/files/b7af2ee4f7fe64ec140e5feb9eb56c8c1bc1bb7a" alt=""><figcaption></figcaption></figure></div>

Puis saisissez :

* **Jeton d’accès** — le jeton que vous avez copié.
* **secret du webhook** — le secret utilisé pour vérifier les webhooks.

<div data-with-frame="true"><figure><img src="/files/cfb75d80c2d49c9b899182a64a77632f3c344892" alt=""><figcaption></figcaption></figure></div>

## Génération du lien de paiement

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

<table data-header-hidden><thead><tr><th width="241.3828125"></th><th></th></tr></thead><tbody><tr><td>Paramètres</td><td>Description</td></tr><tr><td><mark style="color:$danger;"><strong>!</strong></mark><strong> amount</strong></td><td><p><strong>Montant du paiement.</strong></p><p>Ce paramètre est obligatoire.</p></td></tr><tr><td><strong>description</strong></td><td><p><strong>Description du paiement.</strong> </p><p>Ce paramètre est facultatif.</p></td></tr><tr><td><strong>currency</strong></td><td><strong>Code de devise ISO</strong> (par ex. BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — facultatif ; la valeur par défaut est BRL.</td></tr><tr><td><strong>customer_email</strong></td><td><strong>E-mail du client</strong> — facultatif.</td></tr><tr><td><strong>product_name</strong></td><td><p><strong>Nom alternatif du produit</strong> — facultatif ; </p><p>si non fourni, la description est utilisée à la place.</p></td></tr></tbody></table>

La fonction renvoie un lien de paiement.

<div data-with-frame="true"><figure><img src="/files/04d6474b8f1b6a8c7e88e3ef3abc17f4151cedb8" alt=""><figcaption><p>Cet exemple montre comment transmettre des paramètres à la fonction et envoyer le lien de paiement dans un message.</p></figcaption></figure></div>

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

<div data-with-frame="true"><figure><img src="/files/e45cee8ec59327872f9b22564e347f957f6746c2" alt=""><figcaption></figcaption></figure></div>

## 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>`

<div data-with-frame="true"><figure><img src="/files/a78313207b4dfc03ca08faa9d4e4b9d5d0c8a904" alt="" width="524"><figcaption></figcaption></figure></div>

**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).

<div data-with-frame="true"><figure><img src="/files/8e25eb6ebc7432c3d762aae155f697323b60d221" alt=""><figcaption><p>Voici le bloc de démarrage avec un rappel dans le champ Trigger</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/231a11cf9e07295951fbebc434dd3f26abe6ee97" alt=""><figcaption><p>Voici le bloc de déclenchement avec un rappel dans le champ Trigger</p></figcaption></figure></div>

#### É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).

<div data-with-frame="true"><figure><img src="/files/9fd597e67b38d0d83f034595eb0c71acbd29baad" alt=""><figcaption><p>Si vous devez configurer une réponse à n’importe quel paiement dans le projet, <br>laissez une partie du rappel et sélectionnez le type de correspondance « Correspondance des mots-clés »</p></figcaption></figure></div>

#### Étape 3

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

<div data-with-frame="true"><figure><img src="/files/4ea823bba7317bec741a4331ce726110d6d10470" alt=""><figcaption></figcaption></figure></div>

### 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>`

<div data-with-frame="true"><figure><img src="/files/7dd33816c7c4d4996812b4304261cfb6d1e2b9ea" alt="" width="563"><figcaption></figcaption></figure></div>

**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.

{% hint style="info" %}
[Une réaction à un paiement échoué se configure de la même manière qu’une réaction à un paiement réussi.](#how-to-add-a-reaction-to-a-successful-payment)
{% endhint %}

#### É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                    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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