---
title: "Lista/recupera cobrancas de cash-in desta chave"
method: GET
path: "/cashin/charges"
---

# Lista/recupera cobrancas de cash-in desta chave

`GET /cashin/charges`

## Request

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

## Query parameters

- `external_id` string
- `status` string
- `start` string, date-time
- `end` string, date-time
- `limit` integer

## Response `200`

Lista (mais recentes primeiro).

- object
  - `charges` Cobranca[]
    - `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.

## Other responses

- `401`: X-API-Key ausente/invalida.
- `403`: Listagem exige X-API-Key (nao publico).

## Changes

- **2026-10-19** `fc06c3b824b1`: 2 info
  - added the optional property `charges/items/lunium_fee_cents` to the response with the `200` status
  - added the optional property `charges/items/partner_fee_cents` to the response with the `200` status

[Operation history](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/changes/cashin/charges/get.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)