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

# Integrar uma oferta

> Checklist para conectar landing page, checkout e backend à Atriby.

Use este checklist para integrar uma oferta de ponta a ponta.

## Checklist

1. Instale o script na página da oferta.

```html theme={null}
<script src="https://app.atriby.com/scripts/utms/latest.js" async defer></script>
```

2. Garanta que o botão de checkout recebe UTMs.

Teste com uma URL de entrada:

```text theme={null}
https://sua-oferta.com/?utm_source=facebook&utm_medium=cpc&utm_campaign=teste
```

3. No checkout, capture os parâmetros que chegaram na URL.

4. No seu servidor, crie um token secreto `ATRIBY_API_TOKEN`.

5. Quando o pedido nascer, envie `POST /api/v1/orders`.

6. Quando o pagamento mudar, envie `PATCH /api/v1/orders/{externalId}`.

7. Em testes, envie `isTest: true`.

8. No dashboard, ative **Incluir testes** para validar sem poluir a visão padrão.

9. Confira `/pedidos`, `/pedidos/[externalId]`, `/` e `/campanhas`.

## Regra de segurança

O browser nunca chama a Orders API. Apenas o seu backend deve usar o token.