Skip to main content
Permettez aux clients brésiliens de payer depuis leur application bancaire en scannant un code QR ou en collant un code Pix. Pix est le système de paiement instantané du Brésil, créé par la Banque centrale du Brésil (Banco Central do Brasil). Il transfère l’argent en temps réel, 24 heures sur 24, y compris les week-ends et les jours fériés. Dodo Payments propose Pix pour les paiements ponctuels et les abonnements facturés en BRL.

​
Pourquoi proposer Pix ?

Dominant in Brazil

Pix est le moyen de paiement le plus utilisé au Brésil, devant les cartes de crédit et les boletos. La Banque centrale du Brésil indique que Pix représentait 54,7 % de toutes les transactions de paiement au cours du second semestre 2025.

Instant Settlement

Les transferts Pix sont effectués en quelques secondes, à toute heure et tous les jours de l’année. Il n’est donc pas nécessaire d’attendre une fenêtre de traitement bancaire.

Low Friction

Le client scanne un code QR ou colle un code Pix dans son application bancaire. Il n’a pas besoin de saisir de numéro de carte ni de coordonnées bancaires.

​
Vue d’ensemble

Le montant minimum correspond au montant minimum du checkout en BRL et s’applique donc à tous les moyens de paiement d’un checkout en BRL.

​
Fonctionnement

​
Expérience client

  1. Le client sélectionne Pix lors du checkout et saisit son CPF (le numéro fiscal brésilien à 11 chiffres) dans le champ Pix CPF.
  2. Le client confirme le paiement. Un code QR s’ouvre dans une superposition en plein écran, avec le code Pix et un bouton Copier le code en dessous.
  3. Le client ouvre son application bancaire, sélectionne Pix, puis scanne le code QR ou colle le code Pix.
  4. Le paiement est confirmé en quelques secondes.
  5. Le checkout détecte que le paiement est terminé et redirige le client vers votre page de réussite.
Le code QR Pix expire après un délai limité. Si le client ne paie pas à temps, il doit démarrer un nouveau checkout depuis votre site.

​
Configuration

Pix apparaît sur les checkouts ponctuels et d’abonnement facturés en BRL. Dodo Payments facture en BRL uniquement lorsque Adaptive Currency est activé. Activez donc cette fonctionnalité avant de proposer Pix.

​
Type de méthode API

​
Tests

1

Enable Test Mode

Désactivez le bouton Live Mode dans la barre latérale du dashboard et utilisez les clés API créées en mode test.
2

Set Billing Currency to BRL

Activez Adaptive Currency. Créez ensuite une session de checkout avec billing_currency: 'BRL' et pix dans allowed_payment_method_types.
3

Enter Test CPF and Scan the QR Code

Dans le champ Pix CPF, saisissez 00000000000 (11 zéros). Le checkout affiche un code QR de test. Scannez-le avec l’appareil photo de votre téléphone ; aucune application Pix ou bancaire n’est nécessaire. Le code QR ouvre une page de test sur laquelle vous pouvez simuler un paiement réussi ou échoué.

​
Bonnes pratiques

Pix fonctionne uniquement sur les checkouts facturés en BRL, et Dodo Payments facture en BRL uniquement lorsque Adaptive Currency est activé. Activez Adaptive Currency afin que les clients au Brésil voient les prix et soient facturés en BRL.
Certains clients brésiliens préfèrent payer par carte. Incluez credit et debit comme moyens de paiement de secours.
Les codes QR Pix expirent après un délai limité. Si un client revient après l’expiration du code, créez une nouvelle session de checkout pour lui.

​
Dépannage

Vérifications :
  1. La devise de facturation est-elle BRL ?
  2. pix est-il inclus dans allowed_payment_method_types ?
  3. Le pays de facturation du client est-il le Brésil (BR) ? Avec Adaptive Currency, une adresse de facturation brésilienne définit la devise de facturation sur BRL.
  4. Adaptive Currency est-il activé ?
  5. Le montant atteint-il le minimum de 0.50 BRL ?
Solution : Pix est proposé uniquement sur les checkouts en BRL. Vérifiez la devise et l’adresse de facturation dans votre requête API.
Cause : Le client n’a pas terminé le paiement pendant la période de validité.Solution : Le client doit démarrer un nouveau checkout depuis votre site. Pour lui envoyer un nouveau lien de paiement, créez une nouvelle session de checkout.
Cause : La plupart des paiements Pix sont confirmés en quelques secondes, mais il peut arriver qu’une banque retarde un transfert.Solution : Utilisez les webhooks payment.succeeded et payment.failed pour connaître l’état final du paiement au lieu de la redirection de retour. Si le paiement n’est pas confirmé après quelques minutes, considérez-le comme échoué.

​
Pages associées

Payment Methods Overview

Consultez tous les moyens de paiement pris en charge.

Adaptive Currency

Facturez vos clients dans leur devise locale, notamment en BRL.

Checkout Guide

Guide complet de mise en œuvre du checkout.

Webhooks

Gérez les confirmations de paiement de manière asynchrone.

Testing Process

Données de test et instructions pour tester le checkout.
Dernière modification le 26 septembre 2026