Skip to main content

​
API do HYDRA HUB

A API do HYDRA HUB é uma solução completa de processamento de pagamentos que permite integrar múltiplas formas de pagamento em sua aplicação de forma rápida e segura. Nossa plataforma oferece suporte para cartão de crédito, PIX e outros métodos de pagamento, com foco em segurança, escalabilidade e facilidade de uso.

​
Visão Geral

Processamento simplificado de pagamentos

O HYDRA HUB facilita a coleta, processamento e gerenciamento de pagamentos online, permitindo que você foque no crescimento do seu negócio enquanto cuidamos da infraestrutura de pagamentos.

​
Recursos Principais

Múltiplos métodos de pagamento

Suporte para cartão de crédito, PIX, com mais métodos sendo adicionados regularmente.

Tokenização segura

Proteja dados sensíveis de cartão através de tokenização, reduzindo escopo de PCI DSS.

Webhooks em tempo real

Receba notificações automáticas sobre mudanças no status das transações.

Dashboard completo

Acompanhe transações, visualize relatórios e gerencie sua conta através de um painel intuitivo.

​
Ambientes

O HYDRA HUB disponibiliza dois ambientes para sua integração:
AmbienteURL BaseDescrição
Sandboxhttps://sandbox.api.hydrahub.com.brAmbiente de testes para desenvolvimento e homologação
Produçãohttps://api.hydrahub.com.brAmbiente de produção para transações reais
Recomendamos que você sempre teste sua integração no ambiente Sandbox antes de seguir para produção. O ambiente Sandbox simula todas as funcionalidades do ambiente de produção sem processar transações reais.

​
Primeiros Passos

Para começar a usar a API do HYDRA HUB, siga estes passos:
  1. Crie sua conta no HYDRA HUB
  2. Obtenha suas credenciais no Dashboard
  3. Explore a documentação para entender os endpoints disponíveis
  4. Teste no ambiente Sandbox antes de ir para produção

​
Autenticação

A API do HYDRA HUB utiliza dois tipos de autenticação, dependendo da operação:

​
Chaves de API

Todas as requisições à API (exceto o endpoint de status) exigem autenticação. Você receberá duas chaves ao se cadastrar:
  • Chave Pública (pk_): Pode ser exposta no frontend, usada para tokenização
  • Chave Secreta (sk_): Deve ser mantida segura no backend, usada para todas as outras operações

​
Basic Auth

Para a maioria dos endpoints, você deve usar autenticação Basic Auth concatenando sua chave secreta e pública: 
Authorization: Basic c2tfeHh4eDpwa195eXl5
Onde c2tfeHh4eDpwa195eXl5 é a string Base64 de sk_xxxx:pk_yyyy.
Nunca exponha sua chave secreta em código frontend. Ela deve ser usada apenas em ambientes seguros de backend.

​
Endpoints Principais

Status da API

Verifique a disponibilidade e saúde da API

Tokenização de Cartão

Tokenize dados de cartão de forma segura

Transações com Cartão

Processe pagamentos com cartão de crédito

Transações com PIX

Crie pagamentos instantâneos via PIX

Informações da Empresa

Consulte dados da sua empresa

​
Fluxo de Integração

Um fluxo típico de integração com o HYDRA HUB segue estas etapas:
1

Configuração Inicial

Obtenha suas credenciais e configure o ambiente
2

Tokenização (para cartão)

Tokenize dados sensíveis do cartão no frontend
3

Criação da Transação

Processe o pagamento usando o token obtido ou via PIX
4

Confirmação

Verifique o status da transação e confirme o pagamento
5

Notificações

Receba webhooks para atualizações de status

​
Formato das Requisições e Respostas

A API do HYDRA HUB utiliza o formato JSON para requisições e respostas, com os seguintes padrões:

​
Requisições

POST /api/v1/transactions
Content-Type: application/json
Authorization: Basic c2tfeHh4eDpwa195eXl5

{
  "paymentMethod": "credit_card",
  "amount": 9990,
  "card": {
    "hash": "eyJhbGciOiJIUzI1NiIsInR5cCI..."
  },
  "customer": {
    "name": "João Silva",
    "email": "[email protected]"
  }
}

​
Respostas

{
  "success": true,
  "data": {
    "id": 12345,
    "status": "approved",
    "amount": 9990,
    "createdAt": "2023-05-14T10:30:00Z"
  }
}

​
Suporte

Se você tiver dúvidas ou precisar de ajuda durante a integração, nossa equipe está disponível para auxiliá-lo:
  • Email: [email protected]
  • Chat ao vivo: Disponível no Dashboard do HYDRA HUB
  • Horário de atendimento: Segunda a Sexta, 9h às 18h (horário de Brasília)

​
Próximos Passos

Comece explorando nossa documentação detalhada:

Guia Rápido

Um guia passo a passo para sua primeira integração

Tokenização de Cartão

Como tokenizar cartões de forma segura

Webhooks

Configure notificações automáticas