---
title: "Insere uma nova transação manual."
method: POST
path: "/v1/transactions"
tags: ["transactions"]
---

# Insere uma nova transação manual.

`POST /v1/transactions`

Este método deve ser utilizado apenas para efetuar a baixa manual de cobranças pagas através de métodos que não são controlados pela plataforma Vindi, como por exemplo, dinheiro em espécie ou depósito em conta.

Quando você utiliza a criação manual de transações, a plataforma Vindi considera que o valor em questão foi de fato **recebido**. Por este motivo, não use este método para conceder descontos, créditos ou abonos.

#### Cálculo de multa e juros

Caso a configuração do método de pagamento original da cobrança contenha multa e juros, tenha cuidado redobrado ao informar a data de pagamento correta através do atributo `paid_at`.

## Request body

- PostV1Transactions — Insere uma nova transação manual.
  - `body` string — JSON com atributos da nova transação.
  - `charge_id` integer, required — ID da cobrança pendente
  - `amount` number, required — Valor da transação
  - `payment_method_code` string, required — Código do método de pagamento
  - `paid_at` string — Data opcional do pagamento da cobrança no formato ISO 8601. Se não informada, a data atual será utilizada
  - `comments` string — Descrição opcional

## Response `201`

Transação manual criada com sucesso.

- Transaction — Este método permite verificar se um perfil de pagamento existente é válido na entidade emissora. Apenas o método de pagamento cartão de crédito suporta esta operação. Utilize esta função para validar um perfil de pagamento antes da criação de uma assinatura que não possua cobrança imediata. Este método é desnecessário para assinaturas com cobrança imediata. #### Funcionamento Preferencialmente a plataforma Vindi irá executar o método de validação fornecido nativamente pelas adquirentes. Caso este método não esteja disponível, a plataforma poderá realizar uma autorização seguida de um cancelamento. #### Resultado Para verificar o resultado da validação, verifique no retorno se `status=success`. #### Disponibilidade Esta funcionalidade estará disponível para testes enquanto sua conta Vindi estiver no modo trial. Para habilitar no modo produção, instale a extensão "Transação de verificação" acessando ***Configurações > Extensões & Integrações*** no painel de administração da plataforma. Taxas adicionais por verificação poderão ser cobradas.
  - `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
  - `fallback_type` string, required — Tipo de Retentativa
  - `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
  - `updated_at` string, required — Data e hora da última atualização 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
  - `charge` ChargeSummary, required
    - `id` integer, required — ID da cobrança
  - `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
  - `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

## Other responses

- `400` — Erro de sintaxe JSON no corpo do request.
- `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)