_Integrações_

Débitos veiculares em qualquer canal

API REST, servidor MCP, snippets prontos, webhooks assinados, POS Paydroid e o seu próprio adquirente. Escolha o caminho de integração e vá para produção em semanas.

Voltar para Home

_Integração_

Etapa 01 / 06

Integre rapidamente em qualquer app, aplicação ou site

Chave de sandbox em 2 minutos e primeira consulta por placa em 5. A mesma base de integração serve app mobile, web app, e-commerce, ERP de locadora e totem de loja — sem reescrever regra de negócio.

Sandbox isolado por parceiro com placas de teste prontas
SDKs em Node, Python, PHP e Java além da REST pura
Checkout white-label embutido por iframe ou link de pagamento
Homologação e ida a produção em até 2 semanas

Time to first call

sandbox → produção

primeira consulta em 5 min

5:04

00:00zera keys create --env sandbox
02:10GET /v1/debts?plate=ABC1D23 → 200
05:04POST /v1/checkout/session → 201
D+9homologação aprovada · go-live

Telemetriaao vivo

p50 /v1/debts118 ms
p95 /v1/debts264 ms
p99 /v1/checkout412 ms

Batimento da API · req / min38 bpm

Sucesso99,98% · 200 OK

Erros 4xx / 5xx12 / 0

sa-east-1 · uptime 99,99% · último evento payment.settled há 3s

Placas de teste24

Ambientessandbox · prod

Homologação2 semanas

SetupR$ 0

ZERA / MÓDULOAmbiente do cliente

_MCP_

Etapa 02 / 06

Servidor MCP oficial para agentes de IA

Conecte Claude, ChatGPT ou seu próprio agente ao servidor MCP da Zera e deixe o modelo consultar débitos, simular parcelamento e acompanhar liquidação com permissões por escopo.

Tools zera.query_debts, zera.simulate_credit e zera.settlement_status
Escopos por tenant, com trilha de auditoria de cada chamada do agente
Respostas tipadas em JSON, prontas para raciocínio do modelo
Mesma autenticação e rate limit da API REST

Servidor MCP

tools · escopos · auditoria

1Agente de IA

pergunta do operador

2Chamada de tool

zera.query_debts

3Servidor MCP

escopo + auditoria

4Resposta no chat

débitos + parcelas

tool actions

Quais débitos da placa ABC1D23?

Tenantprt_aurora

Chamadas auditadas100%

ZERA / MÓDULOAmbiente do cliente

_Code snippets_

Checkout transparente de débitos, personalizado em tempo real

Ajuste bordas, cores e tipografia e veja o checkout do seu app mudar na hora. O payload ao lado é exatamente o que roda em produção.

Pré-visualização do checkout

Zera · Débitos• • • • •
•••• •••• •••• ••••
Placa
ABC1D23
Total
R$ 4.238,90

Número do cartão

0000 0000 0000 0000

Nome do titular

COMO IMPRESSO NO CARTÃO

Validade

MM/AA

CVV

• • •

PCI-DSS · tokenização no navegador

Personalize em tempo real

Borda do cartão1pxBorda dos campos2pxRaio das bordas0px

Cor do cartão#0f1a14Cor do texto#d7ff3f

Fonte

POST /v1/checkout/sessions

POST /v1/checkout/sessions
Authorization: Bearer sk_live_zera_...
Content-Type: application/json

{
  "plate": "ABC1D23",
  "debts": ["ipva", "licenciamento", "multas"],
  "method": "card",
  "transparent_checkout": true,
  "theme": {
    "card_color": "#0f1a14",
    "text_color": "#d7ff3f",
    "font": "mono",
    "card_border_width": 1,
    "field_border_width": 2,
    "radius": 0
  }
}

_APIs e webhooks_

Etapa 03 / 06

REST versionada com eventos assinados

Consulta, simulação, checkout, liquidação e baixa no órgão em uma API só. Cada mudança de estado sai como webhook assinado, com retentativa e replay por evento.

Eventos debt.updated, payment.settled e clearance.confirmed
Assinatura HMAC, retentativa exponencial e replay por período
Rate limit e observabilidade por chave e ambiente
Status page e latência p95 abaixo de 500 ms

Eventos assinados

HMAC · retry · replay

x-zera-signature: sha256=9f21c…

debt.updated1/5200
payment.settled1/5200
clearance.confirmed2/5retry
commission.paid1/5200

Entrega p95420 ms

Replay30 dias

ZERA / MÓDULOAmbiente do cliente

_SDKs_

Etapa 04 / 06

SDKs oficiais em Node, Python, PHP e Java

Um pacote por linguagem, tipado e versionado, com retry, idempotência e verificação de assinatura de webhook já embutidos. Instale, cole a chave e a primeira consulta por placa sai na mesma sessão.

Tipos gerados a partir do mesmo contrato OpenAPI da API
Retry com backoff e chave de idempotência aplicados por padrão
Helper de verificação HMAC dos webhooks em uma linha
Versionamento semântico com changelog e suporte à versão anterior

SDKs oficiais

4 linguagens · tipadas

$ npm i @zera/sdk

editor · Node

Versãov2.4.1

Typesincluídos

Retry / idempotêncianativo

Webhook helperverify()

ZERA / MÓDULOAmbiente do cliente

_POS · Paydroid_

Etapa 05 / 06

POS Paydroid para atendimento presencial

O mesmo fluxo da API roda no balcão: consulta por placa, simulação e cobrança na maquininha Android, com comprovante impresso e feedback em tempo real para o cliente.

App Paydroid homologado para terminais Android
Consulta por placa e cobrança sem sair do terminal
Comprovante de pagamento impresso e digital
Mesma conciliação e comissionamento das vendas digitais

POS Paydroid

terminal Android

consulta · digitando dados

sua marca12:29

Nova consulta de débitos

Placa

Veículo

CPF

Proprietário

preenchendo…

pagamento aprovado · via impressa e digital

ZERA / MÓDULOAmbiente do cliente

_Gateway_

Etapa 06 / 06

Bring Your Own Acquirer

Use o seu adquirente e a sua tarifa. A Zera orquestra a transação, o split e a baixa no órgão sem obrigar você a trocar de gateway ou renegociar contrato.

Conecte o adquirente ou gateway que você já usa
Split de comissão configurável por transação
Conciliação em tempo real e repasse em D0
Fallback entre adquirentes com regra por bandeira e ticket

Bring your own acquirer

roteamento · split

orquestração da transação

Seu adquirente · Stone62%

MDR do seu contrato

Fallback · Cielo26%

regra por bandeira

Gateway Zera12%

ticket > R$ 5 mil

Split1,8%

RepasseD0

Conciliaçãoreal time

ZERA / MÓDULOAmbiente do cliente