Comment accepter les paiements Pix sur mon site web ?

Statique ou dynamique : le choix qui décide de tout le reste

La banque centrale du Brésil définit les deux dans son Manual de Padrões para Iniciação do Pix (la version en vigueur est la 2.10.0). Dans un code statique, tout ce qu'il faut pour lancer le paiement se trouve dans l'image elle-même : un élément obligatoire, une clé Pix enregistrée dans l'annuaire DICT, et quatre facultatifs — un identifiant de transaction, un champ de texte libre, le montant et un champ réservé à Pix Saque. Le manuel indique qu'un code statique peut être créé directement par le logiciel du bénéficiaire, et précise en majuscules que sa création NE fait PAS partie de l'API Pix. Votre site peut le construire ; aucune banque n'a besoin d'intervenir.

Un code dynamique contient au contraire une URL sur le serveur de votre prestataire de paiement, que l'application de l'acheteur consulte au moment du scan pour récupérer le montant et les détails de la transaction. Comme seul votre prestataire peut servir cette URL, un code dynamique vient toujours d'un prestataire — l'API Pix de votre banque ou une société de paiement — et c'est ce même prestataire qui peut prévenir votre site quand l'argent arrive. La règle pratique : si le paiement doit débloquer quelque chose automatiquement (un téléchargement, un compte, un créneau réservé), il vous faut la voie dynamique et quelque chose côté serveur pour recevoir l'avis — la même frontière que trace mon site a-t-il besoin d'un backend. Si quelqu'un peut vérifier la banque avant d'expédier, un code statique avec le montant suffit.

Ce que nous avons trouvé sur les sites que nous hébergeons

AgentCeres — l'AI Growth Officer sur agentceres.com — héberge des pages que les clients construisent avec leur agent, et la plupart de ces clients sont au Brésil. Lors de notre comptage du 23 septembre 2026, 54 des 173 pages clients en ligne mentionnaient Pix et 78 affichaient des prix en reais. Le problème, c'était la façon d'encaisser :

1. Neuf pages intégraient un code Pix que l'IA avait écrit à la main. Un BR Code se termine par une somme de contrôle calculée sur tous les caractères qui la précèdent, et le manuel note que même l'ordre des champs la modifie. Un code faux d'un seul caractère ne se scanne pas — au moins un client nous a dit que l'application de sa banque ne parvenait pas à lire le sien.
2. Vingt-deux pages affichaient la clé Pix en texte. Ça marche, mais l'acheteur saisit lui-même le montant, si bien que les paiements erronés ou partiels sont faciles. Un propriétaire avait demandé d'utiliser son CPF, ce qui met un numéro fiscal personnel sur une page publique ; une clé aléatoire (chave aleatória) fait le même travail sans cela.
3. Le paiement était « prouvé » par l'acheteur. Les formulaires de commande demandaient à l'acheteur de cocher une case disant qu'il avait payé et d'envoyer une capture d'écran — ce qui prouve seulement que quelqu'un sait faire une capture d'écran.

Nous avons donc intégré la voie statique à notre hébergement, et ce sont les choix qui valent pour tout le monde. Le code est généré à partir de la clé du propriétaire lui-même, si bien que la banque de l'acheteur paie directement celle du propriétaire et que nous ne détenons jamais l'argent. Le montant est calculé sur notre serveur à partir des prix de la page publiée, jamais d'un total envoyé par le navigateur, car tout ce qui se trouve dans la page peut être modifié par le visiteur. Si le montant ne peut pas être calculé, la génération échoue au lieu de se rabattre sur un code sans montant. Et la confirmation reste manuelle : le propriétaire vérifie sa banque et marque la commande comme payée, et la page de l'acheteur indique qu'elle attend le vendeur jusque-là.

Réussir un code statique

Un détail joue en faveur de l'acheteur. Le manuel dit que le nom que voit le payeur avant de confirmer est toujours celui enregistré dans le DICT pour cette clé, et que le nom du bénéficiaire inscrit dans le code est ignoré. L'acheteur peut donc vérifier qui reçoit vraiment l'argent, quoi que dise la page — cela vaut la peine de le signaler près du bouton. Si vous préférez conclure la vente dans une conversation plutôt que sur la page, un bouton WhatsApp qui envoie la commande est l'alternative courante, et les deux fonctionnent bien ensemble.