Início

Visão Geral

Bem-vindo à documentação da API de Pagamentos. Aqui você encontra tudo que precisa para integrar transações PIX, cashouts e webhooks na sua aplicação.

REST & JSON

API RESTful com respostas em JSON. Padrão simples e amplamente adotado.

Autenticação Segura

Autenticação via API Secret no header. Credenciais disponíveis no painel.

Webhooks em Tempo Real

Notificações automáticas de mudanças de status via POST para sua URL.

Fluxo de Integração

Obtenha suas credenciais

Acesse o painel da sua conta -> Integrações -> API de Pagamentos e copie seu API Secret.

Configure a autenticação

Inclua o header api-secret: SEU_API_SECRET em todas as requisições autenticadas.

Faça sua primeira requisição

Consulte as informações da sua conta com GET /v1/account-info para validar a integração.

Implemente os webhooks

Configure uma URL pública para receber notificações de status de transações e cashouts.

URL Base

Base URLhttps://api.genesys.finance

Todos os endpoints documentados devem ser prefixados com esta URL. Exemplo: https://api.genesys.finance/v1/transactions

Exemplo Rápido

Verificar credenciaisbash

curl -X GET "https://api.genesys.finance/v1/account-info" \
  -H "api-secret: SEU_API_SECRET" \
  -H "Content-Type: application/json"

Segurança

Nunca exponha seu API Secret em código client-side (frontend, apps mobile). Utilize sempre em backend seguro. Em caso de comprometimento, revogue e gere um novo secret no painel.

Ambiente

Produção

Processa pagamentos reais

Online

https://api.genesys.finance