> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hydrahub.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Início Rápido

> Aprenda como integrar o HYDRA HUB à sua aplicação em minutos

## 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

<Warning>
  Nunca compartilhe suas chaves secretas ou as inclua em código frontend. As chaves secretas devem ser utilizadas apenas no servidor.
</Warning>

## Etapa 2: Instale o SDK JavaScript

Para integrar o tokenizador de cartão em seu site, adicione o seguinte script:

```html
<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:

```javascript
// 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:

```javascript
// 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: "joao@email.com",
        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:

```javascript
// 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**

<Card title="Ver exemplo completo de tokenizador" icon="code" href="/api-reference/endpoint/tokenizer-example">
  Confira uma implementação completa do tokenizador de cartão
</Card>