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

# Preparar a integração

> Configure o acesso, os identificadores e os webhooks antes de criar pagamentos.

Use a homologação para validar o fluxo completo antes de pedir a ativação em produção.

**1. Receba as credenciais de homologação**

Solicite ao responsável pelo onboarding da Azentech um token de API para o seu estabelecimento. Guarde o token em um cofre de segredos.

**2. Defina os identificadores do seu sistema**

Gere um `merchant_transaction_id` distinto para cada nova transação. Persista esse valor com o UUID devolvido pela Azentech.

**3. Cadastre os webhooks**

Informe uma URL HTTPS para cada evento contratado. Guarde o segredo da inscrição e valide `x-azentech-webhook-signature` antes de processar o corpo.

**4. Execute os cenários de sandbox**

Crie transações com um processador elegível em modo de teste. Use o `processor_transaction_id` do evento para simular pagamento, recebimento ou devolução.

**5. Valide a recuperação**

Reenvie o mesmo webhook, altere a ordem dos eventos e simule uma resposta HTTP de falha. Confirme que o seu processamento continua idempotente.

## Antes da ativação

Confirme estes itens com a Azentech:

* URL base de produção.
* Processadores e limites de valor habilitados.
* Campos condicionais exigidos por processador.
* Eventos, URLs e segredos de webhook.
* Modo de assinatura de webhook configurado para o estabelecimento.

> [!WARNING]
>
> Uma resposta HTTP 200 da criação confirma que o Gateway aceitou a operação. Ela não confirma liquidação bancária. Use os estados e os webhooks para acompanhar o resultado.


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