Passer au contenu principal
Pix est le système de paiement instantané du Brésil créé par la Banque Centrale du Brésil (Banco Central do Brasil). Il permet des transferts en temps réel 24h/24 et 7j/7, y compris les week-ends et jours fériés, et est devenu la méthode de paiement la plus populaire au Brésil.

​
Pourquoi proposer Pix ?

Dominant in Brazil

Pix est la méthode de paiement la plus utilisée au Brésil, dépassant les cartes de crédit et le boleto.

Instant Settlement

Les paiements sont confirmés en quelques secondes, 24/7/365 — pas besoin d’attendre les fenêtres de traitement bancaire.

Low Friction

Les clients paient via un code QR ou une clé à copier-coller — pas besoin de numéros de carte ou de coordonnées bancaires.

​
Vue d’ensemble

DétailValeur
Devise de facturationBRL
Pays pris en chargeBrésil
AbonnementsNon
Montant minimum$0.50
RèglementInstantané

​
Comment ça fonctionne

​
Expérience client

  1. Le client sélectionne Pix lors du paiement
  2. Un code QR et une clé à copier-coller s’affichent
  3. Le client ouvre son application bancaire et scanne le code QR ou colle la clé
  4. Le paiement est confirmé instantanément
  5. Le client est redirigé vers la page de succès
Les codes QR Pix expirent généralement après une période déterminée. Si le client ne termine pas le paiement à temps, il doit recommencer le processus de paiement.

​
Configuration

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
Type de méthode API

TypeMéthodePays
pixPixBrésil

​
Test

1

Enable test mode

Utilisez vos clés API de test Dodo Payments.
2

Set billing currency to BRL

Assurez-vous que la devise de facturation est définie sur BRL dans votre demande de paiement.
3

Enter test CPF and scan the QR code

Lorsqu’un CPF Pix est demandé, entrez 1234567890. Un code QR de test sera généré — scannez-le avec votre caméra de téléphone normale (aucune application Pix requise). Vous serez redirigé vers une page de test Stripe où vous pourrez simuler la transaction comme un succès ou un échec.

​
Bonnes pratiques

Pix ne fonctionne qu’avec le BRL. Assurez-vous que vos prix prennent en charge les transactions en réals brésiliens pour le marché brésilien.
Tous les clients brésiliens ne préfèrent pas nécessairement Pix. Incluez toujours credit et debit comme options de secours.
Les codes QR Pix expirent après une période déterminée. Assurez-vous que votre processus de paiement gère l’expiration de manière fluide et permet aux clients de régénérer le code.

​
Dépannage

Vérifiez :
  1. La devise de facturation est-elle définie sur BRL ?
  2. pix est-il inclus dans allowed_payment_method_types ?
  3. Le pays de facturation du client est-il le Brésil ?
Solution : Pix est uniquement disponible pour les transactions en BRL. Vérifiez la devise et l’adresse de facturation dans votre requête API.
Cause : Le client n’a pas complété le paiement dans le délai d’expiration.Solution : Le client doit redémarrer le processus de paiement pour générer un nouveau code QR.
Cause : Les paiements Pix sont confirmés instantanément dans la plupart des cas, mais des retards occasionnels côté banque peuvent survenir.Solution : Surveillez les webhooks pour la confirmation de paiement. Si le paiement n’est pas confirmé dans quelques minutes, traitez-le comme échoué.

​
Pages connexes

Payment Methods Overview

Voir toutes les méthodes de paiement prises en charge.

Adaptive Currency

Prise en charge des devises et conversion automatique.

Checkout Guide

Guide complet d’implémentation du processus de paiement.

Webhooks

Gérer les confirmations de paiement de manière asynchrone.
Last modified on April 1, 2026