API Asaas : encaissements, Pix et webhooks avec des agents IA
L'API d'Asaas, plateforme de paiement brésilienne, est de type REST et couvre pratiquement tout ce qui se fait dans l'interface : fiches clients, émission d'encaissements, abonnements, virements et factures de services. Elle sert aux entreprises et aux développeurs qui relient l'encaissement à l'ERP, au CRM ou à un système maison. L'accès se fait par la clé d'API du compte, avec un environnement sandbox pour les tests.
Ce que propose l’API Asaas
Clients
Créer, mettre à jour et rechercher des payeurs avec leur identifiant fiscal brésilien (CPF/CNPJ), leur e-mail et leur téléphone.
Encaissements
Émettre un boleto (titre de paiement brésilien), un Pix (paiement instantané brésilien) ou un paiement par carte, consulter le statut, rembourser et générer un duplicata.
Abonnements
Créer des encaissements récurrents et ajuster le montant, le cycle et l'échéance.
Factures de services
Planifier et émettre des factures de services liées aux encaissements.
Virements et solde
Consulter le solde et le relevé, effectuer des virements et payer des factures.
Webhooks
Recevoir des événements comme encaissement payé, échu ou remboursé.
Comment accéder à l’API Asaas
- Avec les identifiants de votre entrepriseAuthentification par clé d'API (access token) générée dans l'interface Asaas et transmise dans l'en-tête de chaque requête. Les clés du sandbox et de la production sont distinctes.
- La clé d'API donne un accès étendu au compte, virements compris : gardez-la uniquement dans le coffre et bloquez pour l'agent les actions de sortie d'argent.
- Utilisez le sandbox pour valider la relance avant de l'activer en production.
- Le CPF, le téléphone et les données de paiement sont personnels : traitez-les conformément à la loi brésilienne de protection des données (LGPD).
Documentation officielle: docs.asaas.com
Ce qu’un agent iTeam fait avec l’API Asaas
Relance conversationnelle
À la réception de l'événement d'encaissement échu, l'agent envoie un rappel sur WhatsApp avec le code du boleto ou le Pix et enregistre la réponse du client.
Duplicata sans file d'attente à la finance
Le client demande le duplicata par e-mail ou sur WhatsApp et l'agent renvoie aussitôt le lien à jour de l'encaissement.
Rapprochement avec l'ERP
L'agent lit les encaissements payés du jour et solde les titres de l'ERP, en isolant les écarts de montant pour révision.
Remise sous délégation
Les demandes de remise ou d'échelonnement deviennent une proposition de l'agent, approuvée par la finance avant de modifier l'encaissement.
De l’identifiant à l’agent au travail, avec validation
Générez la clé d'API dans Asaas
Dans l'interface Asaas, générez la clé d'API du compte (commencez par le sandbox) et configurez l'URL de webhook indiquée par iTeam.
Définissez les permissions par agent
Dans iTeam, l'identifiant Asaas va dans le coffre et chaque agent reçoit une liste fermée d'actions (consulter les encaissements, émettre un duplicata, créer un encaissement). Les actions qui modifient des données demandent l'approbation d'une personne.
Validez à petite échelle, puis élargissez
Commencez par un cas : émettez un encaissement dans le sandbox et simulez le paiement. Une fois le résultat vérifié, le processus monte en volume, toujours avec traçabilité et approbation là où il y a un risque.
Équipes IA prêtes à l’emploi qui utilisent Asaas
Vente sur WhatsApp
L'agent répond aux demandes de prix, prépare le devis ou le lien de paiement et relance au bon moment, sous le contrôle du vendeur.
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.
Questions sur l’API Asaas
L'API Asaas est-elle gratuite ?
L'usage de l'API en lui-même n'est pas facturé : vous payez les tarifs habituels d'Asaas par boleto, Pix, carte ou facture émise. Consultez la grille en vigueur sur le site d'Asaas.
Faut-il programmer pour utiliser l'API Asaas avec iTeam ?
Non. iTeam lit la documentation de l'API Asaas, construit les appels et l'équipe de déploiement ajuste le flux avec vous. L'entreprise n'a qu'à approuver et à suivre.
Peut-on tester l'API Asaas sans toucher à de l'argent réel ?
Oui. Asaas propose un environnement sandbox avec sa propre clé, où iTeam valide la relance et les webhooks avant la production.
