通过 API 创建 Pix 收款单
每个订单创建一张收款单,展示二维码及 Copia e Cola,并将收款关联至系统中的客户。结算金额按账户费用及规则记入 BRL 托管余额。
查看收款与资金托管 →面向企业与开发者的 Pix API
创建带二维码及 Pix Copia e Cola 的收款单,通过 webhook 跟踪付款,并使用可用余额自动发送 Pix。将支付编排 API 接入您的网站、应用或平台。
每个订单创建一张收款单,展示二维码及 Copia e Cola,并将收款关联至系统中的客户。结算金额按账户费用及规则记入 BRL 托管余额。
查看收款与资金托管 →根据签名通知更新订单,并通过 API 查询状态,分别跟踪收款、结算及余额可用性。
查看确认与对账 →使用主账户或子账户的可用余额实现提现、付款及资金分发。查询费用,跟踪每笔付款至最终结果。
查看 Pix 付款 API →将收款单关联至客户及订单,付款确认后更新系统,并保存历史用于对账。
在自己的界面提供 Pix。后端创建收款单,客户使用银行应用支付生产环境二维码。
按客户引用标识隔离余额,并执行获授权的资金分发。商业规则及用户权限由您的系统管理。
接入通过后端 API 调用实现。如需要特定平台的现成插件,请在 接入咨询 中说明环境,并在签约前核对兼容性。
可使用 BRL 余额完成 Pix 收款与提现。加密资产兑换属于可选的额外出金方式。
选择 Pix API 前,请评估收款费用、付款成本、资金释放时间、单笔及付款人限额、支持服务与失败处理。单一费率无法反映完整业务成本。
账户费用及规则可通过 API 查询。讨论方案时,请提供产品类型、平均客单价、预计月交易量,以及需要收款、付款或两者兼有。
讨论交易量与接入 →测试环境可使用虚拟金额验证流程、过期、资金冻结、失败及 webhook。生产价格、流动性及可用性须以真实 API 响应为准。
了解可测试场景 →公开文档及 Node.js/Python 工具包可帮助开发者创建首张收款单并跟踪结果。编程智能体也可依据契约实现接入与场景测试。请选择适合产品的注册方式;使用 API 并不强制要求 Mesh。
建议加入 Lunium Partners ,并与 @luniumb2b、@luniumb2c 建立项目专属群组。群组可由 Lunium 或您的团队创建,用于跟进接入及具体运行问题。
不需要。托管流程将收款单结算为 BRL 余额,您可申请通过 Pix 提现。仅在主动选择时才涉及加密资产兑换;托管收款无需固定钱包。
创建收款单会返回 Copia e Cola 支付码,并在可用时提供二维码图片 URL。系统须展示返回的数据、金额及有效期。测试二维码为虚构数据,不得通过银行支付。
配置签名 webhook 接收端,并通过 API 查询状态。收款、结算及余额可用是不同阶段;允许提现或判断交付完成前,须核对对应状态。
Pix 对外付款使用主账户或子账户的可用 BRL 余额。创建前须核对当前密钥的功能开通情况、费用及实际限额。
本页介绍 Pix 收款单、资金托管、查询、webhook 及对外付款。不要假定支持 Pix Automático 循环扣款或向多名受益人自动分账。子账户与由您应用安排的资金分发属于不同功能,额外需求请与团队确认。
LuniumPay 提供支付编排及 API 接入层,资金环节按路由使用合作服务商。LuniumPay 的运营主体为 ZANQUETA INTERMED LTDA,CNPJ 68.538.127/0001-00。
取决于收款、付款、成本、限额及接入需求。决定前请比较文档并完成实际测试;我们的指南提供比较标准及不同服务商的公开资料来源。
比较 Pix API →