为何提供 Pix？
Dominant in Brazil
Pix 是巴西使用最广泛的支付方式，领先于信用卡和 boleto。巴西中央银行报告称，Pix 在 2025 年下半年处理了所有支付交易的 54.7%。
Instant Settlement
Pix 转账可在几秒内完成，全年任何时间、任何日期均可使用，因此无需等待银行处理时间窗口。
Low Friction
客户在其银行应用中扫描二维码或粘贴 Pix 代码。无需输入卡号或银行信息。
概述
最低金额为 BRL 结账的最低金额，因此适用于 BRL 结账中的所有支付方式。工作原理
客户体验
- 客户在结账时选择 Pix，并在 Pix CPF 字段中输入其 CPF（11 位巴西纳税人识别号）。
- 客户确认付款。二维码会在全屏覆盖层中打开，二维码下方显示 Pix 代码和 复制代码 按钮。
- 客户打开其银行应用，选择 Pix，然后扫描二维码或粘贴 Pix 代码。
- 付款会在几秒内确认。
- 结账检测到付款完成后，会将客户重定向到你的成功页面。
Pix QR 码会在一段时间后过期。如果客户未能及时付款，他们需要从你的网站重新开始结账流程。
配置
API 方法类型
测试
1
Enable Test Mode
关闭控制台侧边栏中的 Live Mode 开关，并使用在测试模式下创建的 API 密钥。
2
Set Billing Currency to BRL
启用 Adaptive Currency。然后，在
allowed_payment_method_types 中使用 billing_currency: 'BRL' 和 pix 创建结账会话。3
Enter Test CPF and Scan the QR Code
在 Pix CPF 字段中输入
00000000000（11 个零）。结账页面会显示一个测试二维码。使用手机摄像头扫描它；无需使用 Pix 或银行应用。二维码会打开一个测试页面，你可以在其中模拟成功或失败的付款。最佳实践
Set billing currency to BRL
Set billing currency to BRL
Pix 仅适用于以 BRL 计费的结账，而 Dodo Payments 仅在启用 Adaptive Currency 时以 BRL 计费。启用 Adaptive Currency，以便向巴西客户以 BRL 报价和计费。
Provide card fallbacks
Provide card fallbacks
部分巴西客户更喜欢使用银行卡付款。将
credit 和 debit 作为备用支付方式。Handle QR code expiration
Handle QR code expiration
Pix QR 码会在一段时间后过期。如果客户在二维码过期后返回，请为他们创建新的 checkout session。
故障排除
Pix not appearing at checkout
Pix not appearing at checkout
检查：
- 计费货币是否为
BRL？ pix是否包含在allowed_payment_method_types中？- 客户的计费国家/地区是否为巴西（
BR）？启用 Adaptive Currency 后，巴西账单地址会将计费货币设置为 BRL。 - 是否已启用 Adaptive Currency？
- 金额是否达到 0.50 BRL 的最低要求？
QR code expired
QR code expired
**原因：**客户未在过期时间窗口内完成付款。**解决方案：**客户需要从你的网站重新开始结账流程。要向他们发送新的支付链接，请创建新的 checkout session。
Payment pending
Payment pending
**原因：**大多数 Pix 付款会在几秒内确认，但银行偶尔可能会延迟转账。**解决方案：**使用
payment.succeeded 和 payment.failed webhooks 获取最终付款状态，而不要依赖返回重定向。如果付款在几分钟内未确认，请将其视为失败。相关页面
Payment Methods Overview
查看所有支持的支付方式。
Adaptive Currency
以客户的本地货币（包括 BRL）向其计费。
Checkout Guide
完整的结账实现指南。
Webhooks
异步处理付款确认。
Testing Process
测试数据和结账测试指南。