API de validação de boleto (MVP)

Endpoint público para integrações (ERP, n8n, Make, bots) validarem linha digitável ou código de barras Febraban.

Contato comercial / produção

E-mail: contato@toolspace.com.br

Use o subject API boleto para parceria, volume ou SLA.

Endpoint

POST https://www.toolspace.com.br/api/boleto/parse
Content-Type: application/json

{ "line": "34191.79001 01043.510047 91020.150008 1 96610000026035" }

Também aceita { "text": "..." } no lugar de line.

Resposta (sucesso)

Campos principais:

• ok — boleto matematicamente válido
• summary — texto pronto (banco, valor, vencimento)
• result — objeto com isValid, barcode, formattedLine, dueDate, amount, issuerCode, issuerName, scheme, errors, warnings

Descoberta

GET /api/boleto/parse devolve o contrato resumido em JSON.

Widgets embed

Para incorporar a UX no seu site (iframe):

• /embed/boleto-validator
• /embed/qrcode-pix

Hub completo: /ferramentas-boleto

Limites do MVP

• Validação estrutural / Febraban — não consulta se o boleto foi pago
• Sem autenticação / rate limit comercial ainda — volume alto: fale no e-mail acima
• Uso em produção sob acordo

API paga (waitlist)

Produto B2B one-shot prepaid (não mensal — não canibaliza Pro anual R$47). Landing canônica: /developers (UI em follow-up). Zero CTA nas money pages (boleto-to-pdf, validators).

Plano	Preço	Quota
Early (primeiros 50)	R$97 one-shot	5.000 calls / 90 dias
Lista	R$149 one-shot	15.000 calls / 90 dias

Inclui: acesso API parse/PDF boleto (core Toolspace), docs + exemplos curl/n8n, suporte e-mail/WA. CIP detalhado (status/juros) = sandbox only neste MVP; produção só após wallet prepaid + Risco.

1. Waitlist: POST /api/boleto/api-waitlist com { "email": "voce@empresa.com", "useCase": "ERP" }
2. Ou e-mail: contato@toolspace.com.br

Stub técnico: POST /api/v1/boleto/parse atrás da flag BOLETO_API_PAID_ENABLED (default off → 503). O MVP grátis em /api/boleto/parse continua público.

Não substitui Kit Boleto Pro R$47 nem Pro anual do site.