---
title: "Listar pagamentos"
method: GET
path: "/carteira-usdt/payments"
tags: ["Carteira USDT"]
---

# Listar pagamentos

`GET /carteira-usdt/payments`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/carteira-usdt/payments`
- Auth: API key in header `X-API-Key`

Os 100 mais recentes. Os concluídos trazem E2E, nome, CPF parcial e o link do comprovante.

## Response `200`

OK

- object
  - `items` PagamentoCarteira[]
    - `payment_id` string
    - `external_id` string, nullable
    - `status` 'reservado' | 'ordem_criada' | 'aceita' | 'sacando' | 'enviado' | 'revisao' | 'concluido' | 'falhou' | 'falhou_apos_envio': Finais: `concluido` (Pix pago), `falhou` (não executado; a reserva voltou ao saldo), `falhou_apos_envio` (em apuração; a reserva NÃO volta sozinha). `revisao`: em conferência — não é falha, acompanhe. Os demais são etapas em andamento.
    - `final` boolean: true quando o estado não muda mais.
    - `payment_method` 'pix_key' | 'br_code'
    - `brl_amount` string
    - `pix_key` string, nullable: Mascarada.
    - `usdt_reserved` string
    - `usdt_debited` string, nullable
    - `usdt_order` string, nullable
    - `withdrawal_fee` string, nullable
    - `cashout_id` string, nullable: A ordem que pagou o Pix (GET /cash-outs/{cashout_id} tem o detalhe).
    - `error` string, nullable
    - `pix_e2e` string: Só em `concluido`: o identificador E2E do Pix.
    - `recipient_name` string: Só em `concluido`: nome de quem recebeu.
    - `recipient_document` string, nullable: Só em `concluido`: CPF parcial (padrão do Banco Central) ou CNPJ.
    - `receipt_url` string, nullable: Só em `concluido`: link público do comprovante oficial (null no teste).
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `sandbox` boolean

## Other responses

- `401`: Chave ausente ou inválida.
- `403`: `carteira_nao_liberada`: a carteira não está liberada para este projeto.
- `503`: `carteira_indisponivel` / `pagamentos_indisponiveis`: tente de novo em instantes (`acao: esperar`).

---

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