为何提供 Pix？
Dominant in Brazil
Instant Settlement
Low Friction
概述
BRL 的最低金额是结账页的最低金额，因此适用于 BRL 结账页上的每种支付方式。一次性付款的 BRL 支付金额还必须至少等值于 $0.50，订阅支付则必须至少等值于 $1.00。请参阅最低金额。工作原理
客户体验
- 客户在结账时选择 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 的最低金额和 USD 最低金额？
QR code expired
QR code expired
**原因：**客户未在过期时间窗口内完成付款。**解决方案：**客户需要从你的网站重新开始结账流程。要向他们发送新的支付链接，请创建新的 checkout session。
Payment pending
Payment pending
**原因：**大多数 Pix 付款会在几秒内确认，但银行偶尔可能会延迟转账。**解决方案：**使用
payment.succeeded 和 payment.failed webhooks 获取最终付款状态，而不要依赖返回重定向。如果付款在几分钟内未确认，请将其视为失败。