Introdução

Documentação da API Barte Banking para parceiros.

Informações Gerais

Item	Valor
Sandbox	https://sandbox-api-banking.barte.com
Produção	https://api-banking.barte.com
Autenticação	mTLS + Bearer Token (OAuth 2.0 Client Credentials)

Serviços disponíveis

• Autenticação

• Abertura e gestão de contas bancárias PJ

• Webhooks

• Transações PIX (entrada e saída) - Em breve

• Consulta de saldo e extrato - Em breve

• Gestão de chaves DICT - Em breve

Headers

Todas as requisições à API devem incluir:

Header	Obrigatório	Descrição
Authorization	Sim	Bearer {access_token}
Content-Type	Sim (POST/PUT)	application/json
X-Request-Id	Recomendado	UUID v4 para rastreabilidade
X-Seller-Id	Sim (POST criar conta)	ID do seller na Barte

Formato de Erro

Todas as respostas de erro seguem o formato padrão:

{
  "errors": [
    {
      "code": "BNK-0040",
      "title": "Banking flow error",
      "description": "Business account with id 123 not found"
    }
  ],
  "metadata": {
    "totalRecords": 1,
    "totalPages": 1,
    "requestDatetime": "2026-01-30T15:30:00Z"
  }
}

Códigos de Erro

Código	HTTP Status	Descrição
BNK-0501	400	Erro de validação de campos
BNK-0040	404	Recurso não encontrado
BNK-0041	409	Status inválido para a operação
BNK-0042	400	Erro ao comunicar com provider
BNK-0044	403	Acesso negado - conta pertence a outra instituição
BNK-0045	400	Conta sem sellerId configurado
BNK-0046	409	ExternalId já cadastrado
BNK-0048	409	Erro de negócio / Provider (ex: CNPJ duplicado)
BNK-0049	400	Filtro de busca não informado
BNK-0052	409	KYC em andamento (não é possível atualizar)
BNK-0053	409	Conta já está ativa
UNAUTHORIZED	401	Token inválido ou expirado
FORBIDDEN	403	Acesso negado