API Pix : ce qu'elle permet et comment l'utiliser avec des agents IA
L'API Pix est la spécification définie par la banque centrale du Brésil pour que les banques et les établissements de paiement proposent, par programmation, des demandes de paiement et des consultations Pix, le système de paiement instantané brésilien. Elle sert aux entreprises qui veulent générer des paiements par QR Code et rapprocher automatiquement les encaissements. L'accès passe toujours par la banque ou le PSP de l'entreprise, avec les identifiants et le certificat du compte.
Ce que propose l’API Pix
Paiement immédiat
Création de demandes de paiement avec montant et identifiant, qui génèrent un QR Code et un code copier-coller.
Paiement avec échéance
Demandes avec date d'échéance, intérêts, pénalité et remise, dans le style du boleto, le bordereau de paiement brésilien.
Consultation des Pix reçus
Liste et consultation des Pix entrés sur le compte, avec l'identifiant de la transaction.
Remboursements
Demande de remboursement total ou partiel d'un Pix reçu.
Webhooks
Notification au système de l'entreprise quand un Pix est reçu sur la clé enregistrée.
Locations de payload
Gestion des adresses utilisées pour les QR Codes dynamiques.
Comment accéder à l’API Pix
- Avec les identifiants de votre entrepriseChaque banque ou PSP définit l'accès, mais le standard est OAuth 2.0 avec client credentials et un certificat numérique (mTLS) émis pour le compte de l'entreprise.
- Le certificat et les identifiants donnent accès au compte : restreignez qui peut les gérer et renouvelez-les avant l'expiration.
- Chaque banque a ses limites de requêtes et ses particularités au-delà du standard de la banque centrale.
- Les mouvements sortants doivent toujours avoir une approbation humaine et un plafond de montant.
Documentation officielle: bacen.github.io/pix-api
Ce qu’un agent iTeam fait avec l’API Pix
Paiement sur WhatsApp avec rapprochement automatique
L'agent génère la demande de paiement Pix, envoie le code copier-coller au client et, quand le webhook confirme le paiement, solde l'écriture dans l'ERP et remercie le client.
Rapprochement quotidien
L'agent croise les Pix reçus avec les échéances ouvertes et liste les paiements non identifiés pour la finance.
Remboursement avec approbation
Les demandes de remboursement arrivent à l'agent, qui vérifie le paiement et prépare le remboursement ; l'exécution n'a lieu qu'après l'approbation d'un responsable.
Relance des impayés
Pour les échéances en retard, l'agent génère un Pix avec échéance incluant les intérêts et la pénalité de la politique, et suit jusqu'au paiement.
De l’identifiant à l’agent au travail, avec validation
Activer l'API auprès de votre banque
Demandez à la banque ou au PSP l'accès à l'API Pix, générez le client ID, le secret et le certificat de l'application, et enregistrez la clé Pix qui recevra les fonds.
Conserver identifiants et certificat dans le coffre
iTeam stocke les identifiants et le certificat dans le coffre ; la lecture et la génération de demandes peuvent être automatiques, tandis que les remboursements exigent une approbation.
Tester en environnement de recette
Utilisez l'environnement de test de la banque, quand il existe, validez le webhook et ne passez en production qu'ensuite, avec un plafond de montant par opération.
É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 Pix
L'API Pix est-elle gratuite ?
Cela dépend de la banque ou du PSP. La spécification est publique, mais les frais par paiement ou par encaissement et un éventuel coût d'accès sont fixés dans le contrat avec l'établissement.
Faut-il savoir programmer pour utiliser l'API Pix avec iTeam ?
Pas nécessairement. iTeam lit la documentation de l'API Pix de votre banque et l'équipe de déploiement configure les routines ; votre équipe s'occupe de l'ouverture auprès de la banque.
Cela fonctionne-t-il avec n'importe quelle banque ?
Cela fonctionne avec les établissements qui proposent l'API Pix aux entreprises. Les différences entre banques sont traitées dans la configuration.
