为中国企业及全球中文合作伙伴提供支付基础设施

为您的产品接入 Pix。
下一步，
由您选择。

接收 Pix 付款，并将 USDT 发送至指定钱包；也可使用加密资产支付 Pix，全程查看进度和凭证。您还可以保留 BRL 余额，将这些流程接入自己的软件。

创建账户并测试 查看文档
通过 Pix 收取 USDT 用加密资产支付 Pix

使用模拟资金测试 托管收款无需预先绑定固定钱包

想先聊聊？ 通过 WhatsApp 联系人工客服 ↗

LUNIUM产品流程示意
从收款到资金去向连接每一种可能。
PixBRL 余额USDTUSDC+ 查看资产目录
cash-in · ci_9f2e…
◎
已收到 Pix 付款
事件：cashin.paid
R$ 5,000.00
⇄
正在兑换
BRL → USDT
5.1047
结算
USDT → Polygon
0x8ef1…
✓
已完成
事件：cashin.settled · 链上交易已确认
979.49 USDT
流程仅供示意 · 通过 API 和 webhook 查询状态
每一步都有签名 webhook 通知。
您现在需要哪种服务？

下一笔支付，
两种选择。

了解流程，使用 AI 辅助准备接入，并从测试环境开始。正式交易前，请连接账户并核对交易条件。

收款

接收 Pix，收取 USDT

填写金额、付款人资料和目标钱包，生成二维码，跟踪 Pix 收款及指定网络上的 USDT 发送进度。

创建收款单前，可查看预计净到账金额、费用及可能适用的资金冻结。

准备收款 了解流程
付款

用加密资产支付 Pix

填写 Pix 收款标识及金额，或粘贴 Pix 支付码。核对报价，按说明发送加密资产，并跟踪至付款凭证可用。

支持的币种和网络以资产目录为准。Pix 支付码可在兼容路由中使用 USDT/USDC 支付。

准备付款 了解流程

可使用 Gemini、ChatGPT 或您的 AI 工具了解并准备接入。通过聊天执行支付，需要先连接已获您账户授权的工具。 查看连接方式。

产品

一次接入。
贯通各类资金流程。

通过同一个 API 连接收款、余额与付款。选择适合您产品的流程。

BRL 资金托管

接收 Pix。
决定资金去向。

将净收款保留为托管 BRL 余额，按客户管理资金，再决定何时付款或提现。

PixBRL 余额Pix 或加密资产

收款时无需固定钱包。提取加密资产时，再选择网络与地址。

了解资金托管 →
Cash-in

PIX → USDT / USDC

客户通过普通 Pix 付款。Lunium 识别付款后完成兑换，将稳定币直接结算至配置的地址。

PIX检测到付款兑换结算USDT / USDC

可用资产、网络、最低金额和预估值均可通过 API 资产目录查询。

了解 cash-in →
Cash-out

稳定币 → Pix

将 USDT 或 USDC 兑换为 Pix：先获取报价并确认交易，再充值稳定币，由 Lunium 完成 Pix 结算。

USDT / USDC报价接受报价充值确认PIX

支持多个网络，具体以 API 资产目录为准。

了解 cash-out →
对外付款

通过 API 发送 Pix 付款

通过 Lunium 的基础设施，直接从您的系统发送 Pix。使用 API 创建付款、跟踪状态并逐笔对账。

POST /payoutsprocessingsent

使用 BRL 直接向 Pix 收款标识付款，无需兑换加密资产。

了解对外付款 →
先收款，再决定资金用途。

收到 Pix 后，
下一步
由您决定。

收款可以保留为托管 BRL 余额。按客户管理余额，自主决定如何使用可用资金，无需在收款时指定加密资产钱包。

了解 BRL 资金托管

交易前，通过 API 查询币种、网络、费率和限额。

资金流入客户通过 Pix 付款
BRL 资金托管一个余额。
更多选择。
Pix付款与提现
加密资产选择资产和网络

流程示意 · 使用可用余额

Lunium Partners

同一个账户，从测试到生产。

创建账户，登录合作伙伴控制台并测试接入。准备就绪后，在同一账户中生成生产环境密钥。

1 · 测试环境

从测试环境开始

在控制台生成测试密钥，使用模拟资金验证 Pix、余额和 webhook。

创建账户并测试
开发者

立即开始接入。

开发者可直接从 API 开始，无需先预约商务会议。

01

创建测试密钥。

POST /keys/sandbox
02

获取报价。

POST /cashin/preview
03

创建 Pix 收款单。

POST /cashin/charge
04

接收结算资金。

cashin.settled

无需人工配置凭证。 无需等待他人为您创建首个密钥。

创建账户并测试 阅读文档
费率

合作伙伴专属费率，交易量越大越优惠。

标准接入费率：每笔 3.3% + R$ 1.00。高交易量合作伙伴可协商费率，独家合作伙伴相对 USDT 市场参考报价的费率最低可至 35 bps。无月费。当前密钥适用费率可查询 GET /keys/me ，每份报价均已体现净到账金额。

查看费率与限额 咨询交易量优惠费率
代码

一次接入，连接 Pix 与稳定币。

请求Node.js
const response = await fetch(
  "https://api.luniumpay.com/cashin/charge",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.LUNIUM_API_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      amount_cents: 25000,
      payer_tax_number: "12345678901",
      payout_address: "0x…",
      asset: "usdt",
      external_id: "order_8812"
    })
  }
);

const charge = await response.json();
响应200
{
  "cashin_id": "ci_b3f9d2a41c6e…",
  "status": "pending",
  "amount_cents": 25000,
  "chain": "polygon",
  "asset": "usdt",
  "qr_copypaste": "00020126…",
  "qr_image_url": "https://…",
  "external_id": "order_8812",
  "expires_at": "2026-…"
}

您的应用接收 Pix。 Lunium 完成后续流程。

软件接入

由您的团队开发。
也可使用您的 AI 工具。

从 ChatGPT 到 Fable，为您的 AI 提供 API 上下文和接入路径。您的团队也可以直接编写代码接入。

01

开发者接入

直接使用 REST API、OpenAPI 3.1、确定性测试环境和生产环境。现有接入方式保持兼容。

开始开发
02

AI 智能体接入

通过开放标准发现服务，读取机器可读的能力目录，由接入方定义支出策略，并按规则申请进入生产环境。

面向 AI 智能体的 Lunium

测试环境、OpenAPI 与 MCP。 根据授权和 API 要求，完成服务发现、开发、测试及生产环境接入。

操作

每个事件，
尽在掌握。

通过合作伙伴控制台和仅限本账户访问的监控页面跟踪运营。结合 webhook 与状态查询，将实时进度接入您的产品。

  • Cash-in、cash-out 与对外付款
  • 状态与结算
  • 实时运营事件
  • 无需暴露 API 密钥 ——监控页面使用独立、只读且可轮换的令牌
  • 请在后端确认 webhook 已收到并正确处理
了解监控功能 →
监控 · 范围：当前密钥 · 只读
cashin.paidR$ ••••.00处理中
cashin.settled•• USDT · polygon已结算 ✓
cashout.completedR$ ••••.00 · PIX已付款 ✓
payout.sentR$ •••.00已发送 ✓
webhook签名通知已送达2xx ✓
Lunium Partners

您专注开发。
我们随时协助。

加入官方社区，获取产品动态和运营通知，并与其他接入团队交流经验。

加入 Lunium Partners
真实的团队，与您的项目同行

您的专属接入群组。

建议由 Lunium 或您的团队创建项目专属群组，并添加人工支持账号 @luniumb2b 及 @luniumb2c。机器人和监控页面作为辅助支持。

通过 WhatsApp 联系人工客服系统接入 · 运营支持 · 商务咨询
适合您业务的解决方案

Pix 与稳定币，
融入您的业务流程。

从线上销售到供应商付款，找到适合您业务的 Lunium 应用方式。

进出口企业

将 BRL 资金与稳定币支付连接起来，向接受该结算方式的交易对手付款。

  • 自主选择兑换时机
  • 将资金转入巴西
  • 为财务管理提供业务依据
Pix 或加密资产全程跟踪兑换钱包收款或巴西 Pix 收款
了解解决方案

金融科技

为您的产品接入 Pix 收款、客户独立余额，以及 Pix 或加密资产付款。

  • 按客户管理
  • 提供多种付款方式
  • 展示交易进度
客户充值子账户余额授权提现
了解解决方案

SaaS

通过 Pix 收款，识别每位客户，并在付款确认后更新您的软件。

  • 每张收款单对应独立参考标识
  • 在您的系统中同步更新
  • BRL 收款
SaaS 账单Pix 收款单系统确认
了解解决方案

电子商务

将 Pix 接入结账流程，核对订单，并自主选择所收资金的去向。

  • 收款单关联订单
  • 集成付款确认
  • 自主安排资金去向
商店订单买家 Pix 付款对账与收款
了解解决方案
也适用于以下平台加密资产平台数字钱包交易平台B2B 平台

团队可以开发，AI 也可以辅助接入。 通过 API、测试环境和文档，将每种解决方案接入您的应用。

了解 AI 智能体与 MCP
深入了解技术细节

一个 API，
每个细节都可查阅。

探索资产目录、费率、状态、测试及故障恢复，帮助您的团队掌握完整运营流程。

01为生产环境设计
生产环境

为开发者构建。
为生产环境设计。

OpenAPI 3.1

机器可读的规范

与生产 API 同步，并对照验证。

Postman 与 Insomnia

几分钟即可导入并测试

导入 API 规范，随即开始测试。

Webhook

签名 webhook

通过加密签名验证每个事件的真实性。

幂等性

原生幂等支持

安全重试，避免重复创建金融交易。

错误处理

结构化错误

基于结构化错误实现可预测的处理逻辑，无需解析自然语言错误消息。

资产目录

动态资产目录

以编程方式查询可用资产和网络，无需在代码中写死。

对账

对账

请以 API 响应和结算标识为财务事实依据。

浏览文档 →
02币种、网络与资产目录
网络

Cash-out 支持客户熟悉的网络。

Lunium 资产目录实时提供 cash-out 可用的资产和网络，无需依赖过期的静态表格。

USDT USDC
Polygon Ethereum BNB Chain Arbitrum Optimism Base Avalanche Aptos NEAR 其他网络请查看资产目录——通过 GET /catalog 查询各资产当前可用网络
GET /catalog

可用性会变化。 您的接入无需猜测 ——以资产目录为准。

查看可用网络 →
03交易前查看报价与费用
报价

先核对报价，
再转入资金。

金融基础设施应明确返回最终金额，避免您的应用自行猜测。

创建 cash-in 之前
POST /cashin/preview

仅查询报价，不创建交易；报价已按当前密钥的费率计算。

对于 cash-out
POST /cash-outs

报价明确标注有效期。在您接受之前，不会执行交易。

API 返回交易实际采用的金额。
您的系统负责展示报价。 Lunium 提供交易的权威数据。

04每笔交易的状态
生命周期

每笔交易都有完整生命周期。

Cash-in
pendingpaidsettled ✓或expired

以下为 API 的实际状态：Pix 到账对应 paid；链上交付对应 settlement_status (pending → sending → sent），事件 cashin.settled 用于通知何时可以入账。

Cash-out
QUOTE_CREATEDAWAITING_DEPOSITDEPOSIT_DETECTEDcashout.processingCOMPLETED ✓

内部兑换状态统一通过事件 cashout.processing 通知，无需逐一处理内部状态。

您的应用通过 API 跟踪状态， 并通过 webhook 接收每次状态变更。

05幂等性与故障恢复
幂等性

重试不应导致重复付款。

金融 API 的故障，需要专门处理。

连接中断、服务器重启、响应超时，
都可能触发您的应用重试。

Lunium 的幂等机制确保相同的 external_id 安全地对应同一笔金融交易，也可在 恢复原交易 。

同一笔交易 同一个标识 避免重复交易
了解幂等机制 →
06Telegram 机器人与运营支持
人工运营支持

面向软件的 API。
面向团队的助手。

您的应用
api.luniumpay.com

通过 Lunium API，以编程方式创建交易、跟踪进度并对账。

您的团队
  • 咨询您的接入问题
  • 接收实时交易通知
  • 打开实时监控页面
  • 查询运营活动

API 服务软件。 助手服务团队。

在 Telegram 中打开机器人 →
07测试环境：成功与失败场景
测试环境

先测试故障，再迎接生产。

使用模拟余额测试 Pix 收款、BRL 资金托管、加密资产提现、Pix 付款和内部转账。测试环境复现接入状态，不会实际支付 Pix 或转移加密资产。对于 cash-out，以下场景可用于验证成功、延迟和失败处理。

交易成功成功路径，模拟执行
交易延迟触发条件 .01 ——先进入 delayed 状态，随后自动模拟付款成功
交易失败触发条件 .02 ——测试错误处理流程
报价过期触发条件 .03 ——验证系统会重新报价
限额错误触发条件 .04 ——返回完整的 limits 对象
幂等冲突重复使用 external_id，验证实际的 409 响应
Webhook 签名POST /webhooks/test 验证您的接收处理程序
POST /keys/sandbox

创建测试凭证 无需转移真实资金 ——一次请求即可。

进入测试环境
08通过 API 查询配置和历史记录
权威数据来源

API 的实际能力，以 API 本身为准。

销售演示和 PDF 仅供参考。 请以 API 为准。

GET /keys/me以机器可读方式查询账户配置、当前限额及适用资格。
GET /catalog当前可用的资产与网络。
GET /cashin/chargesCash-in 历史记录。
GET /cash-outsCash-out 历史记录。
GET /payouts对外付款历史记录。

您的系统 读取当前有效配置， 无需依赖假设。

09接入前需要确认什么
选择服务之前

先了解基础设施，再决定是否使用。

许多支付公司要求先联系销售，才能了解产品。Lunium 让您先查阅并测试。

  • 01阅读文档。
  • 02检查接口。
  • 03创建测试密钥。
  • 04了解交易生命周期。
  • 05测试您的接入。

之后再联系我们 ——咨询生产环境限额、商务条款或企业级支持。

文档

亲自验证。
查阅 API。

OpenAPI 中列明的接口
OpenAPI 3.1
请求与响应的数据结构
cURL 示例
Node.js 示例
Python 示例
签名 webhook 说明
错误响应规范
测试环境场景
更新日志
生产环境状态
阅读文档 打开 OpenAPI

您的下一款产品，
从一个密钥开始。

从测试环境开始，验证流程，再将接入部署到生产环境。

Pix · BRL 资金托管 · 加密资产 · 对外付款

创建账户并测试 ↗ 阅读文档 WhatsApp 人工客服

Pix 接入方案与指南

选择适合您产品的流程，或访问 接入中心。

企业 Pix API在您的系统中接入收款单、二维码、付款确认和付款。如何选择 Pix API比较服务商、成本、测试能力和运营监控。支持资金托管的 Pix API以 BRL 收款，无需固定钱包；按客户划分余额，支持 Pix 或加密资产提现。支付测试环境使用模拟余额，测试完整流程、故障和 webhook。Pix 兑换 USDT API以 BRL 收款，将 USDT 交付至客户钱包。USDT 兑换 Pix API卖出稳定币，向 Pix 收款标识付款。Pix 对外付款 API通过 API，以 BRL 向供应商和用户付款。通过 API 兑换 BRL ↔ USDT支持双向兑换，并提供报价与交易凭证。巴西法币与加密资产的双向兑换一次接入，支持巴西境内的法币与加密资产兑换。客户用 Pix 付款，商户以稳定币收款接收客户的 Pix 付款，将资金兑换为数字美元。面向钱包的 Pix 与稳定币服务为您的用户接入法币与加密资产的双向兑换通道。使用您的品牌的支付基础设施在您的产品背后运行完整资金流程。
常见问题

首次调用 API 前，您可能想了解的问题。

简明、可核对的解答。完整说明请查看 常见问题 和 文档。

如何接收 Pix 并以 USDT 结算？

您的应用调用 POST /cashin/charge，获取 Pix 二维码及支付码并展示给付款人。Pix 完成结算后，资金以 USDT 或 USDC 入账。可通过 GET /cashin/{id}/status 或签名 webhook 跟踪状态。

如何接收稳定币并以 Pix 付款？

这是反向流程（cash-out）：POST /cash-outs/preview 获取报价；POST /cash-outs 创建订单；POST /cash-outs/{id}/accept 返回充值地址。USDT 或 USDC 充值确认后，系统向指定 Pix 收款标识付款。

测试 API 是否需要注册？

您可创建控制台账户，统一管理测试和生产环境密钥。也可直接通过 API 调用 POST /keys/sandbox，填写电子邮箱，一次请求即可获得测试密钥，无需控制台账户。AI 智能体可继续使用 Mesh 或 MCP。测试环境模拟 Pix 转入 BRL 托管余额或加密资产、Pix 和加密资产提现、内部转账及加密资产兑换 Pix，包含状态、故障和 webhook。余额为模拟资金，二维码不可用于真实付款；真实交易须使用生产环境。邮箱为必填项，用于接收手册、流程图和接入步骤。

支持哪些币种与网络？

Pix 收款后接收加密资产，请查询 GET /cashin/catalog；充值加密资产后接收 Pix，请查询 GET /catalog。USDT、USDC 及其他资产的支持情况取决于流程、网络及当前可用性。两个方向使用不同的资产目录，请先确认路由再向客户提供支付选项。

API 可以向哪些 Pix 收款标识付款？

支持 CPF、CNPJ、手机号、电子邮箱或随机 Pix 收款标识。API 会验证格式。收款人辅助查询可能暂时不可用，请核对返回结果及收款人资料。

没有账户也能核验付款吗？

可以。GET /v1/verificar/{e2e} 是公开接口。凭 Pix 端到端标识（E2E），任何人都可查询该笔付款是否已结算，无需 API 密钥。

费用如何计算？

无月费，按交易收费。通过 GET /keys/me 可查询当前密钥适用费率，报价中已显示净到账金额。详情见 luniumpay.com/faq。

谁运营 Lunium？

运营方为 ZANQUETA INTERMED LTDA，CNPJ 68.538.127/0001-00，总部位于巴西圣保罗州Americana 市。联系邮箱：contato@luniumpay.com。

联系我们的团队

测试密钥只需一次调用，无需预先审批。如需开始测试，请前往 文档。本表单适用于按量协商费率、文档未覆盖的业务场景，或接入前的疑问。

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