LUNIUM
PortuguêsEnglish简体中文Español
Lunium · PIX ↔ 稳定币 API

常见问题

更新于 2026年9月21日

接入前常见问题:时限、限额、费用、退款及交易凭证。

Lunium 是什么?

Lunium 是连接加密资产与 Pix 的结算基础设施。企业接入 API 后,可提供加密资产兑换 Pix(cash-out)、使用 Pix 购买加密资产(cash-in)及公开付款核验。Venda Cripto 是由同一公司运营的个人用户产品。

测试是否需要注册?

无需注册或审批: POST /keys/sandbox 填写您的电子邮箱,即可在响应中获得测试密钥,使用模拟资金验证完整流程。邮箱为必填项,用于接收手册、流程图及接入步骤。生产环境密钥也可通过一次请求创建(POST /keys).

卖出加密资产(cash-out)需要多久?

报价有效期为 15 分钟。此文档记录的 Polygon 充值检测通常仅需数秒,Pix 付款约需 1–2 分钟(此前 90 天的实测中位数为 83 秒)。其他网络的时限取决于区块链确认,并会事先说明。

可以向哪些 Pix 收款标识付款?

可填写 CPF、CNPJ、手机号、电子邮箱或随机 Pix 收款标识,具体取决于交易的验证规则及限额。收款人查询仅为辅助功能,且取决于可用性。请核对 available 及 verified;仅有 HTTP 200 响应不能确认收款人身份。查询功能不可用,并不表示付款功能不可用。

可以支付 Pix 二维码或支付码吗?

通过 Pix 支付码付款时,使用字段 br_code ,且该交易须已启用此功能。向客户提供服务前,请确认资产、网络及可用性。生产环境可能返回 503 br_code_indisponivel,即使测试环境或预览接受该支付码,也不代表正式交易一定可执行。如被拒绝或需要退款,请跟踪同一笔订单的状态与说明。

如何收费?

卖出报价已为净额,显示的 BRL 金额即为收款人实际收到的金额,不再另加费用。标准 cash-in(Pix 兑换加密资产)每张收款单为 3.3% + R$ 1.00。Pix 对外付款的扣款包含发送金额及当前密钥适用费用,总费用可能包含 Lunium 服务费和固定或按比例计算的服务商费用。请查询 GET /saldo ,并核对该交易的 fee_cents 。兑换及提取加密资产时,还须查询所选路由的费用和最低金额。按交易量协商的费率可查询 GET /keys/me。无月费。

有哪些限额?

Cash-out:每笔 R$ 6.00 至 R$ 250,000.00,API 密钥没有每日总额度。收款人另有每日限额:每个收款 CPF/CNPJ 为 R$ 100,000.00,于巴西利亚时间午夜重置;若 Pix 收款标识为邮箱、手机号或随机标识,则按该 Pix 标识计限额,无需提供卖方 CPF。实际单笔最高金额取两项限额的较低值,因此当日尚未收款的收款人最多可接收 R$ 100,000.00。Cash-in:每张收款单 R$ 1.00 至 R$ 6,000.00;按付款人 CPF/CNPJ 分阶段计限额:首笔 R$ 100.00 → 首个 24 小时累计 R$ 200.00 → 此后每日 R$ 6,000.00。超过即时到账额度时,服务商可接受二维码付款并冻结 24 小时,仍须遵守每日 R$ 6,000.00 的限额;首笔交易即可适用,无需历史记录。密钥没有每日总额度,实际限制来自单笔范围、cash-in 付款人额度及 cash-out 收款人额度。当前密钥的有效数值始终以以下接口为准: GET /keys/me。

交易出现问题时怎么办?

如 Pix 收款标识被拒绝、Pix 被撤回或发送前失败,加密资产将退还至该笔订单中填写的 refund_address ,须为客户确认、符合退款网络的地址,绝不会自动退回原充值来源地址。如尚未提供退款地址,请跟踪 AWAITING_REFUND_ADDRESS,并在同一笔订单中填写。若资金已发送至结算服务商,须等服务商将资金退回 Lunium 托管后,再按实际退回金额向客户退款。订单最终进入 REFUNDED ,并提供退款交易哈希。

会提供交易凭证吗?

会,提供三种形式:Pix 官方端到端标识(E2E)、凭证页面及 PDF,均可在 API 响应及 webhook 中获取。任何人均可通过以下公开接口核验付款: GET /v1/verificar/{e2e},无需密钥。

发送到错误网络或地址后,可以追回吗?

不能保证追回。链上转账不可逆,向非报价指定的网络或资产充值,会转入人工处理。发送前请务必核对网络。

如何跟踪交易?

可通过 API(GET /cash-outs/{id})、签名 webhook,或 Telegram 助手跟踪。助手会在企业群组中通知每次状态变化,并回答查询。

Lunium 的运营公司是谁?

ZANQUETA INTERMED LTDA,CNPJ 68.538.127/0001-00,总部位于巴西圣保罗州Americana 市,同时运营 Venda Cripto。联系邮箱:contato@luniumpay.com。

仍未找到所需信息?请联系我们: contato@luniumpay.com · 完整文档。

按使用场景

Pix 兑换 USDT API以 BRL 收款,将 USDT 交付至客户钱包。USDT 兑换 Pix API卖出稳定币,向 Pix 收款标识付款。Pix 对外付款 API通过 API,以 BRL 向供应商和用户付款。通过 API 兑换 BRL ↔ USDT支持双向兑换,并提供报价与交易凭证。巴西法币与加密资产的双向兑换一次接入,支持巴西境内的法币与加密资产兑换。客户用 Pix 付款,商户以稳定币收款接收客户的 Pix 付款,将资金兑换为数字美元。面向钱包的 Pix 与稳定币服务为您的用户接入法币与加密资产的双向兑换通道。使用您的品牌的支付基础设施在您的产品背后运行完整资金流程。

与开发团队直接沟通

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

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