Pix

Biarkan pelanggan di Brasil membayar dari aplikasi perbankan mereka dengan memindai kode QR atau menempelkan kode Pix. Pix adalah sistem pembayaran instan Brasil yang dibuat oleh Central Bank of Brazil (Banco Central do Brasil). Sistem ini memindahkan uang secara real time, 24 jam sehari, termasuk akhir pekan dan hari libur. Dodo Payments menawarkan Pix untuk pembayaran satu kali dan langganan yang ditagihkan dalam BRL.

Mengapa Menawarkan Pix?

Dominant in Brazil

Pix adalah metode pembayaran yang paling banyak digunakan di Brasil, mengungguli kartu kredit dan boleto. Central Bank of Brazil melaporkan bahwa Pix mencakup 54,7% dari seluruh transaksi pembayaran pada paruh kedua tahun 2025.

Instant Settlement

Transfer Pix selesai dalam hitungan detik, kapan saja dan setiap hari sepanjang tahun, sehingga tidak ada jangka waktu pemrosesan bank yang perlu ditunggu.

Low Friction

Pelanggan memindai kode QR atau menempelkan kode Pix di aplikasi perbankan mereka. Mereka tidak perlu memasukkan nomor kartu atau detail bank.

Ikhtisar

Batas minimum adalah batas minimum checkout untuk BRL, sehingga berlaku untuk setiap metode pembayaran pada checkout BRL.

Detail	Nilai
Mata Uang Penagihan	BRL
Negara yang Didukung	Brasil
Langganan	Ya
Jumlah Minimum	0.50 BRL
Penyelesaian	Instan

Cara Kerjanya

Pengalaman Pelanggan

Pelanggan memilih Pix saat checkout dan memasukkan CPF mereka (ID wajib pajak Brasil 11 digit) di kolom Pix CPF.
Pelanggan mengonfirmasi pembayaran. Kode QR terbuka dalam overlay layar penuh, dengan kode Pix dan tombol Salin kode di bawahnya.
Pelanggan membuka aplikasi perbankan mereka, memilih Pix, lalu memindai kode QR atau menempelkan kode Pix.
Pembayaran dikonfirmasi dalam hitungan detik.
Checkout mendeteksi pembayaran yang selesai dan mengarahkan pelanggan ke halaman sukses Anda.

Kode QR Pix kedaluwarsa setelah waktu yang terbatas. Jika pelanggan tidak membayar tepat waktu, mereka perlu memulai checkout baru dari situs Anda.

Konfigurasi

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

Pix muncul pada checkout pembayaran satu kali dan langganan yang ditagihkan dalam BRL. Dodo Payments hanya menagih dalam BRL jika Adaptive Currency diaktifkan, jadi aktifkan fitur tersebut sebelum menawarkan Pix.

Jenis Metode API

Jenis	Metode	Negara
`pix`	Pix	Brasil

Pengujian

Enable Test Mode

Matikan tombol Live Mode di sidebar dasbor, lalu gunakan kunci API yang dibuat dalam mode pengujian.

Set Billing Currency to BRL

Aktifkan Adaptive Currency. Lalu buat sesi checkout dengan billing_currency: 'BRL' dan pix di allowed_payment_method_types.

Enter Test CPF and Scan the QR Code

Di kolom Pix CPF, masukkan 00000000000 (11 angka nol). Checkout menampilkan kode QR pengujian. Pindai kode tersebut dengan kamera ponsel Anda; aplikasi Pix atau perbankan tidak diperlukan. Kode QR membuka halaman pengujian tempat Anda dapat menyimulasikan pembayaran yang berhasil atau gagal.

Praktik Terbaik

Set billing currency to BRL

Pix hanya berfungsi pada checkout yang ditagihkan dalam BRL, dan Dodo Payments hanya menagih dalam BRL jika Adaptive Currency diaktifkan. Aktifkan Adaptive Currency agar pelanggan di Brasil mendapatkan harga dan tagihan dalam BRL.

Provide card fallbacks

Sebagian pelanggan Brasil lebih memilih membayar dengan kartu. Sertakan credit dan debit sebagai metode pembayaran cadangan.

Handle QR code expiration

Kode QR Pix kedaluwarsa setelah waktu yang terbatas. Jika pelanggan kembali setelah kode kedaluwarsa, buat sesi checkout baru untuk mereka.

Pemecahan Masalah

Pix not appearing at checkout

Periksa:

Apakah mata uang penagihan adalah BRL?
Apakah pix disertakan dalam allowed_payment_method_types?
Apakah negara penagihan pelanggan adalah Brasil (BR)? Dengan Adaptive Currency, alamat penagihan Brasil menetapkan mata uang penagihan ke BRL.
Apakah Adaptive Currency diaktifkan?
Apakah jumlahnya memenuhi minimum 0.50 BRL?

Solusi: Pix hanya ditawarkan pada checkout BRL. Periksa mata uang dan alamat penagihan dalam permintaan API Anda.

QR code expired

Penyebab: Pelanggan tidak menyelesaikan pembayaran dalam jangka waktu kedaluwarsa.Solusi: Pelanggan perlu memulai checkout baru dari situs Anda. Untuk mengirimkan payment link baru kepada mereka, buat sesi checkout baru.

Payment pending

Penyebab: Sebagian besar pembayaran Pix dikonfirmasi dalam hitungan detik, tetapi bank terkadang dapat menunda transfer.Solusi: Gunakan webhook payment.succeeded dan payment.failed untuk mendapatkan status pembayaran akhir, bukan pengalihan kembali. Jika pembayaran tidak dikonfirmasi dalam beberapa menit, anggap pembayaran tersebut gagal.

Halaman Terkait

Payment Methods Overview

Lihat semua metode pembayaran yang didukung.

Adaptive Currency

Tagih pelanggan dalam mata uang lokal mereka, termasuk BRL.

Checkout Guide

Panduan lengkap implementasi checkout.

Webhooks

Tangani konfirmasi pembayaran secara asinkron.

Testing Process

Data pengujian dan panduan pengujian checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Mengapa Menawarkan Pix?

Dominant in Brazil

Instant Settlement

Low Friction

Ikhtisar

Cara Kerjanya

Pengalaman Pelanggan

Konfigurasi

Jenis Metode API

Pengujian

Praktik Terbaik

Pemecahan Masalah

Halaman Terkait

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

​Mengapa Menawarkan Pix?

Dominant in Brazil

Instant Settlement

Low Friction

​Ikhtisar

​Cara Kerjanya

​Pengalaman Pelanggan

​Konfigurasi

​Jenis Metode API

​Pengujian

​Praktik Terbaik

​Pemecahan Masalah

​Halaman Terkait

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

Mengapa Menawarkan Pix?

Ikhtisar

Cara Kerjanya

Pengalaman Pelanggan

Konfigurasi

Jenis Metode API

Pengujian

Praktik Terbaik

Pemecahan Masalah

Halaman Terkait