Validate boletos and PIX before paying

Query boletos by barcode and PIX by QR Code to validate data before payment. Identify fraud, check updated amounts, and have security in your financial operations.

Schedule a chat See how it works

Boleto and PIX lookup on Kobana platform

Thousands

queries per month

CIP

boleto directory

DICT

PIX directory

100%

official data

Real-time validation

Queries allow you to validate boletos and PIX in the central directories of the Brazilian financial system before making payment. By providing a boleto's barcode or a PIX Copy and Paste code, the system queries official databases and returns all information about the payment document.

This feature is essential for preventing fraud, validating beneficiary data, and ensuring that the amount to be paid is correct, considering applicable interest, fines, and discounts.

Query Types

Validate boletos by barcode and PIX by QR Code

Boleto Lookup

Enter the barcode or digitable line of the boleto. The system queries CIP (Interbank Payment Chamber) and returns original and updated amount, due date, beneficiary (name and CNPJ/CPF), registered payer, applicable interest, fine, and discount.

PIX Lookup

Enter the PIX Copy and Paste code or QR Code EMV. The system queries DICT (Transactional Account Identifier Directory) and returns charge amount, PIX key, beneficiary data, expiration date, and charge conditions.

Complete validation before payment

Fraud Prevention

Compare the returned data with the information you received. Discrepancies in the beneficiary, amount, or destination account indicate possible fraud.

Updated Amounts

See the updated amount considering late interest, fines, and available discounts. Pay exactly what you owe, no surprises.

Organization with Tags

Add tags to your queries to organize and categorize. Filter by supplier, department, project, or any criteria that makes sense.

Complete History

All queries are recorded. Access the history at any time for audit, verification, or future reference.

Data returned in boleto lookup

Complete information from the queried boleto from official directories

Identification

Query UID
Barcode
Digitable line
External ID (your identifier)

Amounts

Original amount
Minimum and maximum amount
Applied interest and fine
Available discount

Beneficiary

Name or company name
Type (individual or company)
CPF or CNPJ
Payer data

Data returned in PIX lookup

Complete information from the queried PIX from DICT

Identification

Query UID
QR Code (EMV code)
Receiver's PIX key
External ID (your identifier)

Amounts

Charge amount
Total amount
Interest, fine, and discount
Change permission

Organization

Expiration date
Beneficiary data
Custom tags
Custom data

Benefits for Finance

Security

Validate each payment before executing. Identify fraud by comparing official data with what you received.

Accuracy

Pay the exact amount. Queries return updated amounts with interest, fines, and discounts already calculated.

Control

Organize queries with tags and keep complete history for audit and reference.

Use cases

Pre-payment validation

Received a boleto by email? Before paying, query the barcode to confirm that the beneficiary data matches the real supplier.

Benefícios:

Security
Validation
Prevention

Amount verification

Boleto is overdue? Query to see the updated amount with interest and fine. Avoid paying more or less than you owe.

Benefícios:

Accuracy
Savings
Control

Anti-fraud system

Implement automatic validation of boletos and PIX in your payment system. The API returns all data for analysis before execution.

Benefícios:

Automation
Integration
Protection

Payment audit

Keep a record of all queries made. Associate tags and custom data to facilitate audits and reconciliation.

Benefícios:

Traceability
Compliance
Organization

Boleto Lookup via API

Send the barcode or digitable line and receive all boleto data in JSON format. Ideal for integrating automatic validation into your payment system.

View complete documentation

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"]
  }
}

PIX Lookup via API

Send the PIX Copy and Paste code or QR Code EMV and receive complete charge data. Validate the beneficiary before making the payment.

View complete documentation

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"]
  }
}