Langsung ke konten utama
Pix adalah sistem pembayaran instan Brasil yang dibuat oleh Bank Sentral Brasil (Banco Central do Brasil). Ini memungkinkan transfer real-time 24/7, termasuk akhir pekan dan hari libur, dan telah menjadi metode pembayaran paling populer di Brasil.

​
Mengapa Menawarkan Pix?

Dominant in Brazil

Pix adalah metode pembayaran yang paling banyak digunakan di Brasil, melampaui kartu kredit dan boleto.

Instant Settlement

Pembayaran dikonfirmasi dalam hitungan detik, 24/7/365 — tidak perlu menunggu jendela pemrosesan bank.

Low Friction

Pelanggan membayar melalui kode QR atau salin-tempel kunci — tidak perlu nomor kartu atau detail bank.

​
Ikhtisar

DetailNilai
Mata Uang TagihanBRL
Negara yang DidukungBrazil
LanggananTidak
Jumlah Minimum$0.50
PenyelesaianInstan

​
Cara Kerjanya

​
Pengalaman Pelanggan

  1. Pelanggan memilih Pix saat checkout
  2. Kode QR dan kunci salin-tempel ditampilkan
  3. Pelanggan membuka aplikasi perbankan mereka dan memindai kode QR atau menempelkan kunci
  4. Pembayaran dikonfirmasi seketika
  5. Pelanggan diarahkan ke halaman sukses
Kode QR Pix biasanya kedaluwarsa setelah waktu tertentu. Jika pelanggan tidak menyelesaikan pembayaran tepat waktu, mereka perlu memulai ulang checkout.

​
Konfigurasi

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'
});

​
Jenis Metode API

JenisMetodeNegara
pixPixBrazil

​
Pengujian

1

Enable test mode

Gunakan kunci API pengujian Dodo Payments Anda.
2

Set billing currency to BRL

Pastikan mata uang tagihan diatur ke BRL dalam permintaan checkout Anda.
3

Enter test CPF and scan the QR code

Saat diminta untuk CPF Pix, masukkan 1234567890. Kode QR uji akan dihasilkan — pindai dengan kamera ponsel normal Anda (tidak perlu aplikasi Pix). Anda akan diarahkan ke halaman uji Stripe di mana Anda dapat mensimulasikan transaksi sebagai keberhasilan atau kegagalan.

​
Praktik Terbaik

Pix hanya bekerja dengan BRL. Pastikan harga Anda mendukung transaksi Real Brasil untuk pasar Brasil.
Tidak semua pelanggan Brasil mungkin lebih suka Pix. Selalu sertakan credit dan debit sebagai opsi cadangan.
Kode QR Pix kedaluwarsa setelah waktu tertentu. Pastikan checkout Anda menangani kedaluwarsa dengan baik dan memungkinkan pelanggan untuk membuat ulang kode.

​
Pemecahan Masalah

Periksa:
  1. Mata uang tagihan diatur ke BRL?
  2. pix termasuk di allowed_payment_method_types?
  3. Negara penagihan pelanggan adalah Brasil?
Solusi: Pix hanya tersedia untuk transaksi BRL. Verifikasi mata uang dan alamat penagihan dalam permintaan API Anda.
Penyebab: Pelanggan tidak menyelesaikan pembayaran dalam jangka waktu kedaluwarsa.Solusi: Pelanggan perlu memulai ulang checkout untuk membuat kode QR baru.
Penyebab: Pembayaran Pix biasanya dikonfirmasi seketika, tetapi sesekali terjadi penundaan dari pihak bank.Solusi: Pantau webhooks untuk konfirmasi pembayaran. Jika pembayaran tidak terkonfirmasi dalam beberapa menit, anggap sebagai gagal.

​
Halaman Terkait

Payment Methods Overview

Lihat semua metode pembayaran yang didukung.

Adaptive Currency

Dukungan mata uang dan konversi otomatis.

Checkout Guide

Panduan lengkap implementasi checkout.

Webhooks

Tangani konfirmasi pembayaran secara asinkron.
Last modified on April 1, 2026