为何提供 Pix？
Dominant in Brazil
Pix 是巴西使用最多的付款方式，超越了信用卡和 boleto。
Instant Settlement
付款可在几秒钟内确认，24/7/365 — 无需等待银行处理时间。
Low Friction
客户通过二维码或复制粘贴密钥支付 — 无需卡号或银行详情。
概述
工作原理
客户体验
- 客户在结账时选择 Pix
- 显示二维码和复制粘贴密钥
- 客户打开其银行应用扫描二维码或粘贴密钥
- 付款立即确认
- 客户被重定向到成功页面
Pix 二维码通常在设定时间后过期。如果客户未能及时完成付款，他们需要重新开始结账。
配置
API 方法类型
测试
1
Enable test mode
使用您的 Dodo Payments 测试 API 密钥。
2
Set billing currency to BRL
确保计费货币在您结账请求中设置为
BRL。3
Enter test CPF and scan the QR code
当提示输入 Pix CPF 时，输入
1234567890。将生成一个测试二维码—用普通的手机摄像头扫描（无需 Pix 应用）。您将被重定向至 Stripe 测试页面，在那里您可以模拟交易成功或失败。最佳实践
Set billing currency to BRL
Set billing currency to BRL
Pix 仅适用于 BRL。确保您的定价支持针对巴西市场的巴西雷亚尔交易。
Provide card fallbacks
Provide card fallbacks
并非所有巴西客户可能更喜欢 Pix。始终包括
credit 和 debit 作为备用选项。Handle QR code expiration
Handle QR code expiration
Pix 二维码在设定的时间后过期。确保您的结账流程妥善处理过期情况，并允许客户重新生成代码。
故障排除
Pix not appearing at checkout
Pix not appearing at checkout
检查：
- 计费货币设置为
BRL？ pix包含在allowed_payment_method_types？- 客户计费国家是巴西？
QR code expired
QR code expired
原因： 客户未在过期窗口内完成付款。解决方案： 客户需要重新开始结账以生成新的二维码。
Payment pending
Payment pending
原因： Pix 付款在大多数情况下会立即确认，但偶尔可能会出现银行方面的延迟。解决方案： 监控支付确认的 webhook。如果付款在几分钟内未确认，则视为失败。
相关页面
Payment Methods Overview
查看所有支持的付款方式。
Adaptive Currency
货币支持和自动转换。
Checkout Guide
完整的结账实施指南。
Webhooks
异步处理付款确认。