面向企业与开发者的 Pix API

在您的系统中
接收与发送 Pix。

创建带二维码及 Pix Copia e Cola 的收款单,通过 webhook 跟踪付款,并使用可用余额自动发送 Pix。将支付编排 API 接入您的网站、应用或平台。

无需登记加密资产钱包即可接收 BRL。测试环境使用虚拟金额,可由您的团队或借助 AI 接入。

您希望自动处理 Pix 的哪一部分?

01 / 收款

通过 API 创建 Pix 收款单

每个订单创建一张收款单,展示二维码及 Copia e Cola,并将收款关联至系统中的客户。结算金额按账户费用及规则记入 BRL 托管余额。

查看收款与资金托管 →
02 / 跟踪

通过 webhook 确认

根据签名通知更新订单,并通过 API 查询状态,分别跟踪收款、结算及余额可用性。

查看确认与对账 →
03 / 付款

Pix 发送与对外付款

使用主账户或子账户的可用余额实现提现、付款及资金分发。查询费用,跟踪每笔付款至最终结果。

查看 Pix 付款 API →

将 Pix 融入您正在构建的产品。

SaaS 与管理系统

将收款单关联至客户及订单,付款确认后更新系统,并保存历史用于对账。

网站与应用

在自己的界面提供 Pix。后端创建收款单,客户使用银行应用支付生产环境二维码。

平台与 marketplace

按客户引用标识隔离余额,并执行获授权的资金分发。商业规则及用户权限由您的系统管理。

接入通过后端 API 调用实现。如需要特定平台的现成插件,请在 接入咨询 中说明环境,并在签约前核对兼容性。

从创建收款单到系统确认。

  1. 您的系统创建订单。 持久化保存交易引用,提交金额、付款人身份资料及托管目的地。
  2. 客户取得 Pix 收款单。 展示返回的二维码、Copia e Cola、金额及有效期。创建收款单不代表已经收到付款。
  3. 跟踪事件。 验证 webhook 签名,并查询交易状态,以恢复遗漏或乱序通知。
  4. 核对后进入下一阶段。 提现或资金分发前,核对结算及可用余额。已收到款项仍可能受冻结规则影响。

可使用 BRL 余额完成 Pix 收款与提现。加密资产兑换属于可选的额外出金方式。

比较完整成本与余额可用时间。

选择 Pix API 前,请评估收款费用、付款成本、资金释放时间、单笔及付款人限额、支持服务与失败处理。单一费率无法反映完整业务成本。

您的业务适用条件

账户费用及规则可通过 API 查询。讨论方案时,请提供产品类型、平均客单价、预计月交易量,以及需要收款、付款或两者兼有。

讨论交易量与接入 →

先测试,再使用真实资金

测试环境可使用虚拟金额验证流程、过期、资金冻结、失败及 webhook。生产价格、流动性及可用性须以真实 API 响应为准。

了解可测试场景 →

查看 Pix API 与服务商比较指南。

让团队开始接入,也可交给您的 AI。

公开文档及 Node.js/Python 工具包可帮助开发者创建首张收款单并跟踪结果。编程智能体也可依据契约实现接入与场景测试。请选择适合产品的注册方式;使用 API 并不强制要求 Mesh。

建议加入 Lunium Partners ,并与 @luniumb2b、@luniumb2c 建立项目专属群组。群组可由 Lunium 或您的团队创建,用于跟进接入及具体运行问题。

Pix API 常见问题。

接收 Pix 必须使用加密货币吗?

不需要。托管流程将收款单结算为 BRL 余额,您可申请通过 Pix 提现。仅在主动选择时才涉及加密资产兑换;托管收款无需固定钱包。

API 会生成二维码及 Pix Copia e Cola 吗?

创建收款单会返回 Copia e Cola 支付码,并在可用时提供二维码图片 URL。系统须展示返回的数据、金额及有效期。测试二维码为虚构数据,不得通过银行支付。

网站如何知道 Pix 已付款?

配置签名 webhook 接收端,并通过 API 查询状态。收款、结算及余额可用是不同阶段;允许提现或判断交付完成前,须核对对应状态。

可以向客户及供应商发送 Pix 吗?

Pix 对外付款使用主账户或子账户的可用 BRL 余额。创建前须核对当前密钥的功能开通情况、费用及实际限额。

包含 Pix Automático 及自动分账吗?

本页介绍 Pix 收款单、资金托管、查询、webhook 及对外付款。不要假定支持 Pix Automático 循环扣款或向多名受益人自动分账。子账户与由您应用安排的资金分发属于不同功能,额外需求请与团队确认。

Lunium 是处理 Pix 的银行吗?

LuniumPay 提供支付编排及 API 接入层,资金环节按路由使用合作服务商。LuniumPay 的运营主体为 ZANQUETA INTERMED LTDA,CNPJ 68.538.127/0001-00。

哪种 Pix API 最适合我的项目?

取决于收款、付款、成本、限额及接入需求。决定前请比较文档并完成实际测试;我们的指南提供比较标准及不同服务商的公开资料来源。

比较 Pix API →

将您的 Pix 业务接入 LuniumPay。

可先尝试收款演示,或介绍企业的接入需求。填写表单前,也可先体验测试环境。

一起明确企业需要的 Pix 方案。

请说明需要收款、付款或两者兼有,附上系统类型、预计交易量及主要疑问。团队将通过您提供的邮箱回复。

希望直接发邮件? contato@luniumpay.com