Aller au contenu

Moyens de paiement · Brésil

Pix au Brésil : des paiements instantanés, à l’encaissement et au décaissement

Encaissez par QR code ou Copia e Cola, attribuez des clés Pix à vos clients et payez les bénéficiaires en temps réel, 24/7, depuis une seule intégration.

Contacter les ventesVoir la documentation
  • Virement instantané
  • Brésil
  • Encaissement · Décaissement

Chiffres clés

Pix à l’échelle nationale

Chiffres publiés par la Banque centrale du Brésil.

De quoi s’agit-il

Le rail de paiement instantané du Brésil

Pix est le système de paiement instantané créé par la Banque centrale du Brésil. Le payeur valide dans l’application de sa banque et l’argent circule entre les comptes en quelques secondes, à toute heure. Avec Localpayment, vous l’utilisez de trois façons : comme méthode d’encaissement, comme compte virtuel identifié par une clé Pix et comme rail de décaissement.

  • Encaissement par QR code ou Copia e Cola, confirmé par webhook
  • Compte virtuel avec clé Pix (e-mail, téléphone ou clé aléatoire) qui reçoit aussi les TED
  • Décaissements Pix en temps réel, 24/7, et TED pour des virements le jour même ou J+1

Comment ça marche

Comment fonctionne un paiement Pix

Les acteurs et les étapes suivent le flux documenté. Le statut final arrive toujours par webhook signé.

  1. 1

    ClientVotre entreprise:

    Choisit Pix

    Dans votre checkout ou via un lien de paiement.

  2. 2

    Votre entrepriseLocalpayment:

    Crée l’encaissement

    POST /api/payin/ avec le pays, la devise, le montant et les données du payeur. La réponse contient l’image du QR Pix et le code Copia e Cola, avec une date d’expiration. Statut 100 (INPROGRESS).

  3. 3

    ClientBanque · Pix:

    Valide dans l’app de la banque ou du wallet

    Le payeur scanne le QR ou colle le code dans l’app de sa banque et confirme le paiement.

  4. 4

    LocalpaymentVotre entreprise:

    Webhook avec le statut final

    Localpayment reçoit la confirmation et met à jour la transaction. Signé en HMAC-SHA256 (x-Signature). Le statut 200 signifie terminé ; dédoublonnez sur externalId.

Schéma simplifié. Les délais dépendent du rail et de la banque ; voir les informations clés ci-dessous.

Comment ça marche

Comment fonctionne un décaissement Pix

Les acteurs et les étapes suivent le flux documenté. Le statut final arrive toujours par webhook signé.

  1. 1

    Votre entrepriseLocalpayment:

    Envoie la demande de décaissement

    POST /api/payout/ avec les données du bénéficiaire, le montant et l’externalId. Les contrôles de conformité s’appliquent ; avec requireAuth, un second approbateur valide avant tout mouvement de fonds.

  2. 2

    LocalpaymentBanque · Pix:

    Bloque les fonds et envoie l’instruction

    Le décaissement passe de Locked à In Progress via Pix.

  3. 3

    Banque · PixBénéficiaire:

    Crédite le bénéficiaire

    Les délais dépendent du rail ; voir les informations clés ci-dessous.

  4. 4

    LocalpaymentVotre entreprise:

    Webhook : décaissement terminé

    Localpayment met le décaissement à son statut final. Webhook signé avec le statut final ; la preuve de paiement peut être téléchargée.

Schéma simplifié. Les délais dépendent du rail et de la banque ; voir les informations clés ci-dessous.

Comment ça marche

Pix en action

Un parcours simplifié et fictif. Les noms et les montants sont des exemples.

  1. 1PixUn QR code (ou un code à copier-coller) est affiché au payeur.
  2. 2Banco EjemploLe payeur vérifie BRL 249,90 et valide dans l’app de sa banque ou de son wallet.
  3. 3Paiement confirméVotre système reçoit le webhook signé et libère la commande.
Contacter les ventes

Informations clés

Pix : informations clés

  • Pays

    Détail
    🇧🇷 Brésil

  • Devise

    Détail
    BRL

  • Sens

    Détail
    Encaissement et décaissement

  • Encaissement · Pix (QR et Copia e Cola)

    Détail
    Temps réel, confirmé par webhook · BRL 0,01 – 1 000 000

  • Encaissement · Compte virtuel (Pix or TED)

    Détail
    Temps réel, confirmé par webhook · BRL 0,01 – 2 000 000

  • Décaissement · Pix

    Détail
    Temps réel, 24/7 · Min. BRL 0,06, sans plafond

  • Décaissement · Virement bancaire (TED)

    Détail
    Le jour même ou J+1, heure limite 17:00 (heure de Brasília)

  • Règlement des décaissements

    Détail
    Temps réel, 24/7, week-ends et jours fériés compris

Tiré de la documentation Localpayment de chaque pays. Les plafonds et la disponibilité peuvent évoluer ; confirmez-les avec votre gestionnaire de compte.

Expérience client

Ce que voit votre client avec Pix

Autorisation, plafonds et remboursements selon docs.localpayment.com. Les plafonds ne sont affichés que lorsque la documentation les précise.

  • Comment le client autorise

    Le client scanne le QR avec l’app de sa banque ou de son wallet, ou colle le code Copia e Cola dans le champ « Payer avec un code Pix », vérifie le montant et confirme. La réponse contient une date d’expiration ; affichez un compte à rebours et créez un nouvel encaissement si elle est dépassée.

  • Plafonds documentés

    Pix (QR et Copia e Cola) (Encaissement): BRL 0,01 – 1 000 000 · Compte virtuel (Pix or TED) (Encaissement): BRL 0,01 – 2 000 000 · Pix (Décaissement): Min. BRL 0,06, sans plafond. Par transaction, selon la documentation publiée ; les plafonds contractuels peuvent différer.

  • Remboursements et retours

    Un encaissement terminé se rembourse avec PATCH /api/payin/{externalId}/refund. Seuls les remboursements intégraux sont pris en charge ; l’argent revient sur un compte bancaire du payeur et la transaction se termine au statut 902 (REFUNDED). Tant qu’un paiement est en attente, il peut être annulé.

Checklist d’intégration

Passez en production avec Pix en cinq étapes

La même séquence pour chaque rail. Regardez le checkout animé de ce pays avant de développer.

  1. Obtenez des identifiants Stage

    Demandez l’accès, recevez des identifiants sandbox et obtenez un JWT via POST /api/token/.

  2. Créez l’encaissement

    POST /api/payin/ avec le code Localpayment du tableau des informations clés, le pays ISO-3, la devise, le montant et les données du payeur.

  3. Affichez les instructions

    Affichez le QR, le code, la redirection ou les coordonnées renvoyés et respectez la date d’expiration.

  4. Vérifiez le webhook

    Validez x-Signature (HMAC-SHA256), libérez la commande au statut 200 et dédoublonnez sur externalId.

  5. Regardez le checkout animé

    Chaque méthode de ce pays, écran par écran, dans la galerie des expériences de paiement.

Historique

Comment Pix est devenu le moyen de paiement par défaut

Source : Banco Central do Brasil, Relatório de Gestão do Pix 2023–2025.

  1. Lancement

    La Banque centrale du Brésil lance Pix sur son infrastructure SPI : virements instantanés entre tous les comptes, 24/7, adressés par clés.

  2. Retrait d’espèces et fonctions commerçants

    Pix Saque et Pix Troco permettent de retirer des espèces chez les commerçants ; le QR dynamique et Copia e Cola font de Pix une méthode de checkout.

  3. Pix Automático

    Les paiements récurrents entrent en service le 16 juin 2025, avec Pix Agendado, le Pix sans contact et l’initiation de paiement Open Finance.

  4. Près de 80 milliards de transactions

    Pix traite 79,8 milliards de transactions dans l’année, dont 43 % de particulier à entreprise, avec plus de 920 millions de clés enregistrées.

Pourquoi Localpayment

Pourquoi utiliser Pix avec Localpayment

  • Une API pour les encaissements et les décaissements

    Pix utilise la même API que toutes les autres méthodes : POST /api/payin/ pour encaisser, POST /api/payout/ pour décaisser, et de nouveaux marchés par configuration.

  • Statut par webhook pour chaque transaction

    Chaque changement de statut est envoyé à votre endpoint, signé en HMAC-SHA256, pour vérifier et automatiser.

  • Rapprochement dans le Business Portal

    Rapprochez chaque transaction via votre externalId et notre internalId, avec les rapports du Business Portal et les API de solde.

Pour aller plus loin

FAQ

Pix : questions fréquentes

En combien de temps un paiement Pix est-il confirmé ?

Pix est un rail en temps réel qui confirme en quelques secondes, 24/7. Pour les encaissements, le statut final vous parvient par webhook signé ; construisez votre parcours de commande autour de cette notification.

Quels sont les plafonds ?

La plage documentée pour les encaissements va de BRL 0,01 à 1 000 000 par transaction. Les décaissements Pix démarrent à BRL 0,06, sans plafond documenté. Consultez le tableau des informations clés et confirmez vos plafonds avec votre gestionnaire de compte.

Puis-je décaisser via Pix et TED ?

Oui. Les décaissements Pix sont en temps réel, 24/7. Le TED est aussi disponible pour des virements le jour même ou J+1, avec une heure limite à 17:00 (heure de Brasília).

Quels types de clé Pix un compte virtuel peut-il utiliser ?

Un compte virtuel Localpayment au Brésil est livré avec une clé Pix (e-mail, téléphone ou clé aléatoire) et des coordonnées de banque, d’agence et de compte, renvoyées à la création. Le payeur envoie un Pix à la clé, ou un Pix ou un TED aux coordonnées du compte : les deux rails créditent le même compte et déclenchent le même webhook.

Puis-je rembourser partiellement un paiement Pix ?

Non. Les remboursements Pix via Localpayment sont intégraux uniquement, demandés avec PATCH /api/payin/{externalId}/refund sur une transaction terminée. L’argent revient au payeur et l’encaissement se termine au statut 902 (REFUNDED).

Pix a-t-il des rétrofacturations ?

Pix est un paiement push autorisé par le payeur dans l’app de sa propre banque : il n’y a pas de rétrofacturation comme pour les cartes. Les litiges se règlent par des remboursements que vous initiez.

Le QR code expire-t-il ?

Oui. Chaque réponse d’encaissement inclut qr.expirationDate. Affichez un compte à rebours dans votre checkout et, à expiration, créez un nouvel encaissement plutôt que de réutiliser l’ancien code.

Ajoutez Pix à vos encaissements

Indiquez-nous vos marchés et vos volumes. Vous démarrez avec des identifiants Stage (sandbox) et nous vous accompagnons jusqu’à la mise en production.

Contacter les ventesVoir la documentation

Comment pouvons-nous vous aider ?

Téléchargez votre exemplaire

Laissez vos coordonnées et recevez l’édition complète immédiatement.