---
title: 6.1. Recebimento de Liquidações Bancárias
url: https://docs.vehub.com.br/API/VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/6.%20Liquida%C3%A7%C3%B5es/v1/6.1.%20Envio%20dos%20cr%C3%A9ditos%20em%20conta/
---
# 6.1. Recebimento de Liquidações Bancárias

## 🔗 Endpoint

| Método                                          | URL |
|-------------------------------------------------|-----|
| ![POST](https://img.shields.io/badge/POST-blue) | `/public/api/v1/cartao/liquidacoes` |

---

## 🧾 Descrição

Recebe as informações de liquidações realizadas pelas credenciadoras (ex: via PIX) para os estabelecimentos comerciais. As liquidações são utilizadas para conciliação automática com as URs previamente constituídas nos contratos da plataforma.

Como as credenciadoras fazem a transferência no valor exato de cada UR por contrato e data, isso permite uma conciliação simplificada e automatizada.

> ⚠️ **O resultado da conciliação será informado exclusivamente via WebHook**.

---

## 📤 Requisição

### 📋 Payload (JSON)
```json
{
  "idOperacao": 0,
  "contaBancaria": {
    "banco": 0,
    "agencia": "0000",
    "conta": "000000"
  },
  "liquidacoes": [
    {
      "data": "2025-09-10",
      "cnpj": "12345678000199",
      "credenciadora": "11111111000191",
      "arranjo": "VCC",
      "valor": 1500.00,
      "identificadorMovimentacao": "1B428B23-C0A8-46D5-AF2C-1AFFAFAAC653",
      "nomeOriginador": "Vertrau Tecnologia"
    }
  ]
}
```

| Campo          | Tipo   | Obrigatório | Descrição                                                                                   |
|----------------|--------|-------------|---------------------------------------------------------------------------------------------|
| idOperacao     | number | Sim         | ID da Operação, valor fixo a ser informado pelo time de implantação.                        |
| contaBancaria  | object | Sim         | Conta bancária atrelada a movimentação de liquidação                                        |
| → banco        | number | Sim         | Nr do banco da conta bancária                                                               |
| → agencia      | string | Sim         | Agência da conta bancária                                                                   |
| → conta        | string | Sim         | Número da conta bancária                                                                    |
| → liquidacoes  | list   | Sim         | abc                                                                                         |
| → data         | string | Sim         | Data em que o valor foi creditado (YYYY-MM-DD)                                              |
| → cnpj         | string | Sim         | CNPJ do estabelecimento comercial (sem formatação)                                          |
| → credenciadora | string | Sim         | CNPJ da credenciadora                                                                       |
| → arranjo      | string | Sim         | Sigla do arranjo (ex: MCC, VCC)                                                             |
| → valor          | number | Sim         | Valor exato creditado na conta do EC                                                        |
| → identificadorMovimentacao          | string | Não         | Identificador da movimentação no sistema de origem, servirá para notificação de conciliação |
| → nomeOriginador          | string | Não         | Nome do estabelecimento comercial originário da UR |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST https://api.veflow.com/public/api/v1/cartao/liquidacoes \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
      "idOperacao": 1,
      "contaBancaria": {
        "banco": 1,
        "agencia": "1111",
        "conta": "1111111"
      },
      "liquidacoes": [
        {
          "data": "2025-09-10",
          "cnpj": "12345678000199",
          "credenciadora": "11111111000191",
          "arranjo": "VCC",
          "valor": 1500.00,
          "identificadorMovimentacao": "1B428B23-C0A8-46D5-AF2C-1AFFAFAAC653",
          "nomeOriginador": "Vertrau Tecnologia"
        }
      ]
    }'
```

---

## 📥 Response

### ✅ 200 OK
```json
{
  "identificador": "86A12031-E774-4D90-A065-8E078DAB8AB2",
  "mensagem": "Liquidações recebidas para conciliação!"
}
```

Indica que as informações foram aceitas e serão processadas pelo motor de conciliação interna da plataforma.

---

## 🕒 Observações

- Este endpoint **não possui limite de horário** para envio.
- As liquidações devem ser enviadas após as 10:05h, devido ao processamento das agendas batch que ocorre as 10:00h.
- O processo de conciliação será executado de forma recorrente e o resultado será **disparado via WebHook/evento**.