# 列出收款 (/zh/docs/conta-digital/endpoints/charges/get_payments)

## GET /transactions/payment

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

Scope: `PAYMENT_READ`. Returns the account charges, newest first, cursor paginated.

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `limit` | integer | no | Items per page, 1 to 100. — minimum: 1; maximum: 100; default: 20 |
| `cursor` | string | no | `nextCursor` from the previous page. |
| `method` | string | no | Payment method. — `PIX` |
| `status` | string | no | Charge status. — `PENDING`, `PAID`, `REFUNDED`, `EXPIRED` |
| `dateFrom` | string | no | Start of the period, by creation date. ISO 8601 or `YYYY-MM-DD`; a date without a time covers the whole day in Brasília time. |
| `dateTo` | string | no | End of the period, by creation date. ISO 8601 or `YYYY-MM-DD`; a date without a time covers the whole day in Brasília time. |
| `search` | string | no | Id, name or document of the customer informed on creation. 3 to 120 characters. — minLength: 3; maxLength: 120 |
| `externalRef` | string | no | Your reference, exact match. — minLength: 1; maxLength: 64 |

### Responses

**200** Page of charges.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object[] | yes | Account charges, newest first. |
| `data.id` | string | yes | Charge identifier. |
| `data.method` | string | yes | Payment method. — `PIX` |
| `data.status` | string | yes | Charge status. — `PENDING`, `PAID`, `REFUNDED`, `EXPIRED` |
| `data.amount` | integer | yes | Amount charged. In cents. |
| `data.netAmount` | integer | yes | What is credited to the account, net of the fee. In cents. |
| `data.refundedAmount` | integer | yes | How much has been returned to the payer, completed refunds only. In cents. |
| `data.refundInProgressAmount` | integer | yes | Refund still being processed. In cents. |
| `data.description` | string | null | yes | Text shown to the payer. |
| `data.payerName` | string | null | yes | Payer name informed on creation. |
| `data.payerDocument` | string | null | yes | Payer document informed on creation, digits only. |
| `data.createdAt` | string | yes | Date and time in ISO 8601, UTC. — format: date-time |
| `data.paidAt` | string | null | yes | When it was paid. `null` until paid. — format: date-time |
| `nextCursor` | string | no | Cursor for the next page. Absent on the last page. |

**400** Invalid request.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |

**401** Missing, invalid or expired credential.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |

**403** Not allowed: scope, IP or disabled operation.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Description in Portuguese, ready to display. It may change at any time. |
| `code` | string | yes | Stable error code. Your system decides what to do based on it. |
| `details` | object | no | Structured error context, when available. |