Ir para conteúdo principal
API REST · OpenAPI 3.0

Para Desenvolvedores

Integre infraestrutura financeira em dias, não meses.

API REST documentada, sandbox imediato e suporte técnico direto com a equipe de engenharia Genyuz. Sem intermediários, sem filas de suporte genérico.

Visão geral

API REST · JSON · OAuth 2.0

Uma API consistente para todos os módulos da plataforma Genyuz. Mesma autenticação, mesmos padrões de resposta, mesma documentação.

Protocolo
HTTPS · REST · JSON
Autenticação
OAuth 2.0 / API Key
Base URL — Sandbox
Base URL — Produção
Rate limit (sandbox)
1.000 req/min
Versioning
Header: Api-Version: 2024-01

Exemplo: criar conta via BaaS

Request POST /baas/accounts
POST /baas/accounts
Authorization: Bearer {seu_token}
Content-Type: application/json
Api-Version: 2024-01

{
  "holder": {
    "document": "012.345.678-90",
    "name":     "João Silva",
    "email":    "joao@empresa.com"
  },
  "account_type": "checking"
}
Response 201 Created
{
  "id":         "acc_01HXYZ...",
  "status":     "pending_kyc",
  "created_at": "2024-10-01T10:00:00Z"
}

Módulos da API

Tudo na mesma plataforma

Todos os módulos usam a mesma autenticação e seguem os mesmos padrões. Integre um ou todos.

/baas/*

Banking as a Service

Contas, cartões, PIX, TED, boleto e onboarding KYC

/acquiring/*

Adquirência

Transações, subcredenciados, split e chargebacks

/receivables/*

Trava de Recebível

Agenda, travas CERC/CIP, monitoramento e liquidação

/auth/*

Autenticação

Emissão e renovação de tokens OAuth 2.0

/webhooks/*

Webhooks

Configuração de eventos, retry automático e logs

Ambientes

Sandbox imediato, produção controlada

Acesse o sandbox e comece a testar em horas. A migração para produção acontece com suporte direto da nossa equipe de engenharia.

Sandbox Produção
Base URL sandbox.api.genyuz.com api.genyuz.com
Dados Fictícios e seguros Reais
Acesso Após aprovação (~1 dia útil) Após contrato assinado
Rate limit 1.000 req/min Conforme contrato
Suporte E-mail 24/7 direto com engenharia
Integração BACEN Simulada Real

Ferramentas

Tudo que você precisa para integrar

📮

Coleção Postman

Todos os endpoints pré-configurados, prontos para testar.

📄

OpenAPI 3.0

Spec completa para gerar clientes em qualquer linguagem.

🔔

Webhooks com retry

Eventos em tempo real com retry automático exponencial.

📊

Logs no dashboard

Histórico de requisições, status e payload para debug.

Como começar

Três passos para o go-live

01
Solicite acesso sandbox

Preencha o formulário abaixo ou envie um e-mail para dev@genyuz.com. Você recebe as credenciais em até 1 dia útil.

02
Explore e integre

Use nossa coleção Postman ou a spec OpenAPI 3.0 para explorar todos os endpoints. Nossa equipe de engenharia está disponível para dúvidas técnicas.

03
Go-live com suporte direto

Quando estiver pronto, sua equipe vai ao ar com acompanhamento direto da engenharia Genyuz — sem intermediários, sem tickets.

Pronto para integrar?

Solicite acesso ao sandbox e comece a testar a plataforma Genyuz hoje. Credenciais em até 1 dia útil.