Skip to main content

​
Visão Geral

Este guia irá ajudá-lo a começar a integração com o HYDRA HUB rapidamente. Vamos abordar as etapas básicas para configurar sua conta, obter as credenciais de API e realizar sua primeira transação.

​
Pré-requisitos

Antes de começar, você precisará:
  1. Ter uma conta em algum Gateway Hydra HUB
  2. Completar o processo de verificação KYC da sua empresa
  3. Ter conhecimentos básicos de desenvolvimento web e APIs REST

​
Etapa 1: Obtenha suas credenciais

Após criar sua conta e concluir o processo de verificação, acesse o dashboard do Gateway para obter suas credenciais:
  1. Faça login
  2. Navegue até Integrações
  3. Você encontrará suas chaves de API
  4. Copie as chaves
Nunca compartilhe suas chaves secretas ou as inclua em código frontend. As chaves secretas devem ser utilizadas apenas no servidor.

​
Etapa 2: Instale o SDK JavaScript

Para integrar o tokenizador de cartão em seu site, adicione o seguinte script: 
<script src="https://api.hydrahub.com.br/api/v1/js"></script>

​
Etapa 3: Tokenize um cartão

Utilize o SDK JavaScript para tokenizar os dados do cartão: 
// Configure sua chave pública
HydraPay.setPublicKey("sua_chave_publica_aqui");

// Tokenize os dados do cartão
const token = await HydraPay.encrypt({
  number: "5246742052345678",
  holderName: "João da Silva",
  expMonth: 4,
  expYear: 2030,
  cvv: "069"
});

console.log("Token gerado:", token);

​
Etapa 4: Crie uma transação

Com o token do cartão em mãos, você pode agora criar uma transação no seu servidor: 
// Código no servidor
const axios = require('axios');

async function createTransaction(cardToken, amount) {
  try {
    const response = await axios.post('https://api.hydrahub.com.br/api/v1/transactions/', {
      amount: amount, // valor em centavos (exemplo: 10000 = R$ 100,00)
      currency: "BRL",
      payment_method: "credit_card",
      card_token: cardToken,
      installments: 1,
      customer: {
        name: "João da Silva",
        email: "[email protected]",
        document: "123.456.789-00"
      }
    }, {
      headers: {
        'Authorization': 'Bearer sua_chave_secreta_aqui',
        'Content-Type': 'application/json'
      }
    });
    
    return response.data;
  } catch (error) {
    console.error('Erro ao criar transação:', error.response?.data || error.message);
    throw error;
  }
}

​
Etapa 5: Processar o resultado

Após criar a transação, você pode verificar o status e tomar as ações apropriadas: 
// Verificando o status da transação
async function checkTransactionStatus(transactionId) {
  try {
    const response = await axios.get(`https://api.hydrahub.com.br/api/v1/transactions/${transactionId}`, {
      headers: {
        'Authorization': 'Bearer sua_chave_secreta_aqui'
      }
    });
    
    const transaction = response.data;
    
    if (transaction.status === 'approved') {
      // Transação aprovada - libere o produto/serviço
      console.log('Pagamento aprovado!');
    } else if (transaction.status === 'pending') {
      // Transação pendente - aguarde confirmação
      console.log('Pagamento em processamento...');
    } else {
      // Transação recusada ou com erro
      console.log('Pagamento recusado:', transaction.status);
    }
    
    return transaction;
  } catch (error) {
    console.error('Erro ao verificar status:', error);
    throw error;
  }
}

​
Próximos Passos

Agora que você completou a integração básica, considere explorar:
  1. Configuração de Webhooks
  2. Diferentes métodos de pagamento

Ver exemplo completo de tokenizador

Confira uma implementação completa do tokenizador de cartão