Chuyển đến nội dung chính
Pix là hệ thống thanh toán ngay lập tức của Brazil được tạo ra bởi Ngân hàng Trung ương Brazil (Banco Central do Brasil). Nó cho phép chuyển tiền theo thời gian thực 24/7, bao gồm cả cuối tuần và ngày lễ, và đã trở thành phương thức thanh toán phổ biến nhất ở Brazil.

​
Tại Sao Cung Cấp Pix?

Dominant in Brazil

Pix là phương thức thanh toán được sử dụng nhiều nhất ở Brazil, vượt qua thẻ tín dụng và boleto.

Instant Settlement

Thanh toán được xác nhận trong vài giây, 24/7/365 — không cần chờ đợi các khung xử lý ngân hàng.

Low Friction

Khách hàng thanh toán qua mã QR hoặc sao chép-dán khóa — không cần số thẻ hoặc chi tiết ngân hàng.

​
Tổng Quan

Chi TiếtGiá Trị
Đơn Vị Tiền Thanh ToánBRL
Các Quốc Gia Hỗ TrợBrazil
Đăng KýKhông
Số Tiền Tối Thiểu$0.50
Giải QuyếtNgay lập tức

​
Cách Hoạt Động

​
Trải Nghiệm Khách Hàng

  1. Khách hàng chọn Pix tại thanh toán
  2. Một mã QR và khóa sao chép-dán được hiển thị
  3. Khách hàng mở ứng dụng ngân hàng và quét mã QR hoặc dán khóa
  4. Thanh toán được xác nhận ngay lập tức
  5. Khách hàng được chuyển đến trang thành công
Mã QR Pix thường hết hạn sau một khoảng thời gian nhất định. Nếu khách hàng không hoàn tất thanh toán kịp thời, họ cần khởi động lại quá trình thanh toán.

​
Cấu Hình

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

​
Loại Phương Thức API

LoạiPhương ThứcQuốc Gia
pixPixBrazil

​
Kiểm Tra

1

Enable test mode

Sử dụng các khóa API kiểm tra của Dodo Payments.
2

Set billing currency to BRL

Đảm bảo đơn vị tiền thanh toán được đặt thành BRL trong yêu cầu thanh toán của bạn.
3

Enter test CPF and scan the QR code

Khi được yêu cầu nhập mã Pix CPF, nhập 1234567890. Một mã QR kiểm tra sẽ được tạo — quét nó bằng camera điện thoại thông thường của bạn (không cần ứng dụng Pix). Bạn sẽ được chuyển đến trang kiểm tra Stripe nơi bạn có thể mô phỏng giao dịch thành công hoặc thất bại.

​
Thực Hành Tốt Nhất

Pix chỉ hoạt động với BRL. Đảm bảo giá của bạn hỗ trợ các giao dịch bằng đồng Real Brazil cho thị trường Brazil.
Không phải tất cả khách hàng Brazil đều ưu tiên sử dụng Pix. Luôn bao gồm credit và debit như các tùy chọn dự phòng.
Mã QR Pix hết hạn sau một khoảng thời gian đặt trước. Đảm bảo quy trình thanh toán của bạn xử lý việc hết hạn một cách thuận lợi và cho phép khách hàng tạo lại mã.

​
Xử Lý Sự Cố

Kiểm Tra:
  1. Đơn vị tiền thanh toán đã đặt thành BRL?
  2. pix có được bao gồm trong allowed_payment_method_types?
  3. Quốc gia thanh toán của khách hàng là Brazil?
Giải Pháp: Pix chỉ có sẵn cho các giao dịch bằng BRL. Kiểm tra lại đơn vị tiền và địa chỉ thanh toán trong yêu cầu API của bạn.
Nguyên Nhân: Khách hàng không hoàn tất thanh toán trong thời gian hết hạn.Giải Pháp: Khách hàng cần khởi động lại quá trình thanh toán để tạo mã QR mới.
Nguyên Nhân: Thanh toán bằng Pix thường được xác nhận ngay lập tức trong hầu hết các trường hợp, nhưng có thể xảy ra chậm trễ từ phía ngân hàng.Giải Pháp: Giám sát webhook để xác nhận thanh toán. Nếu thanh toán không được xác nhận trong vài phút, coi là thất bại.

​
Các Trang Liên Quan

Payment Methods Overview

Xem tất cả các phương thức thanh toán được hỗ trợ.

Adaptive Currency

Hỗ trợ đơn vị tiền tệ và chuyển đổi tự động.

Checkout Guide

Hướng dẫn triển khai quy trình thanh toán hoàn chỉnh.

Webhooks

Xử lý xác nhận thanh toán không đồng bộ.
Last modified on April 8, 2026