Valide boletos e PIX antes de pagar

Consulte boletos por código de barras e PIX por QR Code para validar os dados antes do pagamento. Identifique fraudes, confira valores atualizados e tenha segurança nas suas operações financeiras.

Agendar bate-papo Ver como funciona

Consulta de boletos e PIX na plataforma Kobana

Milhares

consultas por mês

CIP

diretório de boletos

DICT

diretório PIX

100%

dos dados oficiais

Validação em tempo real

As consultas permitem validar boletos e PIX nos diretórios centrais do sistema financeiro brasileiro antes de efetuar o pagamento. Ao informar o código de barras de um boleto ou o código PIX Copia e Cola, o sistema consulta as bases oficiais e retorna todas as informações do título.

Essa funcionalidade é essencial para prevenir fraudes, validar dados de beneficiários e garantir que o valor a ser pago está correto, considerando juros, multas e descontos aplicáveis.

Tipos de Consulta

Valide boletos por código de barras e PIX por QR Code

Consulta de Boletos

Informe o código de barras ou a linha digitável do boleto. O sistema consulta a CIP (Câmara Interbancária de Pagamentos) e retorna valor original e atualizado, data de vencimento, beneficiário (nome e CNPJ/CPF), pagador registrado, juros, multa e desconto aplicáveis.

Consulta de PIX

Informe o código PIX Copia e Cola ou o EMV do QR Code. O sistema consulta o DICT (Diretório de Identificadores de Contas Transacionais) e retorna valor da cobrança, chave PIX, dados do beneficiário, data de expiração e condições da cobrança.

Validação completa antes do pagamento

Prevenção de Fraudes

Compare os dados retornados com as informações que você recebeu. Divergências no beneficiário, valor ou conta destino indicam possível fraude.

Valores Atualizados

Veja o valor atualizado considerando juros por atraso, multas e descontos disponíveis. Pague exatamente o que deve, sem surpresas.

Organização com Tags

Adicione tags às suas consultas para organizar e categorizar. Filtre por fornecedor, departamento, projeto ou qualquer critério que faça sentido.

Histórico Completo

Todas as consultas ficam registradas. Acesse o histórico a qualquer momento para auditoria, conferência ou referência futura.

Dados retornados na consulta de boleto

Informações completas do boleto consultado nos diretórios oficiais

Identificação

UID da consulta
Código de barras
Linha digitável
ID externo (seu identificador)

Valores

Valor original
Valor mínimo e máximo
Juros e multa aplicados
Desconto disponível

Beneficiário

Nome ou razão social
Tipo (PF ou PJ)
CPF ou CNPJ
Dados do pagador

Dados retornados na consulta de PIX

Informações completas do PIX consultado no DICT

Identificação

UID da consulta
QR Code (código EMV)
Chave PIX do recebedor
ID externo (seu identificador)

Valores

Valor da cobrança
Valor total
Juros, multa e desconto
Permissão de alteração

Organização

Data de expiração
Dados do beneficiário
Tags personalizadas
Dados customizados

Benefícios para o Financeiro

Segurança

Valide cada pagamento antes de executar. Identifique fraudes comparando os dados oficiais com o que você recebeu.

Precisão

Pague o valor exato. Consultas retornam valores atualizados com juros, multas e descontos já calculados.

Controle

Organize consultas com tags e mantenha histórico completo para auditoria e referência.

Casos de uso

Validação antes do pagamento

Recebeu um boleto por email? Antes de pagar, consulte o código de barras para confirmar se os dados do beneficiário correspondem ao fornecedor real.

Benefícios:

Segurança
Validação
Prevenção

Conferência de valores

O boleto venceu? Consulte para ver o valor atualizado com juros e multa. Evite pagar mais ou menos do que deve.

Benefícios:

Precisão
Economia
Controle

Sistema anti-fraude

Implemente validação automática de boletos e PIX no seu sistema de pagamentos. A API retorna todos os dados para análise antes da execução.

Benefícios:

Automação
Integração
Proteção

Auditoria de pagamentos

Mantenha registro de todas as consultas realizadas. Associe tags e dados customizados para facilitar auditorias e conciliação.

Benefícios:

Rastreabilidade
Compliance
Organização

Consulta de Boleto via API

Envie o código de barras ou linha digitável e receba todos os dados do boleto em formato JSON. Ideal para integrar validação automática no seu sistema de pagamentos.

Ver documentação completa

bash

curl --request POST \
  --url https://api-sandbox.kobana.com.br/v2/data/bank_billet_queries \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "line": "75691.43279 01022.938508 07722.200016 1 99470000000200",
    "tags": ["fornecedor-a", "escritorio"],
    "external_id": "consulta-001"
  }'

response

{
  "status": 201,
  "data": {
    "uid": "0199bc7f-a09b-7833-a8b6-cb07c9de576d",
    "line": "75691.43279 01022.938508 07722.200016...",
    "barcode": "75691994700000002001432701022938500772220001",
    "expire_at": "2024-12-31",
    "amount": 2.00,
    "original_amount": 2.00,
    "beneficiary": {
      "name": "KOBANA INSTITUICAO DE PAGAMENTO LTDA",
      "kind": "juridical",
      "document_type": "CNPJ",
      "document_number": "05.813.794/0001-26"
    },
    "payer": {
      "name": "KIVANIO PEREIRA BARBOSA",
      "document_type": "CPF"
    },
    "fine": { "value": 0 },
    "interest": { "value": 0 },
    "discount": { "value": 0 },
    "status": "success",
    "tags": ["fornecedor-a", "escritorio"]
  }
}

Consulta de PIX via API

Envie o código PIX Copia e Cola ou EMV do QR Code e receba os dados completos da cobrança. Valide o beneficiário antes de efetuar o pagamento.

Ver documentação completa

bash

curl --request POST \
  --url https://api-sandbox.kobana.com.br/v2/data/pix_qrcode_queries \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "qrcode": "00020126330014br.gov.bcb.pix0111123456789...",
    "tags": ["pagamento-pix"],
    "external_id": "consulta-pix-001"
  }'

response

{
  "status": 201,
  "data": {
    "uid": "019a7864-34a5-7601-b288-47178282d30a",
    "qrcode": "00020126330014br.gov.bcb.pix...",
    "pix_key": "test@example.com",
    "expires_at": null,
    "amount": 100.00,
    "total_amount": 100.00,
    "interest": 0,
    "fine": 0,
    "discount": 0,
    "beneficiary": {
      "name": "EXAMPLE NAME"
    },
    "tags": ["pagamento-pix"]
  }
}