# Consultar depósito (/docs/conta-digital/endpoints/deposits/get_deposit)

## GET /transactions/deposit/{depositId}

`GET https://api.hub.payzu.com.br/api/v1/transactions/deposit/{depositId}`

Escopo: `DEPOSIT_READ`. Devolve um depósito, que é um Pix recebido numa chave da conta sem cobrança. Use o `depositId` do webhook `DEPOSIT_RECEIVED`.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `depositId` | string | yes | Identificador do depósito. |

### Responses

**200** Depósito.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Identificador do depósito. |
| `method` | string | yes | Sempre `PIX`. — `PIX` |
| `amount` | integer | yes | Valor que o pagador mandou. Em centavos. |
| `serviceFee` | integer | yes | Tarifa do recebimento. Em centavos. |
| `netAmount` | integer | yes | `amount − serviceFee`: o que foi creditado. Em centavos. |
| `e2e` | string | yes | End-to-end do Pix recebido. |
| `receiverPixKey` | string | null | yes | Chave da sua conta que recebeu. |
| `payer` | object | yes | Quem pagou, como o banco informou. |
| `payer.name` | string | null | yes | Nome de quem pagou. |
| `payer.document` | string | null | yes | CPF mascarado ou CNPJ formatado. |
| `payer.bankIspb` | string | null | yes | ISPB da instituição de quem pagou. |
| `payer.bankName` | string | null | yes | Instituição de quem pagou. |
| `paidAt` | string | yes | Quando o Pix caiu. — format: date-time |
| `createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `refundedAmount` | integer | yes | Quanto já foi devolvido, só devoluções concluídas. Em centavos. |
| `refundInProgressAmount` | integer | yes | Devolução ainda sendo processada. Em centavos. |
| `refundableAmount` | integer | yes | Quanto ainda pode ser devolvido. `0` enquanto uma devolução ainda está sendo processada ou há contestação aberta. Em centavos. |
| `openInfractionProtocol` | string | null | yes | Protocolo da contestação MED aberta sobre o depósito. `null` quando não há. |
| `refunds` | object[] | yes | Devoluções do depósito, da mais recente para a mais antiga. |
| `refunds.id` | string | yes | Identificador do estorno. É o `refundId` dos webhooks `REFUND_COMPLETED` e `REFUND_FAILED`. |
| `refunds.status` | string | yes | `RESERVED`: o valor saiu do saldo disponível. `SENT`: enviado ao banco. `SETTLED`: devolvido ao pagador. `RELEASED`: recusado, com o valor de volta ao saldo. — `RESERVED`, `SENT`, `SETTLED`, `RELEASED` |
| `refunds.amount` | integer | yes | Valor devolvido ao pagador. Em centavos. |
| `refunds.serviceFee` | integer | yes | Tarifa do estorno. Em centavos. |
| `refunds.totalDebited` | integer | yes | `amount + serviceFee`: o que sai da conta. Em centavos. |
| `refunds.endToEndId` | string | null | yes | End-to-end do Pix de devolução. `null` até concluir. |
| `refunds.rejectedReason` | string | null | yes | Mensagem pronta para exibir, preenchida quando o banco recusou o estorno. |
| `refunds.requestedAt` | string | yes | Quando o estorno foi pedido. ISO 8601, UTC. — format: date-time |
| `refunds.settledAt` | string | null | yes | Quando o estorno foi concluído. `null` até concluir. — format: date-time |
| `refunds.releasedAt` | string | null | yes | Quando o valor voltou ao saldo, após recusa. `null` se não houve recusa. — format: date-time |

**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. |

**404** Não encontrado, ou de outra conta.

| 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. |