API Cielo : ce qu'on peut faire et comment l'utiliser avec des agents IA
Cielo, acquéreur de paiements brésilien, propose des API pour encaisser en ligne, comme l'API E-commerce Cielo, avec carte de crédit et de débit, Pix (le virement instantané brésilien), boleto (bordereau de paiement brésilien) et paiements récurrents, ainsi que le lien de paiement et la consultation des ventes. Elle sert aux boutiques, aux plateformes et aux services financiers des clients Cielo. L'accès exige un agrément et les clés de l'établissement, avec un environnement sandbox.
Ce que propose l’API Cielo
Transactions par carte
Autorisation, capture, annulation et consultation des paiements par carte de crédit et de débit.
Pix et boleto
Génération d'encaissements par Pix et boleto, selon ce qui est activé.
Paiements récurrents
Prélèvements périodiques programmés pour les abonnements et les mensualités.
Tokenisation de carte
Stockage sécurisé de la carte pour des paiements futurs sans conserver le numéro.
Lien de paiement
Création de liens permettant au client de payer sans intégration de caisse.
Consultation des ventes
Statut et détail des transactions pour le support et le rapprochement.
Comment accéder à l’API Cielo
- Avec les identifiants de votre entrepriseMerchant ID et Merchant Key de l'établissement, fournis lors de l'agrément ; certains produits utilisent OAuth avec client id et secret. Les clés du sandbox et de la production sont distinctes.
- Ne faites jamais circuler un numéro de carte dans les messages ; utilisez la tokenisation et le lien de paiement.
- Séparez les clés du sandbox et de la production et limitez qui peut rembourser.
- Respectez les règles de sécurité des données de carte (PCI) et la LGPD, la loi brésilienne de protection des données.
Ce qu’un agent iTeam fait avec l’API Cielo
Le client dit avoir été débité deux fois
L'agent consulte les transactions de la commande, confirme s'il y a doublon ou simple préautorisation et prépare l'annulation pour validation.
Abonnement dont la carte est refusée
Quand le prélèvement échoue, l'agent prévient le client et envoie un lien de paiement pour régulariser.
Lien de paiement sur WhatsApp
Dans la vente conseil, l'agent génère le lien avec le montant validé par le vendeur et suit jusqu'au paiement.
Contrôle des ventes du jour
L'agent croise les transactions capturées avec les commandes de l'ERP et signale les écarts à la finance.
De l’identifiant à l’agent au travail, avec validation
Obtenir les clés et utiliser le sandbox
Après l'agrément, récupérez les clés de l'établissement et validez les flux dans l'environnement de test de Cielo.
Enregistrer dans le coffre d'iTeam
Les clés sont conservées dans le coffre ; l'agent de support consulte les transactions, et seule la finance peut demander une annulation.
Opérations avec validation et plafond
Annulations, remboursements et liens au-delà d'un montant exigent une validation humaine, avec un plafond défini.
É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 Cielo
L'API de Cielo est-elle gratuite ?
En général, l'accès à l'API vient avec l'agrément ; Cielo prélève des frais sur les transactions selon le contrat de l'établissement.
Faut-il programmer pour utiliser l'API de Cielo avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation et l'équipe de déploiement configure les flux avec votre service financier.
Y a-t-il un environnement de test ?
Oui, Cielo met à disposition un sandbox avec ses propres clés pour tester sans encaissement réel.
