API Mercado Pago : fonctions et usage avec des agents IA
Mercado Pago est un service de paiement très présent au Brésil. Son API permet de créer des encaissements, de consulter des paiements, d'émettre des remboursements, de gérer des abonnements et de recevoir des notifications de changement de statut. Boutiques en ligne, éditeurs SaaS et entreprises qui vendent par lien, par Pix (virement instantané brésilien) ou par un checkout maison l'utilisent. L'accès se fait avec les identifiants du compte du vendeur, générés dans l'espace développeur.
Ce que propose l’API Mercado Pago
Paiements
Création et consultation de paiements par carte, Pix et boleto (titre de paiement brésilien), avec le statut de chaque transaction.
Préférences et checkout
Génération de liens et de préférences de paiement pour Checkout Pro et pour les intégrations de checkout maison.
Remboursements et annulations
Remboursement total ou partiel d'un paiement approuvé et annulation des encaissements en attente.
Abonnements
Plans et prélèvements récurrents pour qui vend sur abonnement.
Notifications (webhooks)
Alertes automatiques quand un paiement change de statut : approuvé, refusé ou remboursé.
Clients et cartes
Enregistrement des acheteurs et des cartes sauvegardées pour faciliter les achats suivants.
Comment accéder à l’API Mercado Pago
- Avec les identifiants de votre entrepriseL'intégration utilise un access token du compte (avec une paire d'identifiants de test et de production) généré dans l'espace développeur. Pour agir au nom d'autres vendeurs, un flux OAuth avec une application enregistrée existe.
- Séparez les identifiants de test et de production, et n'utilisez jamais ceux de production en phase de test.
- Un remboursement déplace de l'argent : laissez cette action sous validation humaine, avec un plafond par montant.
- Les données des acheteurs sont personnelles (LGPD, la loi brésilienne de protection des données) : limitez ce que l'agent lit et enregistre.
Documentation officielle: www.mercadopago.com.br/developers
Ce qu’un agent iTeam fait avec l’API Mercado Pago
Rapprochement des encaissements du jour
L'agent financier croise les paiements approuvés dans Mercado Pago avec les commandes de l'ERP et signale les écarts de montant, de frais ou les commandes sans paiement.
Remboursement avec validation
L'agent du service client prépare le remboursement d'une commande retournée, montre le montant et le motif, et n'exécute qu'après l'accord du responsable sur WhatsApp ou Teams.
Relance d'un paiement en attente
Quand un Pix ou un boleto n'est pas réglé à temps, l'agent génère un nouveau lien et l'envoie au client, en consignant chaque tentative.
Alerte de contestation et de refus
L'agent suit les notifications de statut et prévient l'équipe quand le taux de refus monte ou qu'une contestation apparaît.
De l’identifiant à l’agent au travail, avec validation
Générer les identifiants
Dans l'espace développeur de Mercado Pago, créez une application et copiez les identifiants de test et de production du compte de l'entreprise.
Stocker dans le coffre-fort d'iTeam
Enregistrez le jeton dans le coffre-fort d'iTeam et définissez ce que chaque agent peut faire : consulter des paiements, générer des liens ou demander des remboursements.
Tester avec validation humaine
Commencez avec les identifiants de test et gardez remboursements et encaissements sous validation jusqu'à ce que le processus soit éprouvé.
Équipes IA prêtes à l’emploi qui utilisent Mercado Pago
Questions sur l’API Mercado Pago
L'API Mercado Pago est-elle gratuite ?
L'usage de l'API en lui-même n'est en général pas facturé à part. Ce que l'on paie, ce sont les frais sur chaque transaction, selon le moyen de paiement et l'offre du compte.
Faut-il programmer pour utiliser l'API Mercado Pago avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation officielle et l'équipe de déploiement configure les appels. Vous fournissez seulement l'identifiant d'accès et les règles de validation.
L'agent peut-il créer seul un lien de paiement ?
Oui, si vous lui en donnez la permission. Le plus courant est d'autoriser la génération de liens et de laisser remboursements et annulations sous validation.
