Início

Ambientes & URL Base

Todas as requisições devem ser enviadas para a URL base abaixo. A API opera em ambiente de produção para processamento de pagamentos reais.

URL Base

Base URLhttps://api.genesys.financeHTTPS

Todos os endpoints descritos nesta documentação são relativos a esta URL. Sempre utilize HTTPS — conexões HTTP não são suportadas.

Construindo a URL Completa

Combine a URL base com o caminho do endpoint para formar a URL completa da requisição:

Endpoint	URL Completa
Dados da conta `/v1/account-info`	`https://api.genesys.finance/v1/account-info`
Criar transação `/v1/transactions`	`https://api.genesys.finance/v1/transactions`
Criar cashout `/v1/cashout`	`https://api.genesys.finance/v1/cashout`
Listar chains `/v1/crypto/chains`	`https://api.genesys.finance/v1/crypto/chains`

Versionamento

A API é versionada pelo prefixo /v1/ em todos os endpoints. Mudanças quebra-compatibilidade serão disponibilizadas em versões superiores sem descontinuar as anteriores.

Sempre aponte explicitamente para a versão desejada. Não existe redirecionamento de / para /v1/.

Padrão de Requisições

Todas as requisições com corpo (POST, PUT, PATCH) devem enviar JSON. O header Content-Type: application/json é obrigatório nestas situações.

Estrutura padrãobash

curl -X POST "https://api.genesys.finance/v1/transactions" \
  -H "api-secret: SEU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "total_amount": 100.00,
    "payment_method": "PIX",
    "customer": { ... },
    "items": [ ... ]
  }'

Padrão de Respostas

Todas as respostas são em JSON. Respostas de sucesso retornam HTTP 200 com os dados no campo data. Erros retornam o código HTTP apropriado com detalhes no campo error.

Resposta de sucessojson

{
  "data": { ... },
  "success": true
}

Resposta de errojson

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Dados inválidos",
    "details": []
  },
  "success": false
}

Dica de configuração

Configure a URL base como variável de ambiente no seu sistema. Assim, caso a URL mude, basta atualizar em um único lugar.