Le lien de paiement suffit pour beaucoup de ventes, mais vient un moment où votre activité a besoin de plus : encaisser directement sur votre site, dans votre application ou depuis votre ERP, sans copier-coller. C’est là qu’intervient l’API de paiement.
Qu’est-ce qu’une API de paiement
Une API (interface de programmation d’applications) est le canal de communication entre votre système et la plateforme de paiement. Grâce à elle, votre logiciel crée des encaissements, suit leur statut et reçoit les confirmations automatiquement, via des requêtes HTTP au format JSON.
- Créez votre compte et générez vos clés : dans le tableau de bord Sila Pay, le menu API Key génère votre api-key et votre secret-key, envoyées dans l’en-tête de chaque requête.
- Créez l’encaissement : votre système envoie un POST à https://api.silapay.pro/v1/transactions avec le montant, les données du client et le moyen de paiement (pix, creditCard ou billet).
- Présentez le paiement au client : pour le Pix, la réponse contient le code « copier-coller » ; pour le boleto, l’encaissement est émis avec l’échéance choisie ; pour la carte, vous recevez le résultat de la transaction.
- Recevez la confirmation : indiquez une postbackUrl et votre système est notifié par webhook à chaque changement de statut du paiement.
Pix, carte et boleto : ce qui change
- Pix : l’encaissement est créé avec un statut en attente et un code « copier-coller » ; la confirmation arrive par webhook dès que le paiement est identifié.
- Carte de crédit : le paiement en plusieurs fois est possible, en indiquant le nombre d’échéances dans la requête, et le client peut être redirigé vers une page de confirmation (successUrl).
- Boleto : vous fixez l’échéance et pouvez transmettre votre propre référence (externalReference) pour relier l’encaissement à la commande.
Les avantages d’une intégration par API
- Vous maîtrisez l’expérience : vous décidez où et comment l’encaissement s’affiche pour le client.
- Moins de travail manuel : les commandes sont créées et confirmées automatiquement.
- Une intégration, trois moyens de paiement : Pix, carte et boleto sur le même endpoint.
- Elle grandit avec vous : le même flux convient à quelques commandes comme à de nombreuses commandes par jour.
Envie d’intégrer les paiements à votre système ? Ouvrez votre compte Sila Pay
Bonnes pratiques d’intégration
- Clés uniquement côté serveur : ne placez jamais l’api-key et la secret-key dans le front-end ou l’application ; les appels doivent partir de votre back-end.
- Vérifiez les webhooks : contrôlez l’en-tête X-Silapay-Signature avant de valider la commande.
- Conservez l’ID de la transaction : associez l’id renvoyé par l’API à la commande dans votre système.
- Gérez erreurs et délais d’attente : affichez un message clair et permettez de réessayer sans créer de doublon.
- Commencez avec de petits montants : testez tout le parcours avant de l’ouvrir à tous vos clients.
Questions fréquentes
Ai-je besoin d’un développeur ?
Pour une intégration par API, oui : quelqu’un doit programmer les appels dans votre système. Si vous utilisez WooCommerce ou Shopify, les plugins Sila Pay sont une solution plus simple ; et sans site web, le lien de paiement fait l’affaire.
Où se trouve la documentation ?
Sur doc.silapay.pro, avec les appels Pix, carte, boleto, solde et webhooks, ainsi que des exemples de requêtes et de réponses.
L’API sert-elle uniquement à encaisser ?
Non. En plus de la création d’encaissements, la documentation décrit l’envoi de Pix (cash-out) et la consultation du solde.
Faut-il une société brésilienne (CNPJ) ?
Avec Sila Pay, vous pouvez vendre en tant que particulier ou entreprise ; l’inscription indique les documents requis dans chaque cas.
Intégrez Pix, carte et boleto avec une seule API. Inscrivez-vous sur Sila Pay