---
title: "Cotação de cash-in — não cria nada"
method: POST
path: "/cashin/preview"
---

# Cotação de cash-in — não cria nada

`POST /cashin/preview`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/cashin/preview`
- Auth: API key in header `X-API-Key`

Depósito Pix em saldo BRL: taxa Lunium R$ 1,00 e subfee opcional partner_deposito_fee_bps (padrão 0), independente das demais taxas. Com destino=saldo, net_cents=floor((amount_cents-100)*(10000-partner_deposito_fee_bps)/10000); a prévia discrimina lunium_fee_cents, partner_fee_cents e fee_total_cents. Não cria cobrança nem converte moeda. Compra e saque conservam suas condições; consulte a prévia e GET /keys/me. Valores ficam congelados ao criar a cobrança.

## Request body

- object
  - `amount_cents` integer, required: Valor BRL em centavos inteiros. Mínimo efetivo depende da chave, taxas e rota. Consulte GET /keys/me e min_brl_cents/limits retornados; não fixe o mínimo do exemplo.
  - `asset` string: Ativo da rota entregável em GET /cashin/catalog; não limitado a stablecoins.
  - `chain` string: Rede da rota de entrega. Use o network do catálogo neste campo chain.
  - `delivery_mode` 'full' | 'split': Somente para chain="liquid" (DePix). "full" (padrão) entrega o DePix direto na carteira informada, com o valor cheio — a taxa da chave não é descontada. "split" faz o caminho receber-e-repassar: a Lunium recebe o DePix, desconta a taxa da chave (fixa + percentual) e envia o líquido para payout_address; net_cents na resposta é exatamente o que o destinatário recebe. Em split, payout_address é obrigatório. Sem o campo, vale o padrão da sua chave.
  - `destino` 'cripto' | 'saldo'

## Response `200`

Cotação com a taxa da chave aplicada.

- union
  - object: Depósito Pix em saldo BRL: taxa Lunium R$ 1,00 e subfee opcional partner_deposito_fee_bps (padrão 0), independente das demais taxas. Com destino=saldo, net_cents=floor((amount_cents-100)*(10000-partner_deposito_fee_bps)/10000); a prévia discrimina lunium_fee_cents, partner_fee_cents e fee_total_cents. Não cria cobrança nem converte moeda. Compra e saque conservam suas condições; consulte a prévia e GET /keys/me. Valores ficam congelados ao criar a cobrança.
    - `asset` string: Ativo da entrega, ecoado do pedido (usdt, usdc, depix, btc…).
    - `amount_cents` integer: Valor da cobrança em centavos, ecoado do pedido.
    - `admin_fee_bps` integer
    - `admin_fee_fixed_cents` integer
    - `fee_total_cents` integer: TUDO que saiu do bruto: taxa fixa + % da Lunium + sub fee do parceiro. Invariante: fee_total_cents + net_cents == amount_cents. Para saber de quem é cada parte, leia lunium_fee_cents e partner_fee_cents.
    - `net_cents` integer: Valor líquido convertido em cripto para o usuário final, já descontada a sub fee do parceiro (se houver).
    - `brl_per_usdt` string: Cotação arredondada p/ leitura — o valor entregue usa a cotação cheia.
    - `usdt_amount` string: Campo legado. No trilho da casa (DePix e entregas feitas pela carteira da própria Lunium) é a quantidade entregue; quando a entrega passa por conversão (BTC, ETH e demais pares do catálogo, inclusive stablecoins em algumas rotas), é o USDT usado na compra, NÃO o que o cliente recebe. Para exibir a cripto que chega na carteira, leia sempre asset_amount.
    - `chain` string: Rede da entrega, ecoada do pedido (normalizada: sol → solana, trc20 → tron…).
    - `asset_amount` string: Quantidade de cripto que chega na carteira do cliente, já descontadas a taxa da chave, a sub fee do parceiro e, nas rotas convertidas, a comissão de compra e a taxa de saque da rede (withdraw_fee). É o número para mostrar como “você recebe”. Mesmo campo do sandbox. Estimativa: a entrega recalcula a cotação no pagamento.
    - `withdraw_fee` string: Taxa de saque da rede, em unidades do ativo, já descontada de asset_amount. É fixa por envio (não depende do valor), então pesa mais em valores pequenos — por exemplo, BTC na rede Bitcoin. "0" no trilho da casa. Em reais: withdraw_fee × brl_per_asset.
    - `withdraw_min` string: Menor quantidade que a rede envia, em unidades do ativo (rotas convertidas). O mínimo em reais já vem calculado em min_brl_cents.
    - `brl_per_asset` number, nullable: Reais por unidade do ativo nesta prévia (valor líquido ÷ quantidade comprada). Serve para converter withdraw_fee e asset_amount em reais. Informativo; null quando não há conta.
    - `min_brl_cents` integer: Menor valor, em centavos, que esta rota entrega com as taxas desta chave.
    - `eta` string: Prazo típico da entrega nesta rota (rotas convertidas); não é prazo máximo contratual.
    - `amount` string: Nome antigo de asset_amount (só nas rotas convertidas). Prefira asset_amount.
    - `network_min` string: Nome antigo de withdraw_min. Prefira withdraw_min.
    - `partner_fee_bps` integer: Sub fee do parceiro aplicada nesta cotação (bps). 0 = não usa.
    - `lunium_fee_cents` integer: Parte da Lunium (fixa + %). Sem sub fee, é igual a fee_total_cents.
    - `partner_fee_cents` integer: Parte do parceiro (sub fee), creditada na comissão quando a cripto for entregue. Resíduo de um único floor: a parte da Lunium não muda com a sub fee.
    - `sandbox` unknown
    - `delivery_mode` 'full' | 'split': Só em chain="liquid": como o DePix foi entregue. Ausente nas outras redes.
    - `destino` 'cripto' | 'saldo'
  - object: Sandbox isolada: cotacao sintetica com taxa de saque da rota, sem chamada a provedor. fee_bps e fee_fixed_cents sao taxas de simulacao; nao representam cotacao de producao.
    - `sandbox` unknown, required
    - `synthetic` unknown, required
    - `amount_cents` integer, required
    - `min_brl_cents` integer, required
    - `fee_bps` integer, required
    - `fee_fixed_cents` integer, required
    - `partner_fee_bps` integer, required
    - `asset` string, required
    - `chain` string, required
    - `usdt_amount` string, required
    - `asset_amount` string, required
    - `withdraw_fee` string, required
    - `withdraw_min` string, required
    - `brl_per_usdt` number, required
    - `brl_per_asset` number, required

## Other responses

- `400`: Valor fora dos limites da chave ou parâmetros inválidos.
- `401`: X-API-Key ausente, desconhecida ou incorreta.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)