Général

API de paiement : comment intégrer Pix, carte et boleto à votre système

Guide de l’API de paiement : ce que c’est, comment se déroule l’intégration et comment encaisser par Pix, carte de crédit et boleto au Brésil depuis votre site, votre application ou votre système.

Par Equipe Sila Pay4 min de lecture
Deux collègues souriants discutent à côté d’un ordinateur portable dans un petit bureau

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.

Comment se déroule l’intégration, étape par étape

  1. 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.
  2. 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).
  3. 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.
  4. 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

#pagamentos#vendas online
PartagerWhatsAppLinkedInX

Prêt à passer à l'action ?

Créez votre compte Sila Pay en quelques minutes et commencez à encaisser par Pix, carte et lien de paiement.

  • ✓ Inscription gratuite
  • ✓ Sans abonnement
  • ✓ Réception à J+1
Créer un compte gratuit →

Recevez les prochains articles

Du contenu pratique sur les paiements et la vente en ligne, directement dans votre boîte mail.

Pas de spam. Désabonnement à tout moment.

À lire aussi

Sila Pay

Tout ce qu'il vous faut pour vendre, au même endroit.

Commencer →