---
title: "Retorna uma cobrança específica através do ID."
method: GET
path: "/v1/charges/{id}"
tags: ["charges"]
---

# Retorna uma cobrança específica através do ID.

`GET /v1/charges/{id}`

Cobranças representam o valor cobrado do cliente, o método de pagamento utilizado e o número de tentativas restantes.

#### Impressão de boleto
Utilize o atributo `print_url` para visualizar a url do boleto bancário.

É possível definir a data de visualização do boleto informando o parâmetro `seen_at` via query string, seguindo o formato ISO 8601. Por exemplo `seen_at=2017-06-30`. Esta opção permite antecipar a impressão de uma cobrança usando uma data no futuro, pré-calculando a multa e os juros caso seja necessário.

## Path parameters

- `id` integer, required

## Response `200`

Ok. Cobrança encontrada.

- Charge — Utilize este método para listar as cobranças associadas à sua conta na Vindi. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150). #### Atributos para busca <code>id</code>, <code>customer_id</code>, <code>bill_id</code>, <code>amount</code>, <code>payment_method_id</code>, <code>due_at</code>, <code>paid_at</code>, <code>installments</code>, <code>attempt_count</code>, <code>next_attempt</code>, <code>status</code>, <code>created_at</code> e <code>updated_at</code>.
  - `id` integer, required — ID da cobrança
  - `amount` number, required — Valor da cobrança
  - `status` 'pending' | 'paid' | 'canceled' | 'processing' | 'fraud_review', required — Status da cobrança
  - `due_at` string, required — Data do vencimento da cobrança
  - `paid_at` string — Data do pagamento da cobrança, apenas se a cobrança já foi paga
  - `installments` integer, required — Número de parcelas da cobrança. Valores acima de 1 são usados apenas para parcelamento através da administradora do cartão de crédito
  - `attempt_count` integer — Número de tentativas automáticas de cobrança já realizadas
  - `next_attempt` integer — Data da próxima tentativa automática de cobrança
  - `print_url` string — URL para impressão da cobrança. Usado apenas para boletos
  - `created_at` string, required — Data e hora da geração da cobrança
  - `updated_at` string, required — Data e hora da última atualização da cobrança
  - `last_transaction` TransactionSummary, required
    - `id` integer, required — ID da transação
    - `transaction_type` 'charge' | 'refund' | 'authorization' | 'capture' | 'verify' | 'register' | 'void' | 'renew_payment_profile' | 'pre_authorization' | 'update', required — Tipo da transação
    - `status` 'processing' | 'success' | 'rejected' | 'failure' | 'timeout' | 'waiting' | 'canceled' | 'fraud_review', required — Status da transação
    - `amount` number, required — Valor da transação
    - `installments` integer, required — Número de parcelas
    - `gateway_message` string, required — Mensagem de resposta do gateway
    - `gateway_response_code` string, required — Código de resposta do gateway
    - `gateway_authorization` string, required — Código da autorização usado no estorno ou captura. Varia de acordo com o adquirente
    - `gateway_transaction_id` string, required — Código externo de referência do gateway. Para boletos, representa o "nosso número"
    - `gateway_response_fields` string — Atributos de resposta específicos do gateway
    - `fraud_detector_score` number — Pontuação da análise antifraude entre 0.00 e 1.00. Quanto maior a pontuação, maior o risco de fraude
    - `fraud_detector_status` 'automatic_success' | 'manual_success' | 'automatic_rejected' | 'manual_rejected' | 'review' | 'failure' — Status da análise antifraude
    - `fraud_detector_id` string — ID da análise antifraude
    - `created_at` string, required — Data e hora da transação
    - `gateway` GatewaySummary, required
      - `id` integer, required — ID do gateway
      - `connector` string, required — Conector utilizado no gateway
    - `payment_profile` PaymentProfileSummary, required
      - `id` integer, required — ID do perfil de pagamento
      - `holder_name` string — Nome do titular/portador do perfil de pagamento
      - `registry_code` string — CPF ou CNPJ do titular/portador
      - `bank_branch` string — Agência da conta bancária
      - `bank_account` string — Número da conta bancária
      - `card_expiration` string — Validade do cartão de crédito no formato MM/AA
      - `allow_as_fallback` string — Permite utilizar o perfil de pagamento em retentativas de cobranças não pagas.
      - `card_number_first_six` string — Primeiros 6 dígitos do cartão de crédito (BIN/IIN)
      - `card_number_last_four` string — Últimos 4 dígitos do cartão de crédito
      - `renewed_card` object
        - `card_number_last_four` string — Últimos quatro dígitos do cartão de crédito renovado
        - `card_expiration` string — Nova validade do cartão de crédito renovado
      - `card_renewed_at` string — Data da renovação do cartão de crédito renovado
      - `token` string, required — Token interno para referência do perfil de pagamento
      - `created_at` string, required — Data e hora do cadastro do perfil de pagamento
      - `payment_company` PaymentCompany, required
        - `id` integer, required — ID da bandeira ou banco
        - `name` string, required — Nome da bandeira ou banco
        - `code` string, required — Código para referência via API
  - `payment_method` PaymentMethodSummary, required
    - `id` integer, required — ID do método de pagamento
    - `public_name` string, required — Nome público do método de pagamento
    - `name` string, required — Nome interno do método de pagamento
    - `code` string, required — Código externo para referência via API
    - `type` string, required — Tipo do método de pagamento
  - `bill` BillSummary, required
    - `id` integer, required — ID da fatura
    - `code` string — Código externo para referência via API
  - `customer` CustomerSummary, required
    - `id` integer, required — ID do cliente
    - `name` string, required — Nome do cliente
    - `email` string — E-mail do cliente
    - `code` string — Código opcional para referência via API

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `404` — Recurso não encontrado: Cobrança
- `422` — Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost.md) · [All operations](https://skmtc.net/vindi/apis/001-vindi-pagamentos-agost/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vindi/001-vindi-pagamentos-agost/versions/9d11e5de9308/schema)