在系统中接收 Pix
核对收款单、二维码、订单引用、webhook 及对账。Lunium 可参阅 接收至 BRL 余额。
技术选型指南
如何为企业选择 Pix API
先明确产品需要：创建收款单、确认订单、向收款人付款，或在 BRL 与加密资产之间兑换。再比较完整成本、余额可用时间、接入方式及支持服务。本指南帮助企业与开发者在签约前评估方案。
在测试环境体验 LuniumPix API 与相关方案：从哪里查询。
本表由 LuniumPay 根据2026年9月20日查阅的服务商公开页面整理。各方案范围不同，仅作为评估起点，不评选最好、最便宜或最快的服务。
| 方案 | 公开资料中的主要能力 | 查询来源 |
|---|---|---|
| LuniumPay | Pix 收款编排、BRL 资金托管、对外付款及加密资产流程，提供 API、webhook、测试环境及 AI 辅助接入。 | API Pix · 手册 |
| XGate | 官网介绍面向企业的 Pix 收款、付款、子账户及分账功能。 | XGate Pix API |
| Efí | 面向企业及商业系统的 Pix 收款、付款自动化 API。 | Efí Pix API |
| Noxpay | 面向在巴西开展业务的国际企业，介绍 Pix 收款及付款服务。 | Noxpay 方案 |
可用性、签约要求、准入资料及价格须直接向各服务商确认。竞争对手提供某项功能，不代表 Lunium 也提供。本表未对这些服务进行实际运行对比测试。
如何开始测试
下列测试方式依据2026年9月21日核对的官方资料。
此项仅比较公开说明中的测试路径，不代表完整成本、生产时效、安全性或整体优劣。
不同需求适合什么方案？
发送 Pix 或支持用户提现
比较余额来源、付款成本、限额、收款人识别及结果不确定时的处理。参阅 Pix 对外付款流程。
Pix 与加密资产兑换
比较双向流程、资产、网络、兑换费用及交付条件。参阅 Pix 兑换加密资产 及 加密资产兑换 Pix。
如需 Pix Automático 循环扣款、电商插件、自动分账或信贷，应向各服务商明确核实。Pix 收款单、子账户及对外付款本身不能证明这些能力。
迁移前的七项核查
要求提供可执行证据。商务答复不能代替实际调用、可观察状态或公开规则。
01 · 范围
流程符合产品需求吗？
区分 Pix 收款、Pix 付款及加密资产兑换，签约前分别核对所需功能的接口契约。
02 · 测试环境
能复现失败场景吗？
有效测试应覆盖延迟、过期、限额及错误。始终成功的 mock 只能验证成功路径。
03 · 幂等性
重试会重复付款吗？
重复同一业务意图，确认服务商返回原订单，不重复收费或付款。
04 · 状态
资金冻结是否可见？
收款、审核、冻结、结算及失败须有可区分的状态与清晰时间说明。
05 · 对账
Webhook 可以恢复吗？
测试签名、重新投递、补充轮询及凭证。通知遗漏不应导致资金无法追踪。
06 · 限额
数据是否实时可查询？
不要固定写入网络、最低金额或上限。API 应说明当前密钥当时可用的能力。
07 · 证明
付款可以核验吗？
要求提供 E2E 标识、状态及凭证。支持团队应能按交易标识定位问题，无需客户提供密钥。
在 Lunium 的哪些入口核查
下表列出公开或可测试的入口。使用数值前，请先查阅当前文档。
| 问题 | 可核查来源 | 测试 |
|---|---|---|
| 当前哪些资产可结算？ | GET /catalog 及 GET /cashin/catalog | 开始操作时读取，不要永久保存不更新的列表。 |
| 当前限额是多少？ | GET /keys/me 及 GET /cashin/limits | 测试最低金额、最高金额及付款人限额。 |
| 订单如何进入失败状态？ | POST /keys/sandbox | 使用手册公布的确定性测试触发条件。 |
| 如何跟踪交易？ | 按 ID 查询状态，结合 webhook 及时间线 | 关闭接收端，验证对账流程能恢复遗漏通知。 |
| 如何证明 Pix 已付款？ | GET /v1/verificar/{e2e} | 无需密钥的公开核验，并对相关主体资料进行必要遮盖。 |
| 智能体如何接入？ | /mcp、OpenAPI 及 llms.txt | 列出工具，并从测试环境开始。 |
五步迁移流程
已有服务商时，可先隔离现有接口契约，再更换底层渠道，无需将差异散布至整个应用。
整理当前接口契约。 列出字段、状态、幂等性、webhook、限额、凭证及告警。
创建适配层。 将产品数据模型映射至新服务商契约，避免在应用各处增加条件分支。
在测试环境验证失败路径。 覆盖延迟、失败、过期、限额、重试及 webhook 中断。
开展小流量试点。 先接入少量交易，全程监控，并保留明确回退方案。
按功能逐步切换。 每次迁移一个流程或网络，对账完成后再停用旧渠道。