面向平台与钱包应用 · Pix → 加密资产
接收 Pix，将 USDT 交付至您的钱包
客户通过银行以 BRL 付款，您可跟踪 Pix 收款，以及 USDT 通过可用网络向指定钱包的交付。Lunium 提供 API 及智能体工具，请先了解流程并准备接入。
如何与您的 AI 开始接入
可使用 Gemini、ChatGPT 或其他 AI，了解流程并准备接入。
查询预计收到的数量
填写 BRL 金额、付款人证件及符合所选网络的钱包，查询预估净额、费用、最低金额及可能的冻结条件。
生成并分享二维码
收款单返回二维码、Pix Copia e Cola 支付码及到期时间。付款人使用银行应用付款。
跟踪直至交付
分别跟踪 Pix 收款及加密资产发送。交易链接和网络确认信息会在取得后展示。
可交给 AI 的需求示例
我想通过 Lunium 接收 R$ 100 的 Pix 付款，并将 USDT 交付到我的钱包。请核对币种、网络、费用及最低金额，说明如何连接账户并生成二维码，并在工具可用时跟踪各阶段。
兑换前的 USDT 数量仅为预估，时效取决于适用冻结条件、处理流程及网络。
聊天中执行真实交易，需要已连接到您账户的智能体。Lunium 公共连接器提供演示，目前尚不支持在 ChatGPT 中通过 OAuth 连接生产账户。不要在聊天中粘贴生产密钥。
如何接入 Pix 兑换稳定币
适用于每笔付款后交付加密资产的产品，例如钱包入金、用户购买资产，以及以加密资产结算的商户收款。付款人在银行使用 Pix，您的后端选择币种、网络及目标钱包。
查询接口
读取 GET /cashin/catalog，选择可交付的币种 / 网络组合，再查询 POST /cashin/preview ，预估接收数量及最低 BRL 金额。
创建收款单
发送 POST /cashin/charge 并传入 destino: "cripto"、以分计的金额、付款人证件及所选网络的钱包地址。
核对交付
展示返回的二维码及有效期。通过状态查询或 webhook 分别跟踪 Pix 付款与加密资产交付。
若希望先接收 BRL，之后再决定提现用途，请使用 Pix 充值至 BRL 托管余额。此流程创建收款单时无需钱包，仅在提现时兑换。
Pix 兑换 USDT 收款单示例
使用 lun_test_密钥并保存在后端，确认 key.sandbox=true → GET /keys/me。下方示例的证件及收款地址均为虚构数据，不要使用生产凭证提交。
POST /cashin/charge · 测试环境请求体示例
{
"amount_cents": 10000,
"payer_tax_number": "12345678901",
"destino": "cripto",
"asset": "usdt",
"chain": "polygon",
"payout_address": "0x1111111111111111111111111111111111111111",
"external_id": "sandbox-pix-usdt-001"
}发送至 https://api.luniumpay.com/cashin/charge 并传入 X-API-Key: $LUNIUM_API_KEY 及 Content-Type: application/json。 amount_cents: 10000 表示 R$ 100.00。金额仅供说明，创建时仍会重新校验限额及实际最低金额。
保存返回的 cashin_id 。测试环境通过以下接口确认： POST /sandbox/cashin/{cashin_id}/pay ，请求体为 {} ；然后查询 GET /cashin/{cashin_id}/status 最高 status=paid 及 settlement_status=sent。测试二维码包含 SANDBOX:NAO_PAGAVEL: ，不得使用银行应用支付。
使用 USDC 或 BTC 时，请选择可用组合，同时修改 asset、 chain 及地址。该接口的网络字段名为 chain ，取值使用交付目录中的 network 。
币种、网络及最低金额来自 API
| 查询 | 产品应使用的信息 |
|---|---|
GET /cashin/catalog | 以下字段组成的有效组合： instant 及 convert 并传入 entregavel=true；请读取 memoRequired、 withdrawMin 及 withdrawFee。 |
POST /cashin/preview | 兑换预估及 min_brl_cents。预览不创建收款单，也不锁定付款时的汇率。 |
GET /cashin/limits?payer_tax=... | 付款人参考限额、资金冻结分级及剩余额度；创建时会重新校验。 |
GET /cashin/{cashin_id}/status | 付款、交付、冻结及可用哈希，须分别读取交易的两种状态。 |
不要在收银台固定写入币种、网络、最低金额或处理期限。路由可能维护、要求 memo 或暂不可交付。 stale=true 表示缓存目录。时效取决于冻结条件、服务商及网络，生成二维码不保证立即结算。
Pix 已支付与加密资产已交付是不同阶段
cashin.paid 确认 Pix 已收到。 cashin.settled 及以下字段组合： status=paid 且 settlement_status=sent 表示发送已记录。链上交付还须读取 settlement_proof、交易及 settlement_confirmed_at：发送已记录与网络确认是不同阶段。若结果为 incerto ，须先对账，不要将订单标记为已交付，也不要自动创建新的收款单。
保存 external_id 及返回标识后，再更新您的订单。重试保持相同引用及请求体。配置 HTTPS 接收端，对原始请求体验证 HMAC 签名，并按 event_id去重。超时后，先查询原交易再决定是否重试。 Webhook 与对账手册 提供完整实现说明。
向客户展示以下字段返回的冻结条件： held_hours、 hold_hours 及 liberar_em（如有）。若不接受付款人分级规则产生的冻结，可使用 allow_hold:false，但这不会移除密钥的其他限制。
接入常见问题
必须登记固定钱包吗？
不需要，直接 cash-in 可为每张收款单提供 payout_address 。若不希望在收款时指定地址，可选择 destino: "saldo" ，之后再从托管余额提现。
所有网络都支持 USDT 与 USDC 吗？
仅使用当前目录中可交付的组合。某资产存在于某网络，不代表该路由已启用；最低金额、成本及 memo 要求因路由而异。
测试环境会支付真实 Pix 并通过交易所发送资产吗？
不会。Pix 二维码不可用于真实付款，加密资产交付为模拟结果，哈希以 sandbox:开头。测试用于验证代码及事件，真实 Pix 与资产交付仅在生产环境发生。
为什么须填写付款人 CPF 或 CNPJ？
payer_tax_number 用于识别实际付款人，并参与限额及核验。它不是订单标识，也不能替代 customer_ref。生产环境须提交正确证件。