Skip to main content

​
Exemplos

O HYDRA HUB oferece múltiplas opções de pagamento para atender às necessidades do seu negócio. Nossa plataforma processa transações de forma segura e eficiente, integrando-se facilmente ao seu sistema.

​
Métodos de Pagamento Disponíveis

Exemplo de Tokenizador de Cartão

Integre pagamentos via cartão de crédito com suporte a parcelamento, tokenização e antifraude.

Exemplo de Tokenizador de PIX

Ofereça pagamentos instantâneos 24/7 com confirmação em segundos através do sistema PIX.
Não oferecemos suporte a Recorrência, Cartão de Débito ou Transferência Bancária no momento.

​
Endpoints Principais

Todos os métodos de pagamento utilizam o mesmo endpoint base, variando apenas o parâmetro paymentMethod: 
POST /api/v1/transactions

​
Autenticação

Todas as operações de transação exigem autenticação usando Basic Auth. Concatene sua chave secreta e pública no formato sk_userKey:pk_userKey e codifique em Base64. 
Authorization: Basic {base64(sk_userKey:pk_userKey)}
Suas chaves de API podem ser encontradas no seu painel de API do HYDRA HUB.

​
Fluxo Geral de Pagamento

Independentemente do método escolhido, o fluxo básico de pagamento segue estas etapas:
  1. Inicialização da transação - Envio dos dados do cliente e pagamento
  2. Processamento - Validação e processamento pelo HYDRA HUB
  3. Confirmação - Recebimento do status da transação
  4. Notificação - Atualização do status via webhook (quando configurado)

​
Consulta de Transações

Para consultar o status de uma transação existente: 
GET /api/v1/transactions/{transaction_id}

​
Response

{
  "success": true,
  "data": {
    "id": 12345,
    "status": "approved",
    "amount": 9990,
    "paymentMethod": "credit_card",
    "customer": {
      "name": "João Silva",
      "email": "[email protected]"
    },
    "createdAt": "2023-05-14T10:30:00Z",
    "updatedAt": "2023-05-14T10:35:22Z"
  }
}

​
Status das Transações

StatusDescrição
pendingAguardando pagamento ou processamento
processingEm processamento pela adquirente/instituição financeira
pre_authorizedPré-autorizada, aguardando captura
approvedPagamento recebido e confirmado
refusedTransação recusada pela adquirente/instituição financeira
canceledTransação cancelada
expiredTransação expirada (não concluída no prazo)
refundedTransação estornada (total ou parcialmente)

​
Webhooks

O HYDRA HUB pode notificar seu sistema sobre alterações no status das transações através de webhooks. Para isso, configure uma URL de callback no campo postbackUrl ao criar a transação.

​
Formato da Notificação

{
  "id": 12345,
  "status": "approved",
  "externalRef": "pedido123",
  "amount": 9990,
  "transactionDate": "2023-05-14T10:35:22Z"
}

​
Configuração de Webhooks

Para garantir que as notificações sejam recebidas corretamente:
  1. Sua URL de callback deve ser acessível publicamente
  2. O endpoint deve responder com status HTTP 200 ou 202
  3. O processamento deve ser assíncrono para evitar timeouts
  4. Implemente verificação de segurança para validar as notificações recebidas
Recomendamos configurar um endereço de webhook global no seu painel do HYDRA HUB, além do webhook por transação, para garantir redundância nas notificações.

​
Ambiente

O HYDRA HUB disponibiliza um único ambiente:
  • Produção - Para transações reais (https://api.hydrahub.com.br/api/v1)