---
title: "Efetua uma nova tentativa em uma cobrança existente."
method: POST
path: "/v1/charges/{id}/charge"
tags: ["charges"]
---

# Efetua uma nova tentativa em uma cobrança existente.

`POST /v1/charges/{id}/charge`

A plataforma Vindi efetua retentativas automáticas de cobranças no intervalo configurado em cada método de pagamento. Você pode consultar a data da próxima tentativa no atributo `next_attempt` de cada cobrança. Ainda assim poderão haver casos onde seja necessário efetuar uma tentativa extraordinária, com ou sem um novo perfil de pagamento. Apenas cobranças no cartão de crédito e débito em conta poderão sofrer retentativas através deste método.

#### Retentativa com o perfil existente

Se desejar realizar uma retentativa com o perfil de pagamento atual do cliente, efetue o `POST` sem enviar qualquer informação adicional no corpo da requisição e especifique apenas o ID da cobrança existente.

#### Retentativa com novo perfil de pagamento

Caso seja possível obter os novos dados de pagamento, use este método para cadastrar o novo perfil de pagamento e efetuar a retentativa da cobrança, tudo em uma única requisição. Envie os dados do perfil de pagamento no corpo da requisição, seguindo os parâmetros descritos abaixo. O cadastro do perfil de pagamento também pode ser realizado através do método `POST /payment_profiles`.

#### Cuidados
As tentativas automáticas da Vindi são calculadas pensando na proteção do seu contrato de adquirência e na proteção do cartão de crédito ou da conta corrente do seu cliente. Efetuar retentativas desnecessárias repetidamente pode acabar bloqueando o cartão de crédito do seu cliente ou comprometendo a integração com seu banco ou adquirente.

Use este método exclusivamente para efetuar retentativas manuais em seu backend ou oferecer ao cliente uma tela para atualização das informações de pagamento. Nunca automatize os envio de retentativas.

## Path parameters

- `id` integer, required

## Request body

- PostV1ChargesIdCharge — Efetua uma nova tentativa em uma cobrança existente.
  - `body` string — JSON opcional com atributos do novo perfil de pagamento. Se não informado, o perfil de pagamento padrão será utilizado
  - `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` string — Número completo do cartão de crédito
  - `card_cvv` string — Código de segurança do cartão de crédito com 3 ou 4 dígitos
  - `payment_method_code` string — Código do método de pagamento
  - `payment_company_code` string — Código do banco ou bandeira
  - `gateway_token` string — Token externo

## Response `201`

Tentativa efetuada.

- 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/revisions/9d11e5de9308/schema)