Valida los boletos y PIX antes de pagar

Consulta boletos por código de barras y PIX por QR Code para validar los datos antes del pago. Identifica fraudes, verifica montos actualizados y ten seguridad en tus operaciones financieras.

Agenda una conversación Ver cómo funciona

Consulta de boleto y PIX en la plataforma Kobana

Miles

de consultas por mes

CIP

directorio de boletos

DICT

directorio de PIX

100%

datos oficiales

Validación en tiempo real

Las consultas te permiten validar boletos y PIX en los directorios centrales del sistema financiero brasileño antes de realizar el pago. Al proporcionar el código de barras de un boleto o el código Copia y Pega de un PIX, el sistema consulta las bases oficiales y devuelve toda la información del documento de pago.

Esta funcionalidad es esencial para prevenir fraudes, validar los datos del beneficiario y garantizar que el monto a pagar esté correcto, considerando los intereses, multas y descuentos aplicables.

Tipos de Consulta

Valida boletos por código de barras y PIX por QR Code

Consulta de Boleto

Ingresa el código de barras o la línea digitable del boleto. El sistema consulta la CIP (Cámara Interbancaria de Pagos) y devuelve el monto original y actualizado, vencimiento, beneficiario (nombre y CNPJ/CPF), pagador registrado, intereses, multa y descuento aplicables.

Consulta de PIX

Ingresa el código Copia y Pega del PIX o el QR Code EMV. El sistema consulta el DICT (Directorio de Identificadores de Cuentas Transaccionales) y devuelve el monto del cobro, clave PIX, datos del beneficiario, fecha de expiración y condiciones del cobro.

Validación completa antes del pago

Prevención de Fraudes

Compara los datos devueltos con la información que recibiste. Divergencias en el beneficiario, monto o cuenta destino indican posible fraude.

Montos Actualizados

Consulta el monto actualizado considerando intereses por atraso, multas y descuentos disponibles. Paga exactamente lo que debes, sin sorpresas.

Organización con Etiquetas

Agrega etiquetas a tus consultas para organizar y categorizar. Filtra por proveedor, departamento, proyecto o cualquier criterio que tenga sentido.

Historial Completo

Todas las consultas quedan registradas. Accede al historial en cualquier momento para auditoría, verificación o referencia futura.

Datos devueltos en la consulta de boleto

Información completa del boleto consultado desde los directorios oficiales

Identificación

UID de la consulta
Código de barras
Línea digitable
External ID (tu identificador)

Montos

Monto original
Monto mínimo y máximo
Intereses y multa aplicados
Descuento disponible

Beneficiario

Nombre o razón social
Tipo (persona física o jurídica)
CPF o CNPJ
Datos del pagador

Datos devueltos en la consulta de PIX

Información completa del PIX consultado desde el DICT

Identificación

UID de la consulta
QR Code (código EMV)
Clave PIX del receptor
External ID (tu identificador)

Montos

Monto del cobro
Monto total
Intereses, multa y descuento
Permiso de cambio

Organización

Fecha de expiración
Datos del beneficiario
Etiquetas personalizadas
Datos personalizados

Beneficios para Finanzas

Seguridad

Valida cada pago antes de ejecutarlo. Identifica fraudes comparando los datos oficiales con lo que recibiste.

Precisión

Paga el monto exacto. Las consultas devuelven montos actualizados con intereses, multas y descuentos ya calculados.

Control

Organiza las consultas con etiquetas y mantén un historial completo para auditoría y referencia.

Casos de uso

Validación previa al pago

¿Recibiste un boleto por email? Antes de pagar, consulta el código de barras para confirmar que los datos del beneficiario coincidan con el proveedor real.

Benefícios:

Seguridad
Validación
Prevención

Verificación de montos

¿Boleto vencido? Consulta para ver el monto actualizado con intereses y multa. Evita pagar más o menos de lo que debes.

Benefícios:

Precisión
Ahorro
Control

Sistema antifraude

Implementa la validación automática de boletos y PIX en tu sistema de pagos. La API devuelve todos los datos para análisis antes de la ejecución.

Benefícios:

Automatización
Integración
Protección

Auditoría de pagos

Mantén un registro de todas las consultas realizadas. Asocia etiquetas y datos personalizados para facilitar auditorías y conciliación.

Benefícios:

Trazabilidad
Compliance
Organización

Consulta de Boleto vía API

Envía el código de barras o la línea digitable y recibe todos los datos del boleto en formato JSON. Ideal para integrar la validación automática en tu sistema de pagos.

Ver documentación 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": ["supplier-a", "office"],
    "external_id": "query-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 PAYMENT INSTITUTION LLC",
      "kind": "juridical",
      "document_type": "CNPJ",
      "document_number": "05.813.794/0001-26"
    },
    "payer": {
      "name": "JOHN DOE",
      "document_type": "CPF"
    },
    "fine": { "value": 0 },
    "interest": { "value": 0 },
    "discount": { "value": 0 },
    "status": "success",
    "tags": ["supplier-a", "office"]
  }
}

Consulta de PIX vía API

Envía el código Copia y Pega del PIX o el QR Code EMV y recibe los datos completos del cobro. Valida al beneficiario antes de realizar el pago.

Ver documentación 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": ["pix-payment"],
    "external_id": "pix-query-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": ["pix-payment"]
  }
}