Pix

Cho phép khách hàng Brazil thanh toán từ ứng dụng ngân hàng bằng cách quét mã QR hoặc dán mã Pix. Pix là hệ thống thanh toán tức thì của Brazil, do Ngân hàng Trung ương Brazil (Banco Central do Brasil) thành lập. Hệ thống chuyển tiền theo thời gian thực, 24 giờ mỗi ngày, kể cả cuối tuần và ngày lễ. Dodo Payments cung cấp Pix cho các khoản thanh toán một lần và gói đăng ký được tính phí bằng BRL.

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. Ngân hàng Trung ương Brazil báo cáo rằng Pix chiếm 54,7% tổng số giao dịch thanh toán trong nửa cuối năm 2025.

Instant Settlement

Giao dịch Pix hoàn tất trong vài giây, vào bất kỳ giờ nào và bất kỳ ngày nào trong năm, vì vậy bạn không phải chờ thời gian xử lý của ngân hàng.

Low Friction

Khách hàng quét mã QR hoặc dán mã Pix trong ứng dụng ngân hàng của họ. Họ không cần nhập số thẻ hoặc thông tin ngân hàng.

Tổng Quan

Mức tối thiểu là mức tối thiểu của checkout đối với BRL, nên áp dụng cho mọi phương thức thanh toán trên checkout bằng BRL.

Chi tiết	Giá trị
Đơn vị tiền tệ thanh toán	BRL
Các quốc gia được hỗ trợ	Brazil
Gói đăng ký	Có
Số tiền tối thiểu	0.50 BRL
Quyết toán	Tức thì

Cách hoạt động

Trải nghiệm khách hàng

Khách hàng chọn Pix tại checkout và nhập CPF (mã số thuế gồm 11 chữ số của Brazil) vào trường Pix CPF.
Khách hàng xác nhận thanh toán. Mã QR mở trong lớp phủ toàn màn hình, bên dưới là mã Pix và nút Sao chép mã.
Khách hàng mở ứng dụng ngân hàng, chọn Pix rồi quét mã QR hoặc dán mã Pix.
Thanh toán được xác nhận trong vài giây.
Checkout phát hiện thanh toán đã hoàn tất và chuyển hướng khách hàng đến trang thành công của bạn.

Mã QR Pix sẽ hết hạn sau một khoảng thời gian nhất định. Nếu khách hàng không thanh toán kịp thời, họ cần bắt đầu một checkout mới từ trang web của bạn.

Cấu hình

// `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 xuất hiện trên checkout cho các khoản thanh toán một lần và gói đăng ký được tính phí bằng BRL. Dodo Payments chỉ tính phí bằng BRL khi Adaptive Currency được bật, vì vậy hãy bật tính năng này trước khi cung cấp Pix.

Loại phương thức API

Loại	Phương thức	Quốc gia
`pix`	Pix	Brazil

Kiểm thử

Enable Test Mode

Tắt công tắc Live Mode trong thanh bên của dashboard và sử dụng các API key được tạo ở chế độ kiểm thử.

Set Billing Currency to BRL

Bật Adaptive Currency. Sau đó tạo một phiên checkout với billing_currency: 'BRL' và pix trong allowed_payment_method_types.

Enter Test CPF and Scan the QR Code

Trong trường Pix CPF, nhập 00000000000 (11 số 0). Checkout hiển thị mã QR kiểm thử. Quét mã bằng camera điện thoại; bạn không cần ứng dụng Pix hoặc ứng dụng ngân hàng. Mã QR mở một trang kiểm thử, nơi bạn có thể mô phỏng thanh toán thành công hoặc thất bại.

Biện pháp tốt nhất

Set billing currency to BRL

Pix chỉ hoạt động trên checkout được tính phí bằng BRL, và Dodo Payments chỉ tính phí bằng BRL khi Adaptive Currency được bật. Bật Adaptive Currency để khách hàng ở Brazil được báo giá và tính phí bằng BRL.

Provide card fallbacks

Một số khách hàng Brazil thích thanh toán bằng thẻ. Bao gồm credit và debit làm phương thức thanh toán dự phòng.

Handle QR code expiration

Mã QR Pix sẽ hết hạn sau một khoảng thời gian nhất định. Nếu khách hàng quay lại sau khi mã hết hạn, hãy tạo một checkout session mới cho họ.

Khắc phục sự cố

Pix not appearing at checkout

Kiểm tra:

Đơn vị tiền tệ thanh toán có phải là BRL không?
pix có được bao gồm trong allowed_payment_method_types không?
Quốc gia thanh toán của khách hàng có phải là Brazil (BR) không? Khi Adaptive Currency được bật, địa chỉ thanh toán ở Brazil sẽ đặt đơn vị tiền tệ thanh toán là BRL.
Adaptive Currency đã được bật chưa?
Số tiền có đáp ứng mức tối thiểu 0.50 BRL không?

Giải pháp: Pix chỉ được cung cấp trên checkout bằng BRL. Kiểm tra đơn vị tiền tệ và địa chỉ thanh toán trong yêu cầu API của bạn.

QR code expired

Nguyên nhân: Khách hàng không hoàn tất thanh toán trong thời hạn hiệu lực.Giải pháp: Khách hàng cần bắt đầu một checkout mới từ trang web của bạn. Để gửi cho họ một payment link mới, hãy tạo một checkout session mới.

Payment pending

Nguyên nhân: Hầu hết thanh toán Pix được xác nhận trong vài giây, nhưng đôi khi ngân hàng có thể trì hoãn giao dịch chuyển tiền.Giải pháp: Sử dụng webhook payment.succeeded và payment.failed để lấy trạng thái thanh toán cuối cùng thay vì chuyển hướng quay lại. Nếu thanh toán không được xác nhận trong vài phút, hãy coi thanh toán đó là thất bại.

Trang liên quan

Payment Methods Overview

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

Adaptive Currency

Tính phí khách hàng bằng đơn vị tiền tệ địa phương của họ, bao gồm BRL.

Checkout Guide

Hướng dẫn đầy đủ về cách triển khai checkout.

Webhooks

Xử lý xác nhận thanh toán không đồng bộ.

Testing Process

Dữ liệu kiểm thử và hướng dẫn kiểm thử checkout.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Tại Sao Cung Cấp Pix?

Dominant in Brazil

Instant Settlement

Low Friction

Tổng Quan

Cách hoạt động

Trải nghiệm khách hàng

Cấu hình

Loại phương thức API

Kiểm thử

Biện pháp tốt nhất

Khắc phục sự cố

Trang liên quan

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

​Tại Sao Cung Cấp Pix?

Dominant in Brazil

Instant Settlement

Low Friction

​Tổng Quan

​Cách hoạt động

​Trải nghiệm khách hàng

​Cấu hình

​Loại phương thức API

​Kiểm thử

​Biện pháp tốt nhất

​Khắc phục sự cố

​Trang liên quan

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

Tại Sao Cung Cấp Pix?

Tổng Quan

Cách hoạt động

Trải nghiệm khách hàng

Cấu hình

Loại phương thức API

Kiểm thử

Biện pháp tốt nhất

Khắc phục sự cố

Trang liên quan