---
title: "Sacar a comissão em cripto"
method: POST
path: "/comissao/sacar"
tags: ["Comissão (sub fee)"]
---

# Sacar a comissão em cripto

`POST /comissao/sacar`

## Request

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

Saque MANUAL da comissão, em cripto, na rede e moeda que você escolher (qualquer rota viva de GET /cashin/catalog). Sem taxa: a sub fee já foi paga pelo usuário final na própria operação. Mínimo US$ 10 pela cotação do momento (veja `min_saque_cents` em GET /comissao). Uma vez a cada 24 h (janela corrida). A entrega é a mesma do cash-in: acompanhe pelo `saque.cashin_id` em GET /cashin/{cashin_id}/status ou pelo webhook cashin.settled.

## Request body

- object
  - `amount_cents` integer, required: Valor em centavos de REAL a converter (≥ min_saque_cents).
  - `asset` string: usdt | usdc (Polygon) ou um ativo de GET /cashin/catalog.
  - `chain` string
  - `payout_address` string, required: Sua carteira na rede escolhida.
  - `payout_tag` string: memo/tag nas redes que exigem.
  - `external_id` string: 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.

## Response `200`

Saque criado e em entrega

- object
  - `saque` Cobranca: Resposta de criação da cobrança, com QR. Para status/lista/webhook veja StatusCobranca.
    - `cashin_id` string: Identificador da cobrança (ci_…).
    - `status` 'pending' | 'delayed' | 'under_review' | 'paid' | 'expired' | 'refunded' | 'failed': Estado do PIX. paid não comprova sozinho crédito/entrega; leia settlement_status.
    - `amount_cents` integer: Valor do PIX em centavos.
    - `destino` 'cripto' | 'saldo': cripto (entrega on-chain) ou saldo (credita a custódia BRL da chave, usável em POST /payouts e POST /saldo/sacar-cripto).
    - `fonte` 'pix' | 'saldo': Fonte do valor na criação: PIX ou saque do saldo.
    - `customer_ref` string, nullable: Sua referência do cliente final (subconta no saldo).
    - `payout_address` string, nullable: Carteira que recebe a cripto (destino=cripto).
    - `payout_tag` string, nullable: Memo/tag da carteira de destino em redes coletivas (destino=cripto).
    - `chain` string: Rede de entrega (id de GET /cashin/catalog).
    - `asset` string: Ativo entregue (usdt, usdc, btc, …).
    - `lunium_fee_bps` integer: Taxa percentual congelada na cobrança, em bps.
    - `lunium_fee_fixed_cents` integer: Parcela fixa congelada na cobrança, em centavos.
    - `partner_fee_bps` integer: 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.
    - `qr_copypaste` string, nullable: PIX copia e cola na criação; null no saque custodial.
    - `qr_image_url` string, nullable: Imagem do QR (PNG) — só na resposta da criação.
    - `external_id` string, nullable: 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.
    - `created_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable: Validade da própria cobrança; leia este timestamp, inclusive para validade estendida pelo bot.
    - `delay_until` string, date-time, nullable: Instante de liberação informado para retenção do provedor, quando disponível.
    - `liberar_em` string, date-time, nullable: Quando o crédito no saldo sai da carência. null quando já entra disponível (padrão desde 16/09/2026).
    - `hold_hours` integer: Retenção local da cobrança em horas. Não é alias de held_hours nem da carência geral do saldo.
    - `held_hours` integer: Retenção solicitada ao provedor. Pode ser zero enquanto existe retenção local (hold_hours/liberar_em).
    - `held` boolean: true quando held_hours > 0. Isoladamente não revela retenção local.
    - `sandbox` boolean: True for fictitious sandbox operations.
    - `simulation` object
    - `sandbox_payment` object
      - `method` 'POST'
      - `path` string
    - `timeline` object[]
    - `delivery_mode` 'full' | 'split': Só em chain="liquid": como o DePix foi entregue. Ausente nas outras redes.
    - `net_cents` integer: 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.
    - `fee_total_cents` integer: Só em chain="liquid" com delivery_mode="split": tudo que saiu do bruto (taxa fixa + percentual). net_cents + fee_total_cents == amount_cents.
    - `lunium_fee_cents` integer: Parte da taxa em centavos para depósito Pix em saldo BRL; calculada com os valores congelados da cobrança.
    - `partner_fee_cents` integer: Parte da taxa em centavos para depósito Pix em saldo BRL; calculada com os valores congelados da cobrança.
  - `comissao` Comissao
    - `disponivel_cents` integer, required
    - `creditado_cents` integer, required
    - `estornado_cents` integer
    - `sacado_cents` integer, required
    - `operacoes` integer, required
    - `ultimo_credito_em` string, date-time, nullable
    - `moeda` string, required
    - `sandbox` boolean, required
    - `min_saque_cents` integer, nullable: US$ 10 convertidos pela cotação de AGORA. null = sem cotação no momento (o saque recusa).
    - `pode_sacar_agora` boolean, required
    - `ultimo_saque_em` string, date-time, nullable
    - `proximo_saque_em` string, date-time, nullable
    - `politica` object, required
      - `partner_deposito_fee_bps` integer: 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).

## Other responses

- `400`: valor_invalido | valor_abaixo_do_minimo (traz min_saque_cents) | rede_indisponivel | asset_invalido | payout_address_invalido | sandbox_sem_saque
- `402`: saldo_insuficiente — comissão disponível menor que o pedido
- `409`: external_id_divergente
- `429`: saque_comissao_diario — traz proximo_saque_em
- `503`: provedor_indisponivel — sem cotação para aferir o mínimo

## Changes

- **2026-10-19** `fc06c3b824b1`: 3 info
  - added the optional property `comissao/politica/partner_deposito_fee_bps` to the response with the `200` status
  - added the optional property `saque/lunium_fee_cents` to the response with the `200` status
  - added the optional property `saque/partner_fee_cents` to the response with the `200` status

[Operation history](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/changes/comissao/sacar/post.md)

---

[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)