API Pagar.me : commandes, paiements et abonnements avec des agents IA
Pagar.me, du groupe Stone, propose une API REST pour traiter des paiements en ligne par carte, Pix et boleto (titre de paiement brésilien). Elle sert aux sites e-commerce, aux SaaS et aux plateformes qui ont besoin d'un paiement en ligne, de récurrence ou de répartition. L'accès se fait par la clé secrète du compte, avec des clés de test et de production.
Ce que propose l’API Pagar.me
Clients et cartes
Enregistrer des clients et conserver des cartes tokenisées.
Commandes et paiements
Créer des commandes et des paiements par carte, Pix ou boleto, les capturer et les rembourser.
Abonnements et plans
Créer de la récurrence, modifier les plans et suivre les factures.
Bénéficiaires et répartition
Répartir les montants entre bénéficiaires dans les places de marché.
Solde et virements
Consulter le solde et les créances.
Webhooks
Recevoir les événements de paiement approuvé, refusé et remboursé.
Comment accéder à l’API Pagar.me
- Avec les identifiants de votre entrepriseAuthentification basique avec la clé secrète du compte (sk_), avec des clés distinctes pour le test et la production, générées dans le tableau de bord.
- La clé secrète permet les remboursements : bloquez cette action côté agent ou exigez une approbation.
- Les données de carte ne passent jamais par l'agent : utilisez la tokenisation.
- Testez tout avec les clés de test avant la production.
Documentation officielle: docs.pagar.me
Ce qu’un agent iTeam fait avec l’API Pagar.me
Récupération d'un paiement refusé
Quand la carte est refusée, l'agent prévient le client et lui propose Pix ou boleto par le bon canal.
Abonnement à risque
Les factures d'abonnement dont le prélèvement échoue déclenchent un contact de l'agent avant la résiliation.
Contrôle des remboursements
L'agent liste les remboursements et les rétrofacturations de la période avec le motif et la commande d'origine.
Question d'un client sur un paiement
L'agent consulte la commande dans Pagar.me et explique le statut et la date de règlement.
De l’identifiant à l’agent au travail, avec validation
Récupérer les clés dans le tableau de bord
Dans le tableau de bord de Pagar.me, copiez la clé secrète de test et configurez le webhook qu'iTeam va recevoir.
Définir les permissions par agent
Dans iTeam, l'identifiant Pagar.me est placé dans le coffre-fort et chaque agent reçoit une liste fermée d'actions (consulter les commandes, générer un Pix, lire les abonnements). Les actions qui modifient des données demandent l'approbation d'une personne.
Valider à petite échelle, puis élargir
Commencez par un cas : créez un paiement Pix avec la clé de test. Une fois le résultat vérifié, le processus monte en volume, toujours avec audit et approbation là où il y a un risque.
Équipes IA prêtes à l’emploi pour ce travail
Rapprochement bancaire
Chaque ligne du relevé est rapprochée de sa facture, de son versement Stripe ou de son écriture, et seuls les vrais écarts arrivent chez vous.
Factures fournisseurs
Les factures sont repérées dans Gmail, lues, contrôlées contre la commande et préparées pour un paiement que vous validez.
Relances et recouvrement
Les factures échues sont relancées par e-mail ou WhatsApp selon votre calendrier, et les clients en difficulté arrivent chez une personne.
Prévision de trésorerie
Chaque lundi, vous savez ce qu'il y aura en banque dans les semaines qui viennent, et ce qui pourrait tout décaler.
Tenue comptable
Les pièces sont collectées, les écritures préparées et les anomalies repérées, pour que le collaborateur passe son temps à réviser et à conseiller.
Questions sur l’API Pagar.me
L'API Pagar.me est-elle gratuite ?
L'usage de l'API n'est pas facturé ; vous payez les frais par transaction prévus au contrat avec Pagar.me.
Faut-il programmer pour utiliser l'API Pagar.me avec iTeam ?
Non. iTeam lit la documentation de l'API Pagar.me, prépare les appels, et l'équipe de déploiement ajuste le flux avec vous. Il reste à l'entreprise d'approuver et de suivre.
L'agent voit-il le numéro de carte du client ?
Non. Pagar.me travaille avec des cartes tokenisées, et l'agent ne consulte que le statut, le montant et les données de la commande.
