Pour utiliser le système de paiement Mercado Pago, effectuez les réglages ci-dessous dans votre tableau de bord Mercado Pago Developers, puis saisissez les informations dans les paramètres d'intégration.
Application et jeton d'accès
- Connectez-vous à Mercado Pago et ouvrez la section Développeurs (Developers / Suas integrações).
- Créez une application (Your integrations → Create application) si vous n'en avez pas encore.
- Copiez votre Production Access Token ou Test Access Token — ce jeton sera utilisé comme jeton API principal.
Pour plus d'informations sur les types de jetons et où les trouver, consultez : Credentials.
Webhooks (notifications de paiement)
- Dans les paramètres d'intégration, ouvrez la section Webhooks / уведомления (voir : Webhooks).
- Définissez l'URL de notification :
https://chatter.mavibot.ai/mercado_pago_callback/result
- Abonnez-vous aux événements Payments afin de recevoir des notifications sur la création de paiement et les mises à jour de statut.
- Enregistrez le Webhook secret — il doit être saisi dans les paramètres d'intégration.
Connexion à Mavibot
Dans la section Acquiring, sélectionnez Mercado Pago.
Ensuite, saisissez :
- Access Token — le jeton que vous avez copié.
- Webhook secret — le secret utilisé pour vérifier les webhooks.
Génération du lien de paiement
Fonction de la calculatrice :
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
La fonction renvoie un lien de paiement.
Paiement via bouton
Pour envoyer un bouton de paiement via Mercado Pago, sélectionnez un type de bouton avec prise en charge du paiement dans le générateur de boutons et choisissez Mercado Pago comme système de paiement. Saisissez le montant, la description et la devise si nécessaire.
Callbacks 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 callback peut être envoyé au dialogue dans le 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 Webhook secret, 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 callback.
Étape 1
Créez un bloc avec une condition (bloc de départ ou bloc de déclencheur).
Étape 2
Spécifiez une partie du callback (si vous devez réagir à tous les paiements, par exemple lorsque vous avez plusieurs produits différents), ou le callback 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 réussi et enregistrez le bloc.
Paiement échoué
Si le paiement n'est pas réussi (refusé, annulé, etc., selon le statut dans l'API), un callback peut être envoyé dans le 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 Webhook secret, 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 callback.
Une réaction à un paiement échoué se configure de la même manière qu'à un paiement réussi.
Étape 1
Créez un bloc avec une condition (bloc de départ ou bloc de déclencheur).
Étape 2
Spécifiez une partie du callback (si vous devez réagir à tous les paiements, par exemple lorsque vous avez plusieurs produits différents), ou le callback 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 | ID de paiement Mercado Pago |