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

# Botão de checkout automático

> Adicione data-xtracky-checkout ao botão e o evento InitiateCheckout dispara sozinho — sem tocar em código.

O script V2 escuta cliques em qualquer elemento com o atributo `data-xtracky-checkout`. Ao clicar, dispara automaticamente um evento `initiate_checkout` pra xTracky, que repassa como `InitiateCheckout` (Meta) / `AddToCart` (TikTok/Kwai).

## Uso básico

```html theme={null}
<button data-xtracky-checkout>
  Finalizar Compra
</button>
```

Funciona também em links (`<a>`) ou qualquer outro elemento clicável.

## Com valor da venda

Se você já sabe o valor no momento do clique, informe pra melhorar o sinal:

```html theme={null}
<button
  data-xtracky-checkout
  data-xtracky-amount="9990"
  data-xtracky-order-id="ORDER_123">
  Finalizar Compra — R$ 99,90
</button>
```

<ParamField path="data-xtracky-amount" type="integer">
  Valor da venda em centavos (ex: R\$ 99,90 → `9990`).
</ParamField>

<ParamField path="data-xtracky-order-id" type="string">
  ID pré-gerado do pedido. Se omitido, a xTracky gera um temporário.
</ParamField>

## Como funciona por baixo

Ao carregar, o V2 registra um único listener no `document` (event delegation), então **botões adicionados dinamicamente também funcionam** — sem precisar re-registrar após navegação SPA ou carregamento AJAX.

## Múltiplos botões na mesma página

Você pode ter quantos botões quiser. Cada clique dispara um evento independente com o mesmo `LeadId`:

```html theme={null}
<button data-xtracky-checkout data-xtracky-order-id="ORDER_A">
  Plano Mensal
</button>

<button data-xtracky-checkout data-xtracky-order-id="ORDER_B">
  Plano Anual
</button>
```

A dedup ainda vai valer — se o cliente clicar duas vezes no mesmo botão, só o primeiro conta.

## Desabilitando o comportamento automático

Se você prefere disparar o evento manualmente (por exemplo, só depois de validar o formulário), desabilite o auto-checkout no script:

```html theme={null}
<script
  src="https://cdn.xtracky.com/scripts/experimental.js"
  data-token="SEU_PRODUCT_ID"
  data-auto-checkout="false"
  async>
</script>
```

Aí você dispara sob demanda:

```javascript theme={null}
window.xtracky.track('initiate_checkout', {
  orderId: 'ORDER_123',
  amount: 9990,
});
```