Chapitre 1. Arbitrer entre Pix, carte parcelada et boleto.
Au Brésil, choisir un moyen de paiement n'est pas choisir un bouton dans un tunnel. On choisit un calendrier de trésorerie et un recours juridique. Les trois rails de l'encaissement brésilien répondent à trois besoins différents, sans qu'aucun soit le réglage par défaut des deux autres. Un catalogue qui n'expose que le Pix « parce que c'est moderne » perd le panier moyen ; un catalogue qui n'expose que la carte perd les acheteurs qui paient comptant ; un catalogue sans boleto perd le B2B et l'encaissement à échéance.
| Critère de décision | Pix | Carte de crédit parcelada | Boleto |
|---|---|---|---|
| Disponibilité des fonds | Immédiate : le Manual de Tempos do Pix impose la liquidation en 40 secondes au plus, avec un objectif de 6,0 s en médiane | D+30 pour le crédit à vista (usage de place) ; une échéance tous les 30 jours en parcelado lojista | À la main du débiteur, jusqu'à l'échéance qu'il a acceptée |
| Coût direct | Grilles publiques de place 2026 de l'ordre de 0,89 % à 1,45 %, avec plafond en valeur absolue par transaction | MDR moyen 2,16 % en crédit (1,08 % en débit), auquel s'ajoute le coût d'antecipação | Tarif unitaire par document, indépendant du montant |
| Révocabilité | Aucune : virement irrévocable. Seul recours, le MED, qui exclut le litige commercial | Chargeback selon les règles du scheme | Aucun : le paiement d'un titre est définitif |
| Recours juridique du créancier | Aucun titre : c'est un virement | Aucun titre : c'est une créance sur l'acquéreur | Titre susceptible de protêt et d'exécution, décisif en recouvrement B2B |
| Effet sur le panier | Neutre à négatif sur les gros paniers : pas de crédit | Le levier de panier brésilien : 64,2 % des ventes fractionnées le sont en six fois au plus | Neutre ; sert le paiement différé sans mobiliser la trésorerie du débiteur |
| Cas d'usage dominant | B2C comptant, recharge, marketplace, tout ce qui doit être livré immédiatement | Panier moyen et haut, électroménager, voyage, éducation | B2B, facturation à échéance, services publics, encaissement de proximité |
La règle de décision, en quatre questions
- Le bien est-il livré instantanément ? Si oui, le Pix est structurellement dangereux côté acheteur (aucune couverture de non-réception) et structurellement confortable côté vendeur, exactement l'inverse d'une carte. Adaptez votre politique de remboursement en conséquence, pas votre rail.
- Le panier justifie-t-il un crédit ? Au-delà du panier moyen de votre catégorie, l'absence de parcelado se paie en conversion. Le parcelado n'est pas une option de paiement, c'est le produit de crédit à la consommation le plus répandu du pays.
- Ai-je besoin d'un titre exécutoire ? Si l'acheteur est une personne morale et que l'impayé est un risque réel, le boleto est le seul des trois à produire un titre. Un Pix impayé n'existe pas. Il n'y a rien à recouvrer, seulement une vente non conclue.
- Qui porte le coût du temps ? En parcelado lojista, c'est vous. En parcelado emissor (com juros), c'est l'acheteur. La bascule entre les deux change votre besoin en fonds de roulement bien plus que votre MDR.
Chapitre 2. Câbler Pix : chave, BR Code, txid et webhook.
Au Brésil, le contrat d'API n'appartient pas à votre PSP. Le Banco Central do Brasil publie l'API Pix comme spécification OpenAPI officielle (dépôt github.com/bacen/pix-api), et le Manual de Padrões para Iniciação do Pix comme norme du QR. Tout PSP recebedor expose la même surface : /cob, /cobv, /loc, /pix, /webhook. Vous pouvez donc lire, tester et écrire votre couche d'intégration avant d'avoir choisi votre prestataire, dont le changement ultérieur n'oblige pas à réécrire votre domaine métier. La situation carte est exactement inverse.
| Type de chave | Format exact attendu dans le BR Code | Piège d'intégration |
|---|---|---|
fulano_da_silva.recebedor@example.com | Sensible à la casse dans le stockage : normalisez avant comparaison | |
| CPF | 12345678900 (11 chiffres, sans ponctuation) | Ne jamais transmettre la version formatée 123.456.789-00 |
| CNPJ | 00038166000105 ou 12ABC34501DE35 | Le manuel officiel donne les deux : votre validation ne peut pas être un ^[0-9]{14}$, le CNPJ peut comporter des lettres |
| Téléphone mobile | +5561912345678 (format international, indicatif pays inclus) | Le +55 fait partie de la clé ; un numéro national nu n'est pas une chave |
| Chave aleatória | 123e4567-e12b-12d1-a456-426655440000 (UUID avec ses tirets) | Ici les tirets sont obligatoires ; dans le txid ils sont interdits (voir plus bas) |
00 02 01 Payload Format Indicator
26 58 Merchant Account Information
00 14 br.gov.bcb.pix GUI de l'arrangement Pix
01 36 123e4567-e12b-12d1-a456-426655440000 chave (aléatoire)
52 04 0000 Merchant Category Code (non renseigné)
53 03 986 devise ISO 4217 (986 = BRL)
58 02 BR Country Code
59 13 Fulano de Tal Merchant Name
60 08 BRASILIA Merchant City
62 07 Additional Data Field
05 03 *** txid absent -> "***" par convention EMV
63 04 1D3D CRC16 (polynôme 0x1021, valeur initiale 0xFFFF)
Payload concatene effectivement encode dans le QR :
00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-42665544000052040000
5303986
5802BR
5913Fulano de Tal
6008BRASILIA
62070503***
63041D3DStatique ou dynamique : ce que change le txid
- QR statique : généré par vous, sans appel d'API. Le BCB précise que sa création ne fait pas partie de l'API Pix. Le montant peut être absent (le payeur le saisit). Son identifiant de transaction est l'objet EMV
62-05, limité à 25 caractères ; si vous n'en mettez pas, la convention EMV impose la valeur***. - QR dynamique : créé par
PUT /cob/{txid}(paiement immédiat) ouPUT /cobv/{txid}(avec échéance). Le QR ne porte alors qu'unelocationpointant vers un payload JSON hébergé chez votre PSP. - Le `txid` de l'API Pix suit le motif `[a-zA-Z0-9]{26,35}` : ni tiret, ni underscore, ni point, minimum 26 caractères. Un UUID canonique et un numéro de commande court sont tous deux invalides, et c'est le refus n° 1 des intégrations débutantes.
- Le `txid` est unique par CPF/CNPJ du recebedor et le PSP doit faire respecter cette règle : rejouer un identifiant de commande sur un nouvel essai de paiement échoue.
- Les `location` sont des URL sans préfixe de protocole, accédées exclusivement en HTTPS après validation, et limitées à 77 caractères. Le fragment de chemin porte le type : absent ou
/cob/pour l'immédiat,/cobv/pour l'échéance,/rec/pour la récurrence. - `calendario.expiracao` est en secondes et vaut 86 400 par défaut ; un QR de caisse a rarement besoin de plus d'une heure de durée de vie. L'exemple officiel du BCB utilise
3600.
{
"calendario": { "criacao": "2020-09-09T20:15:00.358Z", "expiracao": 3600 },
"txid": "7978c0c97ea847e78e8849634473c1f1",
"revisao": 0,
"loc": {
"id": 789,
"location": "pix.example.com/qr/9d36b84fc70b478fb95c12729b90ca25",
"tipoCob": "cob"
},
"status": "ATIVA",
"devedor": { "cnpj": "12345678000195", "nome": "Empresa de Servicos SA" },
"valor": { "original": "37.00", "modalidadeAlteracao": 1 },
"chave": "7d9f0335-8dcc-4054-9bf9-0dbd61d36906",
"solicitacaoPagador": "Servico realizado."
}PUT /webhook/{chave}) et qui est protégé par mTLS. Elle ajoute que « le SLA spécifique à définir dans le contexte des déclenchements des callbacks relève de chaque PSP recebedor ». Le BCB recommande seulement un délai raisonnable, et autorise les PSP à grouper plusieurs Pix d'une même clé dans un seul appel. Sur le plan de l'architecture, le webhook est un accélérateur ; la vérité est dans GET /pix. Prévoyez un poller de rattrapage et un traitement idempotent des notifications groupées.CMD-2026-1042 comme txid dans PUT /cob/{txid}. Que renvoie le PSP ?Chapitre 3. Pix Automático : l'abonnement sans carte.
Le Pix Automático est en production depuis le 16 juin 2025, et l'offre est obligatoire pour toutes les institutions proposant des comptes transactionnels aux payeurs. Le payeur accorde une autorisation à son PSP, puis vous envoyez périodiquement des cobranças recorrentes que le PSP payeur planifie et règle automatiquement. Vous n'encaissez plus une carte qui expire, mais un compte. L'adoption, elle, reste modeste, avec environ 2,87 millions d'opérations pour R$ 1,2 milliard en mai 2026, contre 919 000 et R$ 568,7 millions en janvier 2026 (Finsiders Brasil, juin 2026). Traitez-le comme un canal complémentaire, pas comme un remplacement de la carte en récurrent.
SolicRec) vers le compte du payeur. Seule cette jornada permet au payeur de rejeter explicitement l'autorisation.ativacao.dadosJornada.txid devient obligatoire, puisqu'il pointe la cobrança immédiate payée à l'autorisation.idRec commençant par C et ne sont ni modifiables ni consultables via l'API Pix.Les cinq jornadas correspondent aux alinéas a) à e) du Regulamento do Pix, art. 11-Q, § 1º, inciso VII, insérés par la Resolução BCB nº 402 du 22 juillet 2024. Trois objets structurent l'intégration. La `Rec` porte la récurrence : objet du débit, périodicité, date initiale. La `SolicRec` est la demande de confirmation, spécifique à la Jornada 1, et la `CobR` désigne chaque cobrança recorrente envoyée à l'échéance. La périodicité est une énumération fermée : SEMANAL, MENSAL, TRIMESTRAL, SEMESTRAL, ANUAL, à l'exclusion de toute récurrence « tous les 45 jours ».
| Pix Automático | Débito automático | Carte de crédit en récurrent | |
|---|---|---|---|
| Mise en place | Autorisation donnée par le payeur dans son application, sans convention préalable entreprise-banque | Convention préalable entre le facturier et chaque banque | Enregistrement d'un moyen de paiement dans le tunnel |
| Ce qui casse l'abonnement | Annulation par le payeur, ou un code de rejet « fatal » (voir chapitre 7) | Résiliation de la convention ou du mandat | Expiration, perte, réémission de la carte, échec 3-D Secure |
| Fonds | Monnaie de banque centrale, immédiats et irrévocables | Compensation interbancaire | Créance sur l'acquéreur, réglée à D+30 |
| Retentative en cas d'échec | Cadrée par la norme : NAO_PERMITE ou PERMITE_3R_7D | Selon convention | À votre main (dunning), sans plafond normatif |
| Coût pour vous | Tarification Pix personne morale de votre PSP | Tarification bancaire | MDR crédit, moyenne 2,16 % au S1 2025 (BCB) |
Champ de la récurrence, la politique de retentative n'a que deux valeurs possibles : NAO_PERMITE, ou PERMITE_3R_7D. Cette seconde valeur autorise « jusqu'à 3 retentatives, des jours différents, dans un intervalle de 7 jours calendaires comptés à partir de la date de liquidation prévue dans l'instruction de paiement d'origine ». Ce choix est inscrit dans l'identifiant de la récurrence : un idRec commence par RR (créée dans le Pix, retentatives autorisées), RN (dans le Pix, sans retentative), CR ou CN pour les équivalents Open Finance. Deux autres retentatives existent, hors de votre contrôle. La première, intra-journalière, répond au défaut de provision et relève du seul PSP payeur, tandis que la seconde, intra-journalière elle aussi, répond à l'erreur de liquidation. Les ajustements éventuels d'un paiement effectué après l'échéance ne s'appliquent qu'à la cobrança suivante.
politicaRetentativa: "PERMITE_3R_7D" sur une récurrence Pix Automático ?Chapitre 4. Parcelado et antecipação : calculer le coût réel.
Deux fractionnements coexistent au Brésil et ne doivent jamais être confondus dans un contrat d'acquisition. Dans le parcelado emissor (com juros), crédit consenti par l'émetteur, vous êtes réglé comme sur une vente comptant, et l'acheteur paie des intérêts à sa banque. Le parcelado lojista (sem juros), lui, est porté par vous. Le client ne paie aucun intérêt affiché, et vous êtes réglé échéance par échéance, de mois en mois. Ce mécanisme est la matrice de toute la trésorerie du commerce brésilien, et aussi la raison d'être de l'antecipação de recebíveis, l'escompte de vos créances futures.
| Paramètre | Ce qui s'applique | Base ou source |
|---|---|---|
| Interchange débit | Plafond 0,50 %, taux ferme | Resolução BCB nº 246/2022, en vigueur depuis le 1ᵉʳ avril 2023 |
| Interchange prépayé | Plafond 0,70 % | Resolução BCB nº 246/2022 |
| Interchange crédit | Non plafonné ; moyenne constatée 1,68 % au S1 2025 | Banco Central do Brasil, novembre 2025 |
| MDR moyen | 2,16 % en crédit, 1,08 % en débit | Banco Central do Brasil, S1 2025 |
| Règlement crédit à vista | Usage de place : D+30 | Pratique de marché ; délais encadrés par la Resolução BCB nº 246/2022 |
| Règlement parcelado lojista | Une échéance tous les 30 jours jusqu'au dernier parcela | Pratique de marché |
| Taux d'antecipação | Négocié, non publié, la variable qui décide de votre coût réel | Contrat ; spread de marché descendu à un plus bas de 0,15 point en août 2023 (CERC, sur données BCB) |
| Vale-refeição / alimentação | MDR plafonné à 3,6 %, deságio et rebate interdits | Decreto nº 12.712/2025, sur la base de la Lei nº 14.442/2022 |
La formule, puis le chiffre
Donnees de la vente
Montant brut V = R$ 1 200,00
Nombre de parcelas n = 6 (parcelado lojista, sem juros pour le client)
MDR credit = 2,16 % (moyenne BCB, S1 2025)
Taux d'antecipacao a = 1,5 % / mois <-- HYPOTHESE DE CALCUL, PAS UN
TAUX DE MARCHE : remplacez-le
par celui de VOTRE grille
Etape 1 : commission d'acquisition
MDR = 1 200,00 x 2,16 % = R$ 25,92
Net du = 1 200,00 - 25,92 = R$ 1 174,08
Parcela = 1 174,08 / 6 = R$ 195,68
(echeances a D+30, D+60, ... D+180)
Etape 2 : cout de l'anticipation de la totalite de l'agenda
Somme des mois d'attente = n(n+1)/2 = 6 x 7 / 2 = 21 mois-parcela
Cout = 195,68 x 1,5 % x 21 = R$ 61,64
Etape 3 : cout total et taux effectif
Cout total = 25,92 + 61,64 = R$ 87,56
Taux effectif = 87,56 / 1 200,00 = 7,30 % du brut
Verifiez dans VOTRE contrat quelle convention d'escompte s'applique
(simple ou composee, sur le brut ou sur le net) : sur 12 parcelas,
l'ecart entre deux conventions se compte en points de marge.| Scénario | Coût direct | Coût du temps | Coût total | Fonds disponibles |
|---|---|---|---|---|
| Pix | ≈ R$ 12,00 à 1,00 % (grilles de place 2026 : 0,89 % à 1,45 %) | Nul | ≈ 1,00 % | En secondes |
| Crédit à vista, non anticipé | R$ 25,92 (MDR 2,16 %) | Nul, mais D+30 de décalage | 2,16 % | D+30 |
| Crédit à vista, anticipé | R$ 25,92 | R$ 17,61 (1 mois) | 3,63 % | Immédiats |
| Parcelado 6×, non anticipé | R$ 25,92 | Nul, mais 6 mois d'étalement | 2,16 % | D+30 → D+180 |
| Parcelado 6×, anticipé | R$ 25,92 | R$ 61,64 (21 mois-parcela) | 7,30 % | Immédiats |
Ce tableau explique pourquoi, au Brésil, négocier le MDR sans négocier l'antecipação revient à discuter d'un quart du coût réel. Il éclaire aussi le modèle économique des acquéreurs locaux. Rede a publié en 2025 R$ 2,058 milliards de revenus de prestation de services pour R$ 3,770 milliards de revenus d'intermédiation financière, soit près du double. L'acquéreur brésilien ne vous vend pas une commission, il vous vend de la trésorerie.
Chapitre 5. Choisir un acquéreur dans le marché le plus concurrentiel du monde.
Le Brésil est l'un des rares marchés au monde où l'acquisition se déconcentre. La part cumulée des quatre premiers acquéreurs est passée d'environ 84,8 % au T1 2019 à 72,7 % au T3 2023 (données du Banco Central do Brasil reprises par la presse spécialisée). Vous n'arrivez donc pas dans un duopole dont on subit la grille, mais dans un marché où cinq acteurs d'échelle se disputent votre agenda de recevables, plus une longue traîne de sub-acquéreurs et de wallets. Négociez en conséquence.
| Levier | La question à poser | La preuve à exiger avant signature |
|---|---|---|
| 1. MDR | Quel taux par bandeira, par produit (débit, crédit à vista, parcelado) et par tranche de volume ? | Une simulation sur votre mix réel de transactions, pas sur un mix moyen. Rappel de repère : moyennes de place 2,16 % en crédit et 1,08 % en débit au S1 2025 (BCB). |
| 2. Délai de règlement | D+quoi sur le crédit à vista ? Quel calendrier exact sur le parcelado ? | Le calendrier écrit, jour par jour, y compris le traitement des jours non ouvrés. |
| 3. Taux d'antecipação | Quel taux mensuel, quelle convention d'escompte, quel délai de mise à disposition ? | Deux offres concurrentes obtenues via votre registradora, seul moyen de savoir si le taux proposé est un prix ou une rente. |
| 4. Domiciliation de l'agenda | Où mon agenda de recebíveis est-il enregistré, et suis-je libre de le nantir ailleurs ? | La désignation nominative de la registradora (CERC, Nuclea, TAG, B3 ou CRDC) et l'absence de clause d'exclusivité de fait. |
| 5. Couverture d'acceptation | Elo est-il activé ? Les vale-refeição sont-ils inclus ou séparés ? | La liste des arranjos activés sur votre MID. Elo pesait 8,7 % des cartes émises au T1 2025 (BCB) ; les vale-refeição relèvent d'affiliations distinctes. |
Une question de due diligence s'est ajoutée en 2025. Elle porte sur l'identité du PSTI de votre prestataire et la portée de son agrément. Un incident l'a imposée. En juillet 2025, une attaque contre C&M Software a permis le détournement d'environ R$ 800 millions depuis les comptes de réserve de ses clients. Ce prestador de serviços de tecnologia da informação connecte au SPB et au SPI les institutions n'y ayant pas d'accès direct. Le vecteur n'était pas une faille du Pix, mais la couche d'intermédiation technique et l'ingénierie sociale sur ses personnels. La réponse réglementaire est venue vite. Les PSTI sont encadrés par la Resolução BCB nº 498/2025, refondue en janvier 2026 puis durcie par la Resolução BCB nº 547/2026, et leur capital minimum est de l'ordre de R$ 15 millions.
Chapitre 6. CNPJ, montage d'encaissement, change et rapatriement.
Trois montages seulement existent pour encaisser un consommateur brésilien, et le choix conditionne tout le reste : taux d'acceptation, accès aux rails, fiscalité, délai de rapatriement. Décidez-le avant l'intégration technique, jamais après. Changer de montage revient à refaire le projet.
| Capacité | Cross-border | Entité locale (CNPJ) | Merchant of record local |
|---|---|---|---|
| Pix (chave, QR, API Pix) | Non | Oui | Oui, au nom du MoR |
| Parcelado sem juros | Non | Oui | Oui |
| Boleto | Non | Oui | Oui |
| Vale-refeição / alimentação | Non | Oui, affiliation dédiée | Selon le MoR |
| Taux d'acceptation carte | Fortement dégradé | Domestique | Domestique |
| Rapatriement des fonds | Immédiat, en devise | Opération de change dédiée | Assuré par le MoR |
| Charge de conformité | Faible | Élevée (CNPJ, fiscalité, éventuel agrément IP) | Transférée au MoR |
| Qui figure sur le relevé du client | Vous, à l'étranger | Votre entité brésilienne | Le MoR |
Le CNPJ : la clé d'identité de tout votre encaissement
- Le CNPJ n'est pas qu'un numéro fiscal, c'est l'identifiant de règlement. Il porte la chave Pix personne morale, il identifie le
recebedorde chaque cobrança, il est le titulaire de l'agenda de recebíveis et il est la clé d'unicité du `txid` : la spécification API Pix impose que le txid soit unique par CPF/CNPJ du recebedor. - Structure : 14 caractères, dont une racine de 8 identifiant l'entreprise. Le manuel du BCB s'appuie explicitement sur cette racine pour construire l'
idRecdu Pix Automático quand l'agent est un prestataire d'initiation (« les 8 premiers caractères du CNPJ »). - Le CNPJ peut contenir des lettres. Le Manual de Padrões para Iniciação do Pix v2.9.0 donne deux exemples de chave CNPJ valides :
00038166000105et12ABC34501DE35. Toute validation en^[0-9]{14}$dans votre code, votre ERP ou votre référentiel tiers casse sur ce format. À corriger avant la mise en production, pas après. - Le PSP recebedor vérifie que vous êtes titulaire du compte déclaré dans la cobrança : impossible de faire encaisser un tiers sous votre CNPJ sans montage de sub-acquisition ou de split en bonne et due forme.
- Le CPF, son équivalent personne physique, apparaît côté payeur : la consultation du DICT renvoie au payeur, avant confirmation, le nom du bénéficiaire, son CPF masqué ou son CNPJ et la clé, jamais l'agence ni le numéro de compte. Le contrôle du bénéficiaire est dans le rail : aucune surcouche de type confirmation of payee n'est à construire.
Le change est régi par la Lei nº 14.286 du 29 décembre 2021, qui a remplacé un édifice remontant à 1935. La Resolução BCB nº 277 du 31 décembre 2022 la met en œuvre. Deux points opérationnels. La finalité de l'opération doit être déclarée jusqu'à un seuil de 50 000 dollars, avec basculement de la responsabilité déclarative vers l'institution autorisée. Le régime reconnaît aussi explicitement les prestataires eFX, ces fintechs non autorisées au change qui opèrent en s'adossant contractuellement à une institution qui l'est. Cette voie est la porte d'entrée réglementaire de la plupart des acteurs transfrontaliers présents au Brésil, d'où la question à poser à votre PSP, l'institution autorisée sous laquelle votre change est exécuté.
^[0-9]{14}$. Quel incident cela provoque-t-il ?Chapitre 7. Les refus les plus fréquents, et comment les traiter.
Au Brésil, trois familles de refus se ressemblent dans un tableau de bord et n'ont rien à voir. Le refus d'intégration vient d'une requête invalide, quand le refus de règlement vient d'un payeur qui ne peut pas payer. Le faux refus n'en est pas un. Rien n'a échoué, vous ne l'avez simplement pas vu. Les confondre conduit à la pire décision possible, réessayer.
| Symptôme | Cause exacte | Correctif |
|---|---|---|
400 sur PUT /cob/{txid} | Le txid ne respecte pas [a-zA-Z0-9]{26,35} | Générer un identifiant alphanumérique de 26 à 35 caractères ; ne jamais réutiliser un UUID canonique |
| 400 « txid déjà utilisé » | Le txid est unique par CPF/CNPJ du recebedor | Ne pas rejouer l'identifiant de commande sur une nouvelle tentative de paiement |
400 sur le champ chave | La chave « correspond à un compte qui n'appartient pas à cet usuário recebedor » | Vérifier que la clé utilisée est bien enregistrée sur le compte du CNPJ contractant |
400 sur valor.original | Valeur à zéro ou hors schéma | Format \d{1,10}\.\d{2} ; refuser en amont les paniers à zéro |
400 sur calendario.expiracao | Valeur nulle ou négative | Exprimer en secondes ; le défaut normatif est 86 400, l'exemple officiel du BCB utilise 3 600 |
400 sur loc.id | Location inexistante, déjà utilisée, ou de type cobv alors que la cobrança est une cob | Un loc par cobrança, et le bon tipoCob |
| 400 à la modification | La cobrança n'est plus au statut ATIVA | Une cobrança expirée ou conclue ne se modifie pas : en créer une nouvelle |
- Refus de règlement en Pix Automático : la tentative porte un objet
rejeicao.codigoissu du Catálogo de Mensagens do SPI. Les dix-neuf codes possibles sontAB10,AC05,AC06,AM02,AM09,DENC,DS27,DTED,DTNT,FBRD,IRNT,MIDI,MSUC,NIEC,NIPA,NITX,QUNT,RC09,UDEI. Neuf d'entre eux ne font pas échouer une tentative, ils tuent la cobrança recorrente :AC05,AM09,DENC,DS27,DTED,MIDI,MSUC,NITXetRC09. Votre logique de relance doit lire le code avant de programmer une retentative. Sur ces neuf-là, il n'y a rien à relancer, il faut refaire souscrire le client. - Refus carte : le hors-frontière. En cross-border pur, le taux d'acceptation s'effondre parce que les émetteurs brésiliens refusent massivement les transactions étrangères. Ce refus-là ne se corrige pas par du retry : il se corrige par un changement de montage (entité locale ou merchant of record).
- Refus carte : bandeira non activée. Elo pesait 8,7 % des cartes émises au T1 2025 (BCB) : ne pas l'activer, c'est refuser structurellement une fraction de la base. À l'inverse, Hipercard est fermé et plus aucune transaction n'est approuvée depuis le 1ᵉʳ juillet 2025, le parc ayant basculé sur Mastercard. Une table de BIN non mise à jour produit des refus fantômes.
- Refus carte : parcelado non prévu. Le nombre de parcelas et le mode (lojista ou emissor) doivent être prévus au contrat d'acceptation et transmis dans la transaction. S'ils ne le sont pas, la vente ne peut tout simplement pas être fractionnée.
- Refus d'acceptation : vale-refeição présentés sur un MID classique. Alelo, Ticket (Edenred), VR, Pluxee Brasil, Caju et Flash opèrent des arranjos de pagamento fermés : ils exigent une affiliation séparée, avec leurs propres règles. Leur MDR est plafonné à 3,6 % par le Decreto nº 12.712/2025.
PUT /pix/{e2eid}/devolucao/{id}. Votre service client brésilien doit savoir faire cette distinction, sans quoi il renverra des clients vers leur banque pour rien.- Le faux refus n° 1 : le webhook qui n'arrive pas. Le SLA des callbacks relève de chaque PSP recebedor, pas de la norme, et les PSP sont autorisés à grouper plusieurs Pix d'une même chave dans un seul appel. Un poller
GET /pixet un traitement idempotent transforment ce « refus » en simple latence. - Le faux refus n° 2 : le boleto non enregistré. Depuis la Nova Plataforma de Cobrança exploitée par Nuclea, le boleto « hors registre » n'existe plus : sans enregistrement centralisé, le paiement est impossible. Un boleto « refusé au guichet » est presque toujours un boleto jamais enregistré.
- Le faux refus n° 3 : le QR illisible. Les
locationsont limitées à 77 caractères sans préfixe de protocole, en HTTPS exclusivement. Une URL trop longue ou préfixée produit un QR que les applications refusent d'ouvrir. Le paiement n'a jamais été tenté. - Le faux refus n° 4 : le Pix « perdu ». Réconciliez toujours sur l'
EndToEndId(32 caractères alphanumériques exactement), pas sur le montant : un même montant peut arriver plusieurs fois dans la même seconde, et letxidpeut être absent d'un Pix initié par saisie manuelle de la clé.
rejeicao.codigo = "AM09". Que doit faire votre logique de relance ?