QR code PIX : un BR Code statique pour les paiements brésiliens
PIX est le système de paiement instantané brésilien, et ses QR codes suivent la spécification EMV des paiements par QR code — la même grammaire de champs et de longueurs que les codes de paiement ailleurs dans le monde. Un code PIX statique porte directement la clé du bénéficiaire : une application bancaire peut donc construire le virement sans appeler un serveur. C’est ce qui le rend économique à imprimer et utilisable hors ligne, mais c’est aussi ce qui en fait un instantané figé.
Comment se structure un code PIX statique
Chaque champ s’écrit avec un identifiant à deux chiffres, une longueur à deux chiffres et la valeur. La charge utile commence par 00 et se termine par le CRC du champ 63. Le champ 26 est le bloc du compte marchand, où le sous-champ 00 identifie le schéma PIX et le sous-champ 01 porte la clé.
| Champ | Valeur dans l’exemple | Rôle |
|---|---|---|
| 00 | 01 | Indicateur de format de la charge utile. |
| 26 | br.gov.bcb.pix + clé | Informations du compte marchand : GUI PIX et clé CPF, CNPJ, courriel, téléphone ou aléatoire. |
| 52 | 0000 | Code de catégorie marchand ; 0000 est accepté quand la catégorie est inconnue. |
| 53 | 986 | Devise : 986 désigne le réal brésilien. |
| 58 | BR | Code pays. |
| 59 | QrDeco Example | Nom du commerçant, 25 caractères au maximum. |
| 60 | Sao Paulo | Ville du commerçant, 15 caractères au maximum. |
| 62 | 05 + txid | Données additionnelles : l’identifiant de transaction, ou *** en son absence. |
| 63 | 3C63 | CRC16-CCITT calculé sur tout ce qui précède ce champ. |
Générer un code PIX avec votre propre clé
- Choisissez le type de clé réellement enregistré sur le compte : CPF ou CNPJ en chiffres, courriel tel qu’il est écrit, téléphone au format +55 suivi du numéro, ou clé aléatoire EVP sous forme d’UUID.
- Renseignez les champs 52, 53 et 58 avec 0000, 986 et BR.
- Remplissez 59 et 60 avec le nom et la ville que la banque affichera ; les deux sont limités et n’acceptent aucune balise.
- Calculez le CRC puis exportez en SVG pour l’impression ou en PNG pour une page de paiement.
Laisser le montant libre
Omettez le champ 54 et le payeur saisit le montant. Incluez 54 avec un séparateur décimal en point — 10.50, jamais 10,50 — et l’application le préremplit. Un montant libre convient aux pourboires, aux dons et au comptoir où le total se discute d’abord ; un montant fixe convient à une page produit ou à une prestation à prix unique.
Le txid et le rapprochement
Le sous-champ 62-05 identifie la transaction. La valeur *** signifie « pas d’identifiant », ce qui suffit pour une boîte de collecte anonyme mais ne sert à rien pour rapprocher les ventes quotidiennes d’une boutique. Utilisez un court numéro de facture, jusqu’à 25 caractères alphanumériques, et notez quel code a été imprimé et quand.
Questions fréquentes
Un code PIX statique est-il identique à un code dynamique ?
Non. Un code statique contient la clé et les données fixes ; un code dynamique contient une URL qu’un service de paiement transforme en créance, ce qui permet des montants et des échéances propres à chaque facture.
Pourquoi l’application bancaire rejette-t-elle mon code ?
Presque toujours à cause du CRC. Recalculez le champ 63 après toute modification — y compris un nom, une ville ou un txid — et vérifiez que chaque longueur de champ correspond toujours à la valeur.
Puis-je réutiliser un même code PIX pour toutes les ventes ?
Oui pour un code statique à montant libre, mais le txid sera identique pour chaque paiement tant que vous ne générez pas un nouveau code par vente. La réutilisation est pratique ; ce n’est pas une stratégie de rapprochement.