API Four Capital

Conecte o Four Capital ao seu ecossistema com endpoints REST seguros, autenticação OAuth 2.0 e webhooks em tempo real para PIX, boletos, split de pagamentos e muito mais.

Obter credenciais sandbox Ver documentação
Base URL sandbox: https://sandbox.api.fourcapital.com.br Base URL produção: https://api.fourcapital.com.br

Comece em minutos

1. Crie seu aplicativo

Acesse o painel desenvolvedor, cadastre um novo app e defina permissões (escopos) para PIX, boletos, transferências e webhooks.

2. Autentique com OAuth 2.0

Gere um client_id e client_secret. Utilize o fluxo Client Credentials para integrações servidor a servidor ou Authorization Code para apps com usuário final.

3. Chame os endpoints

Envie requisições HTTPS com token Bearer. Todos os payloads utilizam formato JSON, com webhooks de confirmação e retries automáticos.

Principais endpoints

GET /v1/accounts/{accountId}

Retorna dados da conta digital, saldos e limites atualizados.

POST /v1/payments/pix

Gera QR Code dinâmico, copia e cola e link de pagamento PIX com webhooks de confirmação.

POST /v1/payments/boletos

Emite boletos registrados com baixa automática e anexos de PDF.

POST /v1/transfers/ted

Realiza transferências TED com verificação de titularidade e confirmações em tempo real.

POST /v1/split/transactions

Distribui receitas automaticamente entre recebedores com regras flexíveis.

Webhooks em tempo real

Eventos suportados

  • pix.received
  • boleto.paid
  • transfer.completed
  • split.settled

Assinatura segura

Todas as notificações são assinadas com HMAC-SHA256. Valide o cabeçalho X-Four Capital-Signature e implemente retries idempotentes.

Ferramentas de teste

Use o simulador de eventos no painel sandbox para validar integrações antes da publicação em produção.

SDKs oficiais

Node.js

Cliente oficial com TypeScript, geração de tokens, chamadas idempotentes e helpers para PIX.

Ver repositório

Python

Suporte a FastAPI e Django, com serialização pydantic dos objetos da API Four Capital.

Ver repositório

PHP / Laravel

Pacote Composer com serviços de autenticação, endpoints e middlewares de webhook.

Ver repositório

Suporte para desenvolvedores

Comunidade

Participe do fórum e compartilhe boas práticas com outras equipes de tecnologia.

Acessar comunidade

Status da plataforma

Monitore disponibilidade em tempo real e receba alertas proativos de manutenção.

Status em tempo real

Suporte premium

Contrate SLAs dedicados, squad de integração e canal exclusivo para sua operação.

Falar com vendas