---
title: "Criar validação"
method: POST
path: "/validation"
tags: ["Validação"]
---

# Criar validação

`POST /validation`

## Request

- Base URL: `https://contacerta-api.transfeera.com`
- URL: `https://contacerta-api.transfeera.com/validation`
- Auth: HTTP bearer

## Query parameters

- `type` 'BASICA' | 'MICRO_DEPOSITO'

## Request body

- union
  - object
    - `name` string: Nome do destinatário
    - `cpf_cnpj` string, required: Número do CPF ou CNPJ
    - `bank_code` string, required: Código do banco
    - `agency` string, required: Número da agência
    - `agency_digit` string: Dígito verificador da agência
    - `account` string, required: Número da conta
    - `account_digit` string, required: Dígito da conta
    - `account_type` 'CONTA_POUPANCA' | 'CONTA_CORRENTE' | 'CONTA_PAGAMENTO' | 'CONTA_FACIL' | 'ENTIDADES_PUBLICAS'
    - `integration_id` string: ID de integração
    - `micro_deposit_value` number: Valor do micro depósito
    - `pix_description` string: Descrição para micro depósito utilizando Pix
  - object
    - `pix_key` string, required: Valor da chave
    - `pix_key_type` 'CHAVE_ALEATORIA' | 'EMAIL' | 'TELEFONE' | 'CPF' | 'CNPJ', required
    - `integration_id` string: ID de integração
    - `micro_deposit_value` number: Valor do micro depósito
    - `pix_description` string: Descrição para micro depósito utilizando Pix
    - `pix_key_validation` object
      - `cpf_cnpj` string: Número do CPF ou CNPJ do titular

## Response `200`

OK

- union
  - object
    - `id` string, uuid
    - `name` string
    - `cpf_cnpj` string
    - `bank_code` string
    - `bank_ispb` string
    - `agency` string
    - `agency_digit` string
    - `account` string
    - `account_digit` string
    - `account_type` 'CONTA_POUPANCA' | 'CONTA_CORRENTE' | 'CONTA_PAGAMENTO' | 'CONTA_FACIL' | 'ENTIDADES_PUBLICAS'
    - `integration_id` string
    - `_validation` object
      - `valid` boolean
      - `errors` object[]
        - `message` string
        - `field` string
        - `suggestion` object
        - `errorCode` string
  - object
    - `id` string, uuid
  - object
    - `id` string, uuid
    - `pix_key` string
    - `pix_key_type` 'CHAVE_ALEATORIA' | 'EMAIL' | 'TELEFONE' | 'CPF' | 'CNPJ'
    - `integration_id` string
    - `_validation` object
      - `valid` boolean
      - `errors` object[]
        - `message` string
        - `field` string
        - `suggestion` object
        - `errorCode` string

---

[API](https://skmtc.dev/transfeera/apis/contacerta.md) - [All operations](https://skmtc.dev/transfeera/apis/contacerta/llms.txt) - [OpenAPI document](https://skmtc.dev/transfeera/apis/contacerta/revisions/17436fd230ba?raw)