[跳至正文](/zh/minimos#conteudo)

搜索手册

本手册内容

各密钥的具体规则以 API 为准。接入时参考示例，实际运行时以 API 响应为依据。[OpenAPI 1.44.7](/zh/openapi.json)[最低金额与网络](/zh/minimos)[源文档修订 2026-09-19.3](/zh/manual-contract.json)



## 先明确：您要执行哪种交易？

**USDT 并不存在适用于所有流程的统一最低金额。** 金额取决于交易方向、网络、兑换路径及密钥条件。发送 USDT 接收 Pix，与支付 Pix 接收 USDT，是不同产品流程。

| 客户目标 | 文档中的名称 | 接口 | 提交的金额单位 |
| --- | --- | --- | --- |
| 支付 Pix，在钱包接收加密资产 | Cash-in / 购买：BRL → 加密资产 | `POST /cashin/charge`、 `destino: "cripto"` | `amount_cents`：BRL 分 |
| 从钱包发送加密资产，接收 Pix | Cash-out / 卖出：加密资产 → BRL | `POST /cash-outs` → 接受报价 → 充值 | `amount`：加密资产数量 **或** `brl_amount`：期望 BRL 金额 |
| 支付 Pix，保留 BRL，之后再提现 | Cash-in 充值至托管余额 | `POST /cashin/charge`、 `destino: "saldo"` | `amount_cents`：BRL 分 |
| 将 BRL 余额兑换并发送为加密资产 | 托管余额提现 | `POST /saldo/sacar-cripto` | `amount_cents`：待兑换的 BRL 金额，以分计 |

购买及提现时，查询 `GET /cashin/catalog` ，并在以下字段传入网络： **`chain`**。卖出时，查询 `GET /catalog` ，并传入 **`network`**。某网络可能只支持一个方向。本指南的“加密资产充值”指最终支付 Pix 的卖出入金，不表示创建 USDT 托管余额。

## 最低与最高金额概览

| 操作 | 最低金额 | 最高金额 / 限制 |
| --- | --- | --- |
| BRL → 加密资产 | 账户与路由最低金额取较大值，并考虑费用 | R$ 6,000.00，另受付款人、网络及 mandate 限制 |
| Polygon 上的 USDT/USDC → Pix | 单笔最低 R$ 6.00，加密资产数量取决于报价 | 单笔 R$ 250,000.00，收款人每日最多 R$ 100,000.00，并扣除已用额度 |
| 其他加密资产 → Pix | 资产最低数量 + 适用 BRL 最低金额 | 资产最高数量 + BRL 上限 + 收款人 / mandate 限制 |
| Pix → BRL 余额 | 账户 / 服务商最低金额 | R$ 6,000.00，受付款人条件约束 |
| BRL 余额 → 加密资产 | 提现金额及路由最低要求，费用独立适用 | 路由 / 单笔限额，以及足够覆盖本金和费用的可用余额 |
| DePix / Liquid | 独立规则，参阅 DePix 章节 | 独立规则，不套用其他资产上限 |

**如何结合不同限额：** 实际最低金额须满足所有适用下限，实际最高金额须不超过所有适用上限。比较前换算至同一币种。若最低金额超过当前最高可用额度，则此时不存在可执行金额。

本页数值仅为参考快照，密钥费用、流动性、可用余额、付款人 / 收款人已用额度及 `mandate` 等策略可能影响最终结果。报价及创建时会重新校验，字段缺失或 `null` 不代表零值或无限额。

## 账户最低金额、网络最低数量与交付净额

| 字段 | 单位 | 含义 |
| --- | --- | --- |
| `limits.per_operation.cashin.min_brl_cents` | BRL 分 | 账户 / 服务商最低金额，须确保扣除密钥费用后仍有有效金额，不能替代路由最低要求。 |
| `withdrawMin` | 资产单位 | 交易所在该网络的最低提现量。 |
| `withdrawFee` | 资产单位 | 交易所提现费用，与 Lunium 费用及合作伙伴佣金分开。 |
| `minBuyAmount` | 资产单位 | 为覆盖最低提现量及费用，至少须 **购买** 的资产数量，不一定等于钱包最终收到的净额。 |
| `withdrawMax` | 资产单位 | 交易所公布的该网络最高提现量，不代表 Lunium 允许购买相同金额。 |
| `min_brl_cents` | BRL 分 | 路由预览按密钥条件返回的最低 BRL 金额，完成计算后也可能出现在已验证身份的目录中。 |
| `minimo_estimado_cents` | BRL 分 | 低于最低金额时，若响应提供此字段，可用于提示修正金额，之后须重新预览。 |

教学示例： `withdrawMin = "5"` 及 `withdrawFee = "0.0065"` 表示至少购买 **5.0065 USDT** ，才可完成以下提现： **5 USDT**。仍须换算为 BRL 并计入密钥费用，最终交付数量以实际报价响应为准。

BRL 分使用整数： `10000` 表示 R$ 100.00。加密资产使用十进制字符串： `"6"` 表示 6 USDT，前提是 `asset` 为 USDT。对于 `brl_amount`、 `"100.00"` ，表示 R$ 100.00，不要传入 `10000` 并误当成分。遵守资产精度，不使用浮点数舍入处理转账。

## Cash-in：支付 BRL，接收加密资产

1. 通过以下接口读取密钥条件： `GET /keys/me`，包括单笔限额、费用及可能适用的 `mandate`。
2. 读取 `GET /cashin/catalog`。提供的币种 / 网络组合须符合 `entregavel: true`。核对 `memoRequired`。
3. 使用`GET /cashin/limits?payer_tax=CPF_OU_CNPJ` 查询，并填写**实际支付 Pix 的付款人证件**。
4. 请求 `POST /cashin/preview` ，传入金额、币种及网络。使用响应中的 `min_brl_cents` ；如缺失，不要根据另一资产编造最低 BRL 金额。
5. 展示 BRL 总额、费用及预估接收净数量，再用相同路由参数创建收款单。
6. 跟踪结算。Pix 已付款不代表加密资产已交付，须核对 `settlement_status` 及 `cashin.settled`。

每张收款单上限来自 `limits.per_operation.cashin.max_brl_cents`，付款人的剩余额度可能更低。 `available_cents` / `instant_available_cents` 表示无需冻结的额度区间； `held_qr` 表示需要冻结的区间，如适用。 `max_amount_cents` 仅供参考，不能替代密钥、服务商或路由校验。如产品要求资金立即可用，应通过以下参数明确处理冻结： `allow_hold: false` ，并遵守响应。

**加密资产数量上限：** 将待提取净数量与 `withdrawMax`比较（如提供），并同时核对收款单的 BRL 上限。不要将 R$ 6,000 固定换算为某个 USDT 数量，汇率及费用会变化。网络、单笔及付款人限额是不同校验。

### USDT 与 USDC：各网络参考数值

### USDT

| 网络 | 最低提现量 | 网络费用 | 最低购买量 | 参考最低 BRL 金额 | 网络最高提现量 |
| --- | --- | --- | --- | --- | --- |
| bsc | 0.2 USDT | 0.01 USDT | 0.21 USDT | R$ 1.10 | 20,000,000 USDT |
| cfxevm | 1 USDT | 0.01 USDT | 1.01 USDT | R$ 5.30 | 1,000,000 USDT |
| arbitrum | 1 USDT | 0.05 USDT | 1.05 USDT | R$ 5.50 | 5,000,000 USDT |
| celo | 2 USDT | 0.05 USDT | 2.05 USDT | R$ 10.60 | 5,000,000 USDT |
| tron | 2 USDT | 0.5 USDT | 2.5 USDT | R$ 12.90 | 30,000,000 USDT |
| klay | 2 USDT | 1 USDT | 3 USDT | R$ 15.50 | 1,000,000 USDT |
| optimism | 3 USDT | 0.0078 USDT | 3.0078 USDT | R$ 15.50 | 200,000 USDT |
| avalanche | 4 USDT | 0.000074 USDT | 4.000074 USDT | R$ 20.70 | 2,000,000 USDT |
| polygon | 5 USDT | 0.0065 USDT | 5.0065 USDT | R$ 25.80 | 5,000,000 USDT |
| ton | 8 USDT | 0.017 USDT | 8,017 USDT | R$ 41.30 | 5,000,000 USDT |
| eth | 8 USDT | 0.094 USDT | 8,094 USDT | R$ 41.70 | 30,000,000 USDT |
| plasma | 10 USDT | 0 USDT | 10 USDT | R$ 51.50 | 2,000,000 USDT |
| solana | 10 USDT | 0.18 USDT | 10.18 USDT | R$ 52.50 | 9,000,000 USDT |

### USDC

| 网络 | 最低提现量 | 网络费用 | 最低购买量 | 参考最低 BRL 金额 | 网络最高提现量 |
| --- | --- | --- | --- | --- | --- |
| arbitrum | 0.5 USDC | 0.0033 USDC | 0.5033 USDC | R$ 2.60 | 2,000,000 USDC |
| polygon | 1 USDC | 0.011 USDC | 1,011 USDC | R$ 5.30 | 1,000,000 USDC |
| base | 1 USDC | 0.1 USDC | 1.1 USDC | R$ 5.70 | 1,500,000 USDC |
| optimism | 2 USDC | 0.016 USDC | 2,016 USDC | R$ 10.50 | 2,000,000 USDC |
| eth | 2 USDC | 0.17 USDC | 2.17 USDC | R$ 11.20 | 15,000,000 USDC |
| algo | 2 USDC | 1 USDC | 3 USDC | R$ 15.50 | 5,000,000 USDC |
| seievm | 2 USDC | 1 USDC | 3 USDC | R$ 15.50 | 200,000 USDC |
| avalanche | 5 USDC | 0.00021 USDC | 5.00021 USDC | R$ 25.80 | 1,000,000 USDC |
| sonic | 5 USDC | 0.01 USDC | 5.01 USDC | R$ 25.90 | 1,000,000 USDC |
| bsc | 10 USDC | 0 USDC | 10 USDC | R$ 51.60 | 5,000,000 USDC |
| solana | 20 USDC | 0.18 USDC | 20.18 USDC | R$ 104.20 | 5,000,000 USDC |

表中最低 BRL 金额来自接入费率为零的预览，已考虑网络提现费用。您须通过自己的密钥预览计入适用费用。网络上限不能替代 BRL 上限，时效均为预估，不是结算保证。

## Cash-out：充值加密资产，接收 Pix

**Polygon 上的 USDT/USDC 通过 `fast`：** 渠道时，不应套用固定 6 个代币的最低数量，须满足交易最低 BRL 金额。实际 USDT/USDC 数量取决于报价，不要把“R$ 6”当成“6 USDT”。

**渠道 `convert`：** 读取 `min` 及 `max` 中对应资产的数值，并通过 `networks`核对网络。稳定币的 6 至 200,000 单位区间不适用于 BTC、ETH 或其他资产，下方搜索表列出主目录各资产的独立数值。

**资产数量限额之外，还须遵守 BRL 限额。** 交易还须满足 `limits.per_operation.cashout`、收款人当日剩余额度及适用的 `mandate`。交易响应提供以下字段时，请读取： `limits`中，使用 `min_amount`、 `max_amount`、 `min_brl_cents` 及 `max_brl_cents` （如有）。并非每种拒绝响应都包含全部字段。

示例：单笔名义上限 R$ 250,000，加上收款人每日 R$ 100,000 限制，不代表可执行 R$ 250,000 的 Pix。若收款人当日已用 R$ 80,000，则该项剩余额度最多 R$ 20,000，还须考虑其他限制。拆分为多笔订单不能绕过每日上限。按公开规则，额度于巴西利亚时间午夜重置。

充值流程：

1. 查询目录并核对精确组合。预览既不创建订单，也不接受报价。
2. 通过以下接口创建报价： `POST /cash-outs` 并传入 `amount` **或** `brl_amount`，两者不可同时发送。按期望 Pix BRL 金额报价，使用 `brl_amount`。
3. 核对返回的加密资产数量、Pix 金额、费用、有效期及限额。
4. 通过以下接口接受报价： `/cash-outs/{cashout_id}/accept`。
5. 仅使用接受响应中的 `deposit_address` 及必要的 `deposit_tag` ，并选择指定网络。转入请求的精确数量，注意来源交易所可能扣除自身发送费用。
6. 确认达到 `COMPLETED` 后，才视为 Pix 已完成。链上确认、充值入账及 Pix 已支付是不同阶段。

`refund_address` 为可选项。已有客户退款网络钱包时可提前提供；未提供时，仅卖出失败后才要求填写。取得订单地址并接受报价前，不发送加密资产。期限已过或金额变化时，须取得 API 新说明，不假定旧报价汇率仍然有效。

## 查询主目录全部币种与网络

本快照列出 **1,645 条购买路由** （1,438 种资产，含不可用项目）及 **1,531 个卖出组合** （1,338 种资产，汇总以下渠道： `fast` 及 `convert`).

可搜索，例如 **USDT**、 **BTC**、 **ETH**、 **polygon** 或 **tron** ，再选择交易方向。每行明确最低及最高金额单位。“查询预览”或“未公布”表示此来源不足以给出具体限额。

币种或网络操作购买 · BRL → 加密资产卖出 · 加密资产 → Pix全部 仅可用项目

先显示 30 条购买路由，启用 JavaScript 后可搜索全部。

| 操作 | 币种 / 网络 | 最低资产数量¹ | 最高资产数量² | 参考最低 BRL 金额 | 名义 BRL 上限³ | 可用性 / 说明 |
| --- | --- | --- | --- | --- | --- | --- |
| 购买 | USDT / aptos (convert) | 10.1 USDT | 2,000,000 USDT | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：0.1 USDT · 预计不超过2 分钟 |
| 购买 | USDT / arbitrum (convert) | 1.05 USDT | 5,000,000 USDT | R$ 5.50 | R$ 6,000.00 | 目录中可用 · 网络费用：0.05 USDT · 预计不超过2 分钟 |
| 购买 | USDT / avalanche (convert) | 4.000074 USDT | 2,000,000 USDT | R$ 20.70 | R$ 6,000.00 | 目录中可用 · 网络费用：0.000074 USDT · 预计不超过2 分钟 |
| 购买 | USDT / bsc (convert) | 0.21 USDT | 20,000,000 USDT | R$ 1.10 | R$ 6,000.00 | 目录中可用 · 网络费用：0.01 USDT · 预计不超过2 分钟 |
| 购买 | USDT / celo (convert) | 2.05 USDT | 5,000,000 USDT | R$ 10.60 | R$ 6,000.00 | 目录中可用 · 网络费用：0.05 USDT · 预计不超过2 分钟 |
| 购买 | USDT / cfxevm (convert) | 1.01 USDT | 1,000,000 USDT | R$ 5.30 | R$ 6,000.00 | 目录中可用 · 网络费用：0.01 USDT · 预计不超过2 分钟 |
| 购买 | USDT / eth (convert) | 8,094 USDT | 30,000,000 USDT | R$ 41.70 | R$ 6,000.00 | 目录中可用 · 网络费用：0.094 USDT · 预计不超过5 分钟 |
| 购买 | USDT / klay (convert) | 3 USDT | 1,000,000 USDT | R$ 15.50 | R$ 6,000.00 | 目录中可用 · 网络费用：1 USDT · 预计不超过2 分钟 |
| 购买 | USDT / near (convert) | 2.2 USDT | 2,000,000 USDT | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：0.2 USDT · 预计不超过2 分钟 |
| 购买 | USDT / optimism (convert) | 3.0078 USDT | 200,000 USDT | R$ 15.50 | R$ 6,000.00 | 目录中可用 · 网络费用：0.0078 USDT · 预计不超过2 分钟 |
| 购买 | USDT / plasma (convert) | 10 USDT | 2,000,000 USDT | R$ 51.50 | R$ 6,000.00 | 目录中可用 · 网络费用：0 USDT · 预计不超过2 分钟 |
| 购买 | USDT / polkadot (convert) | 3 USDT | 200,000 USDT | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：1 USDT · 预计不超过5 分钟 |
| 购买 | USDT / polygon (convert) | 5.0065 USDT | 5,000,000 USDT | R$ 25.80 | R$ 6,000.00 | 目录中可用 · 网络费用：0.0065 USDT · 预计不超过2 分钟 |
| 购买 | USDT / solana (convert) | 10.18 USDT | 9,000,000 USDT | R$ 52.50 | R$ 6,000.00 | 目录中可用 · 网络费用：0.18 USDT · 预计不超过2 分钟 |
| 购买 | USDT / ton (convert) | 8,017 USDT | 5,000,000 USDT | R$ 41.30 | R$ 6,000.00 | 目录中可用 · memo/tag 必填 · 网络费用：0.017 USDT · 预计不超过2 分钟 |
| 购买 | USDT / tron (convert) | 2.5 USDT | 30,000,000 USDT | R$ 12.90 | R$ 6,000.00 | 目录中可用 · 网络费用：0.5 USDT · 预计不超过2 分钟 |
| 购买 | USDC / algo (convert) | 3 USDC | 5,000,000 USDC | R$ 15.50 | R$ 6,000.00 | 目录中可用 · memo/tag 必填 · 网络费用：1 USDC · 预计不超过5 分钟 |
| 购买 | USDC / aptos (convert) | 3 USDC | 1,500,000 USDC | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：1 USDC · 预计不超过2 分钟 |
| 购买 | USDC / arbitrum (convert) | 0.5033 USDC | 2,000,000 USDC | R$ 2.60 | R$ 6,000.00 | 目录中可用 · 网络费用：0.0033 USDC · 预计不超过2 分钟 |
| 购买 | USDC / arc (convert) | 1.5 USDC | 200,000 USDC | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：0.5 USDC · 预计不超过5 分钟 |
| 购买 | USDC / avalanche (convert) | 5.00021 USDC | 1,000,000 USDC | R$ 25.80 | R$ 6,000.00 | 目录中可用 · 网络费用：0.00021 USDC · 预计不超过2 分钟 |
| 购买 | USDC / base (convert) | 1.1 USDC | 1,500,000 USDC | R$ 5.70 | R$ 6,000.00 | 目录中可用 · 网络费用：0.1 USDC · 预计不超过2 分钟 |
| 购买 | USDC / bsc (convert) | 10 USDC | 5,000,000 USDC | R$ 51.60 | R$ 6,000.00 | 目录中可用 · 网络费用：0 USDC · 预计不超过2 分钟 |
| 购买 | USDC / eth (convert) | 2.17 USDC | 15,000,000 USDC | R$ 11.20 | R$ 6,000.00 | 目录中可用 · 网络费用：0.17 USDC · 预计不超过5 分钟 |
| 购买 | USDC / near (convert) | 2.05 USDC | 400,000 USDC | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：0.05 USDC · 预计不超过2 分钟 |
| 购买 | USDC / optimism (convert) | 2,016 USDC | 2,000,000 USDC | R$ 10.50 | R$ 6,000.00 | 目录中可用 · 网络费用：0.016 USDC · 预计不超过2 分钟 |
| 购买 | USDC / polkadot (convert) | 3 USDC | 200,000 USDC | 查询预览 | R$ 6,000.00 | 不可交付 · 网络费用：1 USDC · 预计不超过5 分钟 |
| 购买 | USDC / polygon (convert) | 1,011 USDC | 1,000,000 USDC | R$ 5.30 | R$ 6,000.00 | 目录中可用 · 网络费用：0.011 USDC · 预计不超过2 分钟 |
| 购买 | USDC / seievm (convert) | 3 USDC | 200,000 USDC | R$ 15.50 | R$ 6,000.00 | 目录中可用 · 网络费用：1 USDC · 预计不超过5 分钟 |
| 购买 | USDC / solana (convert) | 20.18 USDC | 5,000,000 USDC | R$ 104.20 | R$ 6,000.00 | 目录中可用 · 网络费用：0.18 USDC · 预计不超过2 分钟 |

上一页下一页

Todas as linhas também estão no [catálogo em Markdown](/zh/limites-catalogo.md)。

¹ 购买：最低购买数量；卖出：资产 / 路由最低数量。² 购买：网络最高提现量；卖出：资产 / 路由最高数量。³ 名义 BRL 上限仍受付款人 / 收款人、费用、余额及密钥规则约束。

购买目录中， `entregavel: false` 会标为不可用，不应提供给客户。交易所卖出目录按资产提供一个区间及网络列表，表格将该区间列于各支持网络，不编造网络独立限额。其他币种的最低 BRL 金额须查询对应组合预览，不能套用 USDT 报价。

**DEX 代币：** 主目录提供 DEX 网络，但不列出全部代币及其限额。请查询 `GET /catalog/dex?chain=...&q=...`，按合约地址 /`token_address` 识别代币并报价。可用性、最低及最高金额取决于流动性及交易限制。不要套用稳定币限额，也不要仅按符号识别代币。本表覆盖主目录列出的资产，不保证包含全部 DEX 白名单。

## 资金托管：充值 BRL，以加密资产提现

**充值至余额：** `destino: "saldo"` 记入 BRL 托管余额，不立即交付加密资产，因此 USDT/Polygon 最低提现量不是托管入金下限。仍须满足账户 / 服务商最低金额、收款单上限及付款人规则，充值费用及冻结可能减少可用余额。

**提现为加密资产：** 选择购买目录中可交付的路由，网络最低及最高提现量仍适用，并有独立金额及提现费用校验。Cash-in 预览本身不代表托管提现的完整成本，须结合 `GET /saldo` 及提现响应。

- `amount_cents` 是待兑换 BRL 金额，不是代币数量。
- 余额中的 **可用** 须足以覆盖本金及费用，不要把包含冻结款项的总额当作可用余额。
- 等待期、资金冻结及余额不足，与网络最低金额是不同限制。
- Liquid/DePix 不支持 `POST /saldo/sacar-cripto`，即使出现在购买目录中也一样。通过 Pix 提取 BRL，请使用 `POST /payouts`。
- 如有子账户，请使用对应的 `customer_ref` ，不混淆主账户与客户子账户余额。

## DePix：Liquid 路由独立规则

| 方向 | 公布的最低金额 | 公布的最高金额 | 费用 / 参考 |
| --- | --- | --- | --- |
| 购买 | 2.01 DePix | R$ 6,000.00 | 查询当前密钥 Liquid 路由预览 |
| 卖出 | 1.02 DePix | 6,000 DePix | 1.5% + R$ 1.00 |

DePix 表示 Liquid 网络中的 BRL，名义上 1 DePix 对应 R$ 1.00，但扣费后净额不等于总额。购买时， `delivery_mode` 及密钥条件区分直接交付（`full`）与扣费后净额交付（`split`）。请使用该路由预览，下方交易所路由费用计算器不适用于 DePix。

卖出时，以下目录行的独立限额及费用： `DEPIX/liquid` 优先于其他加密资产 cash-out 概览。Pix 标识不是 CPF/CNPJ 时，创建须提供 `payee_tax_number` ； `refund_address` （客户 Liquid 钱包）自 API 1.44.0 起可选，未提供时仅在卖出失败后要求填写。目录可用性可能随路由健康状态变化。

## 计算与拒绝示例

### BRL → Polygon 上的 USDT

教学示例，不代表生产汇率：最低提现量 **5 USDT**，网络费用 **0.0065 USDT**，汇率 **R$ 5.30/USDT**，固定费用 **R$ 2** ，总比例费用 **2%**。

```
Quantidade mínima a comprar = 5 + 0,0065 = 5,0065 USDT
Custo da rota em BRL = 5,0065 × 5,30 = R$ 26,53445
Estimativa bruta = (26,53445 + 2) ÷ (1 − 0,02)
                 ≈ R$ 29,1168
Estimativa arredondada para cima em R$ 0,10: R$ 29,20
```

此计算仅帮助理解最低金额，交易参考应为 **`min_brl_cents` 在预览中返回的数值**。舍入、实际汇率及密钥费用可能改变结果。不要重复扣除网络费用，它已计入最低购买数量。

### 为何 R$ 10 可能支持 USDC，却不支持 USDT？

各币种网络的最低数量不同。例如 Polygon 上购买 1.011 USDC 可能满足其最低提现要求，而 USDT 须购买 5.0065 USDT。同一参考汇率下，后者需要更多 BRL。R$ 10 是否足够购买 USDC，还取决于密钥费用及限额，不是通用保证。

### 目录显示 200,000 USDT，为什么更小卖出仍被拒绝？

那是兑换渠道的资产数量上限，BRL 上限、收款人当日剩余额度或密钥策略可能更低。请展示 **实际有效值**，而不是不同来源中的最大数值。

### 须发送多少，才能让 Pix 收款金额准确？

通过反向报价，传入 `brl_amount`。读取返回的精确加密资产数量，核对有效期并接受订单，不要使用外部汇率换算后假定已包含产品费用。

## 交易所路由说明计算器

请填写适用的 **总比例费用** ，包括适用购买佣金，并填写固定 BRL 费用。初始值仅为示例。此计算器使用稳定币参考最低金额，并按 R$ 0.10 向上取整，不查询您的密钥、不校验付款人额度，也不创建报价。

总费率，单位 bps（200 = 2%）固定 BRL 费用

| 币种 | 网络 | 参考最低金额 | 计入费用后的预估 |
| --- | --- | --- | --- |

不要将 cash-in 计算套用于 DePix、cash-out 或托管提现，各产品有独立条件。若预估金额超过交易剩余额度，不应提供该金额，须查询其他允许路由或更新后的条件。

## 各规则的 API 查询来源

| 资料来源 | 字段 / 规则 | 查询时机 |
| --- | --- | --- |
| `GET /keys/me` | `limits.per_operation`、 `payer_limits`、 `payee_limits`、 `mandate`、密钥费用 | 加载项目条件时，以及作出受限额影响的决定前 |
| `GET /cashin/catalog` | `instant`、 `convert`、 `asset`、 `network`、 `entregavel`、 `memoRequired`、 `withdrawMin`、 `withdrawFee`、 `withdrawMax`、 `minBuyAmount`、必要时的 `min_brl_cents` | 提供购买 / 提现路由前 |
| `GET /cashin/limits?payer_tax=...` | `max_amount_cents`、 `available_cents`、 `instant_available_cents`、 `held_qr` | 向该付款人收款前 |
| `POST /cashin/preview` | `min_brl_cents`，以及响应中的净额、费用及路由资料 | 选择金额 / 币种 / 网络时，不创建收款单 |
| `GET /catalog` | `fast`、 `convert[].networks`、 `min`、 `max`、 `precision`、 `deposit_eta`、 `dex` | 卖出报价前 |
| `GET /catalog/dex` | 代币、网络及合约地址身份 | DEX 代币报价前 |
| Cash-out 响应 / 限额错误 | 对象 `limits`（如有）、精确数量及报价有效期 | 接受报价 / 充值前，以及修正拒绝条件时 |
| `GET /saldo` | 可用余额、托管费用、等待期及冻结 | 托管提现前 |

`limits.max_brl_cents_por_transacao`如有返回，表示单笔名义上限。 `limits.max_brl_cents` 在限额错误中可能表示更低的实际上限，不要假定错误响应的字段也一定存在于 `/keys/me`。

### 只读查询与预览

在服务器执行，密钥保存在环境变量中。将 `PAYER_TAX` 替换为实际付款人的证件。示例不创建收款单、充值地址或提现。

```
curl --fail-with-body -sS 'https://api.luniumpay.com/keys/me' \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS 'https://api.luniumpay.com/cashin/catalog' \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS --get 'https://api.luniumpay.com/cashin/limits' \
  --data-urlencode "payer_tax=$PAYER_TAX" \
  -H "X-API-Key: $LUNIUM_API_KEY"

curl --fail-with-body -sS 'https://api.luniumpay.com/cashin/preview' \
  -H "X-API-Key: $LUNIUM_API_KEY" -H 'Content-Type: application/json' \
  -d '{"amount_cents":10000,"asset":"usdt","chain":"polygon"}'

curl --fail-with-body -sS 'https://api.luniumpay.com/catalog' \
  -H "X-API-Key: $LUNIUM_API_KEY"
```

不要在公开浏览器 JavaScript 中放入生产密钥。文档仅使用公开快照，不包含凭证或客户个别限额。

## 如何处理错误并避免循环重试

| 情况 | 处理方式 |
| --- | --- |
| `valor_abaixo_do_minimo` | 读取 `minimo_estimado_cents`、 `min_brl_cents` 或 `limits.min_amount`（如有），调整金额并重新报价，不无限重试相同金额。 |
| `valor_acima_do_maximo` | 读取返回上限及单位，并核对付款人 / 收款人及密钥策略。 |
| `limite_do_pagador`、 `limite_diario_recebedor`、 `limite_diario` | 核对账户范围及期限，不混淆每日额度与单笔上限。 |
| `mandate_valor_acima_do_teto` | 读取 `limits` 及响应说明，识别实际上限及密钥 / 收款人条件，不假定只需提高客户端数值即可。 |
| `rede_indisponivel`、 `catalogo_indisponivel` | 重新读取目录并保留所选网络，不自动更换钱包网络。 |
| `memo_obrigatorio` | 取得并发送正确网络 memo/tag，不用零或编造值代替。 |
| `saldo_insuficiente`、 `carencia_primeiro_deposito` | 核对可用余额、费用及等待期，提高请求金额不能解决问题。 |

按以下字段编写业务分支： `erro` 及 `acao`，并遵守接口契约； `detail` 仅用于向用户说明。保存 `request_id` 用于诊断。响应无数值限额时，不从自由文本提取任意金额作为永久规则。测试环境为模拟条件，不证明生产限额。

## 更新、精度与资料来源

**采集完成时间：** 2026年10月15日 00:41:01（UTC-3）。 **购买目录：** 2026年10月15日 00:34:29（UTC-3）。 **卖出目录：** 2026年10月15日 00:40:08（UTC-3）。

USDT 参考汇率 R$ 5.15，仅用于说明，不是所有币种的汇率。

本中文版本为页面标注日期的审校快照。原始采集程序计划每小时刷新目录；采集失败时保留上一份有效文件及其日期。实际交易须使用当前 API 重新核验。 `stale: true` 在目录中表示备用缓存，不应将缓存数据称为新报价。

同一次生成的表格、内嵌数据及 Markdown 使用同一快照，显示日期对应所展示数值。刷新页面将加载当前已发布版本。已验证身份的目录及实际交易响应优先于公开快照。

资料来源： [API 参考文档](/zh/)、 [OpenAPI](/zh/openapi.json)、 [接入手册](/zh/manual)、 [公开目录](/zh/catalogo.json)、 [本指南 Markdown 版](/zh/minimos.md) 及 [完整目录 Markdown 版](/zh/limites-catalogo.md)。

## 接入检查清单

- 区分购买、卖出、托管充值及托管提现。
- 在正确目录选择币种 / 网络，需要时校验 memo/tag。
- 最低及最高金额明确标注单位：BRL、分或代币数量。
- 确认前展示费用、预计净接收数量及冻结条件。
- 适用最低金额取最大值、最高金额取最小值，先统一币种再比较。
- 金额、币种、网络或密钥条件变化后重新查询预览。
- 区分限额未公布、路由不可用，以及当前无有效交易金额。
- 卖出仅在接受报价后，按返回资料充值。
- 同一交易重试保持幂等，更改参数须遵循该接口的 `external_id` 规则。
- 通过最终状态确认交付 / 入账 / Pix，并结合 webhook 及查询对账。

## 人工支持与实时跟踪

**强烈建议建立人工支持群组：** Lunium 或合作伙伴可创建项目群组，并添加 [@luniumb2b](https://t.me/luniumb2b) 及 [@luniumb2c](https://t.me/luniumb2c)，以及 [@LuniumNotifyBot](https://t.me/LuniumNotifyBot)。 [查看群组使用指南](/zh/manual#telegram)。交易跟踪可使用以下接口返回的私密监控： `/keys/me` ，并实现 [Webhook、实时控制台及对账](/zh/manual#monitor-ao-vivo)。不要向未授权人员分享密钥、签名密钥或私密监控链接。