Withdraw BRL balance as crypto to a self-custodial wallet

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.

Network (aliases accepted: sol, trc20, erc20, bep20, arbitrum, base…).

Asset code in lowercase (usdt, usdc, btc, eth, sol…), as listed by GET /cashin/catalog.

Destination wallet, validated for the network.

CPF (11 digits) or CNPJ (14) of the customer who owns the balance.

Sub-account to debit. Omit for the key's main balance.

Identificador idempotente de até 64 caracteres. Mantenha o mesmo identificador e todos os parâmetros nos retries. A comparação de divergência varia por rota; não use o replay para alterar uma operação. 409 external_id_divergente sinaliza conflito detectado.

Memo/tag do destino. OBRIGATORIO nas redes coletivas — XRP, XLM, TON, ATOM, HBAR, ALGO, EOS, KAVA, LUNA — onde a carteira de destino e compartilhada e o memo e quem identifica o dono. Sem ele a API responde 400 memo_obrigatorio antes de criar qualquer cobranca. Em XRP e a destination tag: inteiro de 0 a 4294967295. Aliases aceitos: memo, tag, destination_tag. O catalogo marca essas rotas com memoRequired: true.

Limite opcional do débito BRL (valor + taxa da casa). Excesso retorna 409 taxa_alterada. Não trava câmbio nem quantidade de tokens.

Only for a sandbox key. GET /sandbox provides the scenario matrix by flow. Omit in production. All prices, payments and withdrawals remain fictitious.

Identificador da cobrança (ci_…).

Estado do PIX. paid não comprova sozinho crédito/entrega; leia settlement_status.

Valor do PIX em centavos.

cripto (entrega on-chain) ou saldo (credita a custódia BRL da chave, usável em POST /payouts e POST /saldo/sacar-cripto).

Fonte do valor na criação: PIX ou saque do saldo.

Sua referência do cliente final (subconta no saldo).

Carteira que recebe a cripto (destino=cripto).

Memo/tag da carteira de destino em redes coletivas (destino=cripto).

Rede de entrega (id de GET /cashin/catalog).

Ativo entregue (usdt, usdc, btc, …).

Taxa percentual congelada na cobrança, em bps.

Parcela fixa congelada na cobrança, em centavos.

Subfee exclusiva do depósito Pix em saldo BRL, em basis points (100 = 1%). Padrão 0, máximo 1000. Aplicada ao valor recebido após a taxa fixa Lunium, descontada antes do crédito no saldo. Independente de compra, venda e saque. Congelada na criação; comissão creditada somente após liberação e crédito concluído (paid/sent). Para compra direta, este campo congela partner_fee_bps.

PIX copia e cola na criação; null no saque custodial.

Imagem do QR (PNG) — só na resposta da criação.

Identificador idempotente de até 64 caracteres. Mantenha o mesmo identificador e todos os parâmetros nos retries. A comparação de divergência varia por rota; não use o replay para alterar uma operação. 409 external_id_divergente sinaliza conflito detectado.

Validade da própria cobrança; leia este timestamp, inclusive para validade estendida pelo bot.

Instante de liberação informado para retenção do provedor, quando disponível.

Quando o crédito no saldo sai da carência. null quando já entra disponível (padrão desde 16/09/2026).

Retenção local da cobrança em horas. Não é alias de held_hours nem da carência geral do saldo.

Retenção solicitada ao provedor. Pode ser zero enquanto existe retenção local (hold_hours/liberar_em).

true quando held_hours > 0. Isoladamente não revela retenção local.

True for fictitious sandbox operations.

Só em chain="liquid": como o DePix foi entregue. Ausente nas outras redes.

Só em chain="liquid" com delivery_mode="split": quanto o destinatário recebe em DePix, já sem a taxa. É este valor que a Lunium envia on-chain.

Só em chain="liquid" com delivery_mode="split": tudo que saiu do bruto (taxa fixa + percentual). net_cents + fee_total_cents == amount_cents.

Parte da taxa em centavos para depósito Pix em saldo BRL; calculada com os valores congelados da cobrança.

Sub fee do parceiro debitada do saldo por cima da taxa da Lunium (24/09/2026).

Estado do crédito/entrega: sent concluiu; incerto exige conciliação. PIX pago e entrega são estados distintos.

Hash on-chain da entrega (ou id interno quando a entrega é pela corretora).

Taxa da Lunium debitada do saldo.

amount_cents + fee_cents + partner_fee_cents.