即时转账关键数据
Pix 的全国规模
数据由巴西中央银行发布。
79.8 十亿
Pix 交易笔数 (2025)
来源：Banco Central do Brasil, Relatório de Gestão do Pix 2023-2025
BRL 35.3 万亿
Pix 交易金额 (2025)
来源：Banco Central do Brasil, Relatório de Gestão do Pix 2023-2025
920 百万
已注册的 Pix 密钥 (超过, 2025年12月)
来源：Banco Central do Brasil, Relatório de Gestão do Pix 2023-2025
43%
Pix 交易中个人对企业的占比 (占交易笔数百分比, 2025)
来源：Banco Central do Brasil, Relatório de Gestão do Pix 2023-2025
简介
巴西的即时支付通道
Pix 是巴西中央银行推出的即时支付系统。付款人在银行 App 中确认后，资金可在数秒内完成账户间转移，不受时间限制。在 Localpayment，您可以三种方式使用它：作为收款方式、作为由 Pix 密钥标识的虚拟账户，以及作为付款通道。
- 通过二维码或 Copia e Cola 收款，webhook 确认
- 带 Pix 密钥（邮箱、手机号或随机密钥）的虚拟账户，也可接收 TED
- 全天候实时 Pix 付款，另有当日或 T+1 到账的 TED 转账
Escaneie o QR · expira em 29:59
工作原理
Pix 支付流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
付款人您的企业:
选择 Pix
在您的收银台或通过支付链接。
- 2
您的企业Localpayment:
创建收款订单
调用 POST /api/payin/，传入国家、币种、金额和付款人信息。响应包含 Pix 二维码图片和 Copia e Cola 代码，并附有效期。状态 100（INPROGRESS）。
- 3
付款人银行 · Pix:
在银行或钱包 App 中确认
付款人在银行 App 中扫描二维码或粘贴代码并确认付款。
- 4
Localpayment您的企业:
通过 webhook 返回最终状态
Localpayment 收到确认并更新交易状态。使用 HMAC-SHA256 签名（x-Signature）。状态 200 表示已完成，请按 externalId 去重。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
Pix 付款流程
参与方和步骤遵循文档中的流程。最终状态始终通过签名 webhook 送达。
- 1
您的企业Localpayment:
发起付款请求
调用 POST /api/payout/，传入收款人信息、金额和 externalId。执行合规检查；启用 requireAuth 时，需第二位审批人签批后才会划转资金。
- 2
Localpayment银行 · Pix:
锁定资金并发送指令
付款经 Pix 从 Locked 变为 In Progress。
- 3
银行 · Pix收款人:
入账至收款人
时效取决于支付通道，详见下方关键信息。
- 4
Localpayment您的企业:
Webhook：付款已完成
Localpayment 将付款更新为最终状态。签名 webhook 返回最终状态，并可下载付款凭证。
示意图已简化。时效取决于支付通道和银行，详见下方关键信息。
工作原理
Pix 实际体验
简化的虚构演示，名称和金额仅为示例。
- 1Pix向付款人显示二维码（或可复制的代码）。
- 2Banco Ejemplo付款人核对 BRL 249.90 并在银行或钱包 App 中确认。
- 3付款成功您的系统收到签名 webhook 并放行订单。
关键信息
Pix：关键信息
国家
- 详情
- 🇧🇷 巴西
币种
- 详情
- BRL
方向
- 详情
- 收款与付款
收款 · Pix（二维码及 Copia e Cola）
- 详情
- 实时到账，通过 webhook 确认 · BRL 0.01 – 1,000,000
收款 · 虚拟账户（Pix or TED）
- 详情
- 实时到账，通过 webhook 确认 · BRL 0.01 – 2,000,000
付款 · Pix
- 详情
- 实时，7×24 小时 · 最低 BRL 0.06，无上限
付款 · 银行转账（TED）
- 详情
- 当日或 T+1，截止时间 17:00（巴西利亚时间）
付款结算
- 详情
- 实时，7×24 小时，含周末和节假日
摘自 Localpayment 各国文档。限额和可用性可能变化，请与您的客户经理确认。
用户体验
客户使用 Pix 时的体验
授权方式、限额和退款均依据 docs.localpayment.com；仅在文档明确说明时才显示限额。
客户如何授权
客户使用银行或钱包 App 扫描二维码，或将 Copia e Cola 代码粘贴到 App 的“使用 Pix 代码付款”栏，核对金额后确认。响应包含有效期；请显示倒计时，过期后重新创建收款。
文档中的限额
Pix（二维码及 Copia e Cola） (收款): BRL 0.01 – 1,000,000 · 虚拟账户（Pix or TED） (收款): BRL 0.01 – 2,000,000 · Pix (付款): 最低 BRL 0.06，无上限. 按单笔计，依据已发布文档；合同限额可能不同。
退款与退回
已完成的收款可通过 PATCH /api/payin/{externalId}/refund 退款。仅支持全额退款；资金退回付款人的银行账户，交易以状态 902（REFUNDED）结束。付款仍在待处理时可改为取消。
集成清单
五步上线 Pix
所有通道流程一致。开发前先观看该国的动画结账演示。
获取 Stage 凭证
申请接入，获取沙盒凭证，并通过 POST /api/token/ 获取 JWT。
创建收款
调用 POST /api/payin/，传入关键信息表中的 Localpayment 代码、ISO-3 国家、币种、金额和付款人信息。
展示支付指引
根据响应展示二维码、代码、跳转或账户信息，并遵守有效期。
校验 webhook
验证 x-Signature（HMAC-SHA256），在状态 200 时放行订单，并按 externalId 去重。
观看动画结账演示
在结账体验画廊中逐屏查看该国的每种支付方式。
发展历程
Pix 如何成为默认支付方式
来源：巴西中央银行，《Pix 管理报告 2023–2025》。
正式上线
巴西中央银行在其 SPI 基础设施上推出 Pix：任意账户之间的即时转账，全天候运行，通过密钥寻址。
取现与商户功能
Pix Saque 和 Pix Troco 支持在商户取现；动态二维码和 Copia e Cola 使 Pix 成为结账支付方式。
Pix Automático
定期扣款于 2025 年 6 月 16 日上线，同期推出 Pix Agendado、非接触式 Pix 和 Open Finance 支付发起。
接近 800 亿笔交易
Pix 全年处理 798 亿笔交易，其中 43% 为个人对企业，注册密钥超过 9.2 亿个。
为什么选择 Localpayment
为什么通过 Localpayment 使用 Pix
一个 API 处理收款与付款
Pix 与其他所有支付方式使用同一个 API：POST /api/payin/ 收款，POST /api/payout/ 付款，新增市场只需配置。
每笔交易均通过 webhook 推送状态
每次状态变更都会推送至您的接口并使用 HMAC-SHA256 签名，便于校验和自动化。
在 Business Portal 中对账
通过您的 externalId 和我们的 internalId 对账每笔交易，并提供 Business Portal 报表和余额 API。
常见问题
Pix 常见问题
Pix 付款多久确认？
Pix 是实时通道，可在数秒内确认，全天候运行。收款的最终状态会通过签名 webhook 通知您，请以该通知驱动订单流程。
限额是多少？
文档中的收款范围为每笔 BRL 0.01 至 1,000,000。Pix 付款起始金额为 BRL 0.06，文档未规定上限。请参阅上方关键信息表，并与客户经理确认您的限额。
可以同时通过 Pix 和 TED 付款吗？
可以。Pix 付款为实时、全天候；TED 可用于当日或 T+1 到账的转账，截止时间为巴西利亚时间 17:00。
虚拟账户可以使用哪类 Pix 密钥？
Localpayment 在巴西的虚拟账户在创建时会返回一个 Pix 密钥（邮箱、手机号或随机密钥）以及银行、支行和账号信息。付款人可向密钥发起 Pix，或向账户信息发起 Pix 或 TED：两种通道都会入账同一账户并触发相同的 webhook。
可以部分退款 Pix 付款吗？
不可以。通过 Localpayment 的 Pix 退款仅支持全额，对已完成交易调用 PATCH /api/payin/{externalId}/refund。资金退回付款人，收款以状态 902（REFUNDED）结束。
Pix 有拒付吗？
Pix 是付款人在自己银行 App 中授权的推送式支付，不存在银行卡式的拒付。争议通过您发起的退款处理。
二维码会过期吗？
会。每个收款响应都包含 qr.expirationDate。请在结账页显示倒计时，过期后创建新的收款而不是复用旧代码。