Menu
Documentation
Documentation /Overview
API reference Producao Sandbox mTLS + JWT

Guia de integracao da API

Use a mesma referencia funcional para producao e sandbox, com separacao rigorosa de ambiente, token e certificado.

Mesmo contrato

Sandbox e producao seguem a mesma referencia funcional para integracao.

Credencial separada

Cada ambiente exige token e certificado emitidos especificamente para ele.

Leitura operacional

Consulte autenticacao, seguranca e fluxos de accounts sem trocar de referencia.

Documentacao da API

Esta documentacao concentra a referencia funcional da API para os ambientes de producao e sandbox.

Como usar este guia

  1. Comece por Autenticacao (JWT assinado em RS256 e certificado do ambiente).
  2. Avance para Core Banking para entender arquitetura, seguranca e governanca.
  3. Em seguida, implemente Webhooks.
  4. Por fim, aplique os fluxos de Accounts.

Ambientes

  • Producao e sandbox usam a mesma referencia funcional.
  • O que muda entre os ambientes e o host, o token e o certificado aceito.
  • Certificado SANDBOX acessa apenas rotas sandbox.
  • Certificado PRODUCTION acessa apenas rotas de producao.
  • Token e certificado devem representar o mesmo usuario e a mesma fintech.

Estrutura

  • Autenticacao
  • Core Banking
  • Webhooks
  • Accounts
Fluxo recomendado Producao + Sandbox
Integre uma vez e opere nos dois ambientes com o mesmo contrato

Comece pela autenticacao, valide a regra de ambiente e siga para os fluxos de accounts, webhooks e operacao transacional.

01
JWT e mTLS

Assinatura do token e validacao do certificado por ambiente.

02
Estrutura da plataforma

Visao dos dominios, seguranca e responsabilidades de cada servico.

03
Accounts

Contas, PIX, TED, boletos, cartoes e demais fluxos operacionais.

04
Webhooks

Eventos assincronos, idempotencia e leitura operacional de callbacks.

Autenticacao e certificado

Veja como assinar o JWT, como o ambiente e validado e quando um certificado sandbox ou producao pode ser usado.

Core Banking e seguranca

Entenda a arquitetura, a separacao entre ambientes e as camadas de controle usadas pela plataforma.

Accounts e operacao transacional

A mesma estrutura funcional atende producao e sandbox. A diferenca pratica fica isolada em host, token e certificado do ambiente.

Endpoints
Webhooks

Eventos, retries e confirmacoes para acompanhar a operacao apos cada chamada.