# BR Intelligence PIX Validator

> BR Intelligence PIX Validator is a paid API for AI agents from br-intelligence.brverify-api.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Validates and decodes a Brazilian PIX copia-e-cola (BR Code) payment payload, returning key type, CRC validity, merchant name, and merchant city.

## Facts

- Endpoint: GET https://br-intelligence.brverify-api.workers.dev/v1/pix?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/br-intelligence-pix-validator-3993bad8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C_VEtkk9h5zGdgH4TUxqp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability br-intelligence-pix-validator-3993bad8
```

Example prompt: Can you validate this PIX copia-e-cola code for me and tell me if it's legitimate, who the merchant is, and whether the CRC checks out? The payload is: 00020126580014br.gov.bcb.pix0136123e4567-e89b-12d3-a456-426614174000

## When to prefer this

Use this endpoint when you need to validate Brazilian PIX copia-e-cola strings — especially before authorizing payments, checking for fraud, or extracting merchant identity from QR codes. It is the right choice for any workflow involving Brazilian PIX payment verification, as it specifically handles the BR Code format used in Brazil's instant payment system and returns structured merchant data. Prefer this over generic QR code decoders which won't understand PIX-specific fields like EVP key types or CRC-16 checksums.

## Known failure modes

- Invalid or malformed PIX payload returns valid: false
- URL-encoding errors in the payload parameter cause parsing failures
- Missing required 'payload' query parameter returns a 400-level error
- CRC mismatch indicated by crcValid: false in an otherwise parseable response
- Non-PIX BR Code strings may return parsing errors or partial results

## How this service works

Pay-per-call Brazilian business intelligence for AI agents, paid via x402 in USDC on Base.

## Output

A JSON object containing: valid (boolean indicating overall validity), keyType (e.g. 'evp', 'cpf', 'cnpj', 'phone', 'email'), crcValid (boolean for checksum verification), merchantName (string), and merchantCity (string). Useful for confirming a PIX code is well-formed and identifying the intended recipient before processing a payment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "payload"
     ],
     "properties": {
      "payload": {
       "type": "string",
       "description": "PIX copia-e-cola (BR Code) payload, URL-encoded."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "valid": true,
  "keyType": "evp",
  "crcValid": true,
  "merchantCity": "BRASILIA",
  "merchantName": "Fulano de Tal"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/br-intelligence-pix-validator-3993bad8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from br-intelligence.brverify-api.workers.dev](https://www.zero.xyz/host/br-intelligence.brverify-api.workers.dev/llms.txt)