# Consultar cobrança (/docs/cartao/endpoints/charges/get_charges__chargeId_)

## GET /charges/{chargeId}

`GET https://api.payzu.io/v1/charges/{chargeId}`

Retorna os detalhes de uma determinada cobrança

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `chargeId` | string | yes | Id da cobrança |

### Responses

**200** Requisição bem sucedida

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | no | Identificador da cobrança |
| `externalId` | string | no | Identificador único gerado externamente |
| `postbackUrl` | string | no | Url para notificações sobre o status da cobrança |
| `amount` | number | no | Valor da cobrança em centavos |
| `paymentType` | string | no | Tipo de pagamento da cobrança. Valores em [Códigos de referência](https://docs.payzu.com.br/docs/cartao/reference-codes) |
| `createdAt` | string | no | Data de criação da cobrança |
| `updatedAt` | string | no | Data da última atualização da cobrança |
| `customer` | object | no | Dados do comprador |
| `customer.id` | number | no | Identificador do comprador. |
| `customer.name` | string | no | Nome completo do comprador |
| `customer.identity` | string | no | Número do documento de identificação do comprador |
| `customer.identityType` | string | no | Tipo de documento de identificação do comprador |
| `customer.email` | string | no | E-mail do comprador |
| `customer.birthdate` | string | no | Data de nascimento do comprador |
| `customer.phone` | string | no | Número do telefone do comprador |
| `customer.address` | object | no | Endereço de cobrança |
| `customer.address.street` | string | yes | Logradouro do endereço de cobrança |
| `customer.address.number` | string | yes | Número do endereço de cobrança |
| `customer.address.complement` | string | no | Complemento do endereço de cobrança |
| `customer.address.zipCode` | string | yes | Código postal do endereço de cobrança |
| `customer.address.city` | string | yes | Cidade do endereço de cobrança |
| `customer.address.state` | string | yes | Estado do endereço de cobrança |
| `customer.address.country` | string | yes | País do endereço de cobrança |
| `customer.address.district` | string | yes | Bairro do endereço de cobrança |
| `cart` | object[] | no | Carrinho do comprador |
| `cart.name` | string | yes | Nome do produto |
| `cart.quantity` | number | yes | Quantidade do produto |
| `cart.sku` | string | yes | SKU (Stock Keeping Unit - Unidade de Controle de Estoque) do produto |
| `cart.unitPrice` | number | yes | Preço unitário do produto em centavos |
| `creditCardPayment` | object | no | Detalhes do pagamento com cartão de crédito |
| `creditCardPayment.installments` | number | no | Número de parcelas |
| `creditCardPayment.authenticate` | boolean | no | Indica se o comprador foi direcionado ao emissor para autenticação 3DS |
| `creditCardPayment.currency` | string | no | Moeda da cobrança. Lista em [Moedas suportadas](https://docs.payzu.com.br/docs/cartao/currencies) |
| `creditCardPayment.acquirerTransactionId` | string | no | Identificador da transação na adquirente |
| `creditCardPayment.authorizationCode` | string | no | Código de autorização retornado pela adquirente |
| `creditCardPayment.reasonCode` | number | no | Código do motivo do resultado. Lista em [Status e motivos da transação](https://docs.payzu.com.br/docs/cartao/transaction-status) |
| `creditCardPayment.reasonMessage` | string | no | Mensagem do motivo do resultado. Lista em [Status e motivos da transação](https://docs.payzu.com.br/docs/cartao/transaction-status) |
| `creditCardPayment.status` | integer | no | Status da transação. Lista em [Status e motivos da transação](https://docs.payzu.com.br/docs/cartao/transaction-status) |
| `creditCardPayment.returnCode` | string | no | Código de retorno da adquirente, lido na tabela de [Códigos de erro](https://docs.payzu.com.br/docs/cartao/error-codes). O mesmo número tem outro significado na tabela [ABECS](https://docs.payzu.com.br/docs/cartao/abecs-codes), que é o padrão das bandeiras para recusas. |
| `creditCardPayment.returnMessage` | string | no | Mensagem de retorno da adquirente |
| `creditCardPayment.externalAuthentication` | object | no | Dados da autenticação externa 3DS, quando enviados na criação |
| `creditCardPayment.reversedAmount` | number | no | Valor estornado em centavos, quando houver estorno |
| `creditCardPayment.reversedDate` | string | no | Data do estorno, quando houver |
| `creditCardPayment.chargeId` | string | no | Identificador da cobrança |
| `creditCardPayment.card` | object | no | Detalhes do cartão utilizado na cobrança |
| `creditCardPayment.card.id` | number | no | Identificador do cartão. |
| `creditCardPayment.card.number` | string | no | Número do cartão de crédito |
| `creditCardPayment.card.holder` | string | no | Nome do portador impresso no cartão de crédito |
| `creditCardPayment.card.expiration` | string | no | Data de validade do cartão de crédito |
| `creditCardPayment.card.brand` | string | no | Bandeira do cartão. Valores em [Códigos de referência](https://docs.payzu.com.br/docs/cartao/reference-codes) — `Visa`, `Master`, `Elo`, `Diners`, `Hipercard` |
| `creditCardPayment.chargebacks` | object[] | no | Chargebacks vinculados à cobrança |
| `creditCardPayment.chargebacks.id` | number | no | Identificador do chargeback |
| `creditCardPayment.chargebacks.number` | string | no | Número do chargeback junto à adquirente |
| `creditCardPayment.chargebacks.amount` | number | no | Valor do chargeback em centavos |
| `creditCardPayment.chargebacks.status` | string | no | Status do chargeback. Lista em [Status e motivos da transação](https://docs.payzu.com.br/docs/cartao/transaction-status) — `RECEIVED`, `ACCEPTED`, `DEFENDED` |
| `creditCardPayment.chargebacks.reasonCode` | string | no | Código do motivo informado pela bandeira |
| `creditCardPayment.chargebacks.reasonDescription` | string | no | Descrição do motivo informado pela bandeira |
| `creditCardPayment.chargebacks.issuedAt` | string | no | Data de emissão do chargeback |
| `creditCardPayment.chargebacks.createdAt` | string | no | Data de criação do registro |
| `creditCardPayment.chargebacks.updatedAt` | string | no | Data da última atualização do registro |
| `recurrence` | object | no | Estado de uma recorrência |
| `recurrence.recurrentPaymentId` | string | no | Identificador da recorrência. Use nos endpoints de consulta e gestão de recorrências |
| `recurrence.interval` | string | no | Intervalo configurado — `MONTHLY`, `ANNUAL` |
| `recurrence.status` | string | no | Status da recorrência. Valores em [Pagamentos recorrentes](https://docs.payzu.com.br/docs/cartao/recurrence) — `ACTIVE`, `INACTIVE`, `ENDED` |
| `recurrence.amount` | number | no | Valor de cada ciclo, em centavos |
| `recurrence.nextRecurrency` | string | no | Data da próxima cobrança automática |
| `recurrence.endDate` | string | no | Data final, se informada na criação |
| `recurrenceCycle` | integer | no | Número do ciclo da recorrência a que esta cobrança pertence: 0 é a cobrança inicial, 1..n são os ciclos gerados automaticamente. Presente apenas em cobranças de recorrência |