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

# HyperCash

> Conecte a HyperCash ao Metrito por webhook para receber vendas e assinaturas, com histórico de 12 meses pela chave de API.

## Como funciona

A HyperCash envia cada venda para o Metrito por **webhook**. O Metrito gera uma URL exclusiva para a sua conexão, você cadastra essa URL na HyperCash e, a partir daí, cada venda aparece em [Vendas](/analise/vendas.md) com o status atualizado.

São três partes:

1. Criar a conexão no Metrito e copiar a URL do webhook.
2. Cadastrar a URL na HyperCash.
3. Ligar a conexão ao container em **Rastreamento → Checkouts**, se quiser disparar o `Purchase` nos pixels.

## 1. Crie a conexão no Metrito

**1. Abra Adicionar Integração**

No menu lateral, abra **Integrações** e clique em **Adicionar Integração**.

**2. Escolha HyperCash**

No modal **Integrações disponíveis**, use o filtro **Pagamentos** (ou busque por "HyperCash") e selecione **HyperCash**.

**3. Dê um nome à conexão**

Em **Nome da conexão**, use um nome que identifique a conta (ex.: "HyperCash Principal") e clique em **Próximo**.

**4. Informe a chave de API (opcional)**

Em **Chave de API**, cole a chave secreta da sua conta HyperCash para trazer as vendas dos últimos 12 meses assim que a conexão for criada. Sem ela, entram só as vendas novas.

**5. Escolha o modo de valor**

Em **Modo de valor**, escolha **Valor líquido** (o que você recebe de fato, já sem taxas e comissões) ou **Valor total da venda** (o valor cheio pago pelo cliente). Veja [Checkouts e comissões](/integracoes/checkouts-e-comissoes.md) para decidir.

**6. Confira o fuso horário**

Em **Fuso horário**, mantenha o padrão (horário de São Paulo) ou escolha o fuso da sua operação.

**7. Copie a URL do webhook**

No passo **Cadastrar webhook**, o Metrito cria a conexão e mostra a URL dela, no formato:

```
https://webhook.metrito.com/v1/ingress?k=...
```

Clique em **Copiar URL do webhook**. Depois clique em **Próximo** e, na tela **Conexão criada**, em **Concluir**.

> [!WARNING]
>
> Trate essa URL como uma senha: quem tiver o endereço consegue enviar vendas para a sua conexão. Cadastre só na HyperCash e não publique.

## 2. Cadastre a URL na HyperCash

**1. Abra os webhooks**

No painel da HyperCash, abra a área de webhooks (ou postback) da sua conta.

**2. Crie um webhook**

Crie um novo webhook e cole a URL que você copiou no Metrito.

**3. Escolha os eventos**

Marque todos os eventos de venda: criada, paga, recusada, expirada, reembolsada e chargeback. Eventos que não são de venda são ignorados pelo Metrito.

**4. Salve**

Salve o webhook. As próximas vendas já chegam ao Metrito.

## 3. Ligue a HyperCash ao rastreamento

Com a conexão criada, as vendas já aparecem em [Vendas](/analise/vendas.md). Para cada pagamento aprovado também disparar o `Purchase` nos pixels:

**1. Abra os checkouts do container**

No menu lateral, abra **Rastreamento** e vá à seção **Checkouts**.

**2. Ative a conexão**

No card **Conectar Checkouts**, encontre a conexão da HyperCash (use a busca **Buscar por 'nome' ou 'gateway'**) e **ligue o interruptor** dela.

Veja [Checkouts](/tracking/checkouts.md).

## Como o Metrito lê as vendas da HyperCash

* **Assinaturas:** a primeira cobrança vira assinatura iniciada e as seguintes entram como renovação, com o número do ciclo.
* **Histórico:** com a chave de API, os últimos 12 meses de vendas entram ao criar a conexão.
* **Meios de pagamento:** PIX, cartão e boleto.

## Próximos passos

> **[Checkouts e comissões](/integracoes/checkouts-e-comissoes.md)**
>
> Entenda o modo de valor e como o Metrito calcula o valor líquido.

> **[Vendas](/analise/vendas.md)**
>
> Acompanhe as compras e a receita atribuída.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.