# Listar cobranças (/docs/conta-digital/endpoints/charges/get_payments)

## GET /transactions/payment

`GET https://api.hub.payzu.com.br/api/v1/transactions/payment`

Escopo: `PAYMENT_READ`. Devolve as cobranças da conta, da mais recente para a mais antiga, paginadas por cursor.

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `limit` | integer | no | Itens por página, de 1 a 100. — minimum: 1; maximum: 100; default: 20 |
| `cursor` | string | no | `nextCursor` da página anterior. |
| `method` | string | no | Meio de pagamento. — `PIX` |
| `status` | string | no | Estado da cobrança. — `PENDING`, `PAID`, `REFUNDED`, `EXPIRED` |
| `dateFrom` | string | no | Início do período, pela data de criação. ISO 8601 ou `AAAA-MM-DD`; data sem hora vale o dia inteiro no horário de Brasília. |
| `dateTo` | string | no | Fim do período, pela data de criação. ISO 8601 ou `AAAA-MM-DD`; data sem hora vale o dia inteiro no horário de Brasília. |
| `search` | string | no | Id, nome ou documento do cliente informado na criação. De 3 a 120 caracteres. — minLength: 3; maxLength: 120 |
| `externalRef` | string | no | Sua referência, exata. — minLength: 1; maxLength: 64 |

### Responses

**200** Página de cobranças.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object[] | yes | Cobranças da conta, da mais recente para a mais antiga. |
| `data.id` | string | yes | Identificador da cobrança. |
| `data.method` | string | yes | Meio de pagamento. — `PIX` |
| `data.status` | string | yes | Estado da cobrança. — `PENDING`, `PAID`, `REFUNDED`, `EXPIRED` |
| `data.amount` | integer | yes | Valor cobrado. Em centavos. |
| `data.netAmount` | integer | yes | O que é creditado na conta, já sem a tarifa. Em centavos. |
| `data.refundedAmount` | integer | yes | Quanto já voltou ao pagador, só estornos concluídos. Em centavos. |
| `data.refundInProgressAmount` | integer | yes | Estorno ainda sendo processado. Em centavos. |
| `data.description` | string | null | yes | Texto exibido para quem paga. |
| `data.payerName` | string | null | yes | Nome do pagador informado na criação. |
| `data.payerDocument` | string | null | yes | Documento do pagador informado na criação, só dígitos. |
| `data.createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `data.paidAt` | string | null | yes | Quando foi paga. `null` até pagar. — format: date-time |
| `nextCursor` | string | no | Cursor da próxima página. Ausente na última página. |

**400** Requisição inválida.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |