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

# Checkouts abandonados

> O que a Reval registra quando um cliente deixa o checkout de assinatura pela metade, por que não aparece na lista da Shopify e como montar o e-mail de recuperação no Klaviyo.

Quando um cliente informa o e-mail no checkout da Reval e não conclui o pagamento, hoje essa venda se perde sem você saber. Com **Checkouts abandonados** ativado, a Reval salva a tentativa, mostra em **Pedidos → Checkouts abandonados** e emite um evento para você montar um e-mail de recuperação no Klaviyo ou na sua ferramenta de webhooks.

> [!WARNING]
>
> Os checkouts da Reval **não aparecem em Pedidos → Checkouts abandonados da Shopify**. Essa lista é somente leitura para os apps e a Shopify a alimenta apenas com o próprio checkout. A lista da Reval é o equivalente, dentro do app.

## Ativar

**Configuração → Pedidos e estoque → Checkouts e carrinhos abandonados**. Vem **desligado**: são dados pessoais de pessoas que não compraram. Enquanto está desligado nada é salvo nem emitido.

## O que é registrado

Assim que o cliente digita um e-mail válido em qualquer um dos três checkouts da Reval (produto, carrinho de assinaturas ou caixa), a Reval salva a tentativa e vai atualizando enquanto ele preenche o formulário: e-mail, nome e endereço se informados, os produtos com a frequência, o valor e a data. Nada do cartão é salvo.

Um mesmo cliente que abandona várias vezes o mesmo tipo de checkout atualiza **um único registro**, não vários.

## A lista

**Pedidos → Checkouts abandonados** mostra cliente, produtos, valor, tipo de checkout, status e última atividade:

| Status | O que significa |
| - | - |
| **Em andamento** | O cliente informou o e-mail há menos de uma hora. |
| **Abandonado** | Passou uma hora sem atividade e não pagou (o mesmo critério da Shopify). |
| **Concluído** | Pagou na mesma sessão. Não aparece na aba Abandonados. |
| **Recuperado** | Pagou depois de ter abandonado, ou voltou pelo link de recuperação. |

**Copiar link** dá o link de recuperação: abre o mesmo checkout com os produtos, o plano, a frequência e os dados do cliente já preenchidos (o cartão, não). É o mesmo link que vai no evento.

Os registros são **apagados após 90 dias** sem atividade, como na Shopify.

## O e-mail de recuperação no Klaviyo

A Reval segue o mesmo esquema da integração da Shopify com o Klaviyo: o evento **«Checkout iniciado»** sai **assim que o cliente informa o e-mail**, não depois da espera. A espera e o corte ficam no fluxo, como no seu fluxo de carrinho abandonado:

1. **Gatilho**: métrica «Checkout iniciado».
2. **Espera**: a que você quiser (a Shopify usa 10 horas por padrão; 1 hora também é comum).
3. **Filtro do fluxo**: *«Assinatura criada» zero vezes desde que este fluxo começou*. Se o cliente comprou, o e-mail não sai.
4. **E-mail**: use `{{ event.recovery_url }}` como botão, `{{ event.items_text }}` ou `{{ event.product_names }}` para listar o que ele deixou, e `{{ event.amount_formatted }}` para o valor.

Propriedades do evento: `checkout_kind` (`product` / `box` / `cart`), `title`, `product_names`, `items_text`, `items` (lista com `title`, `quantity`, `frequency_label`), `item_count`, `amount`, `amount_formatted`, `currency`, `customer_first_name`, `customer_last_name`, `shipping_city`, `shipping_province`, `shipping_country`, `recovery_url`, `checkout_started_at`.

Não há um evento «recuperado» à parte: o sinal de que comprou é a métrica **«Assinatura criada»** de sempre, que é o que o filtro do passo 3 olha.

## Carrinhos abandonados

O **carrinho de assinaturas** da Reval (a gaveta que junta vários produtos para pagar em um único checkout) é registrado com a mesma opção, um passo antes: quando o cliente o enche e não segue para o checkout. Como o carrinho vive no navegador e não sabe quem é o cliente, a Reval só o salva quando consegue identificá-lo com certeza: o cliente **fez login** na loja, ou **já deixou o e-mail** em um checkout da Reval naquele mesmo navegador. Carrinhos anônimos não são salvos nem geram evento; a lista mostra que porcentagem de carrinhos pôde ser identificada, para decidir se vale ampliar.

Na lista aparecem como **Carrinho (sem checkout)**, com os produtos que a Reval cotou e um link que abre o checkout com esse carrinho carregado. Quando o cliente segue para o checkout o registro passa a **Chegou ao checkout** (e o checkout assume); se ele esvazia o carrinho, a **Esvaziado**; se compra, a **Concluído**.

O evento é **«Carrinho iniciado»**, com as mesmas propriedades de «Checkout iniciado», e sai assim que há um carrinho identificável. Para que uma mesma pessoa receba **um único fluxo** e não um por carrinho e outro por checkout, o fluxo de carrinho leva dois filtros:

1. **Gatilho**: métrica «Carrinho iniciado».
2. **Espera**: a que você quiser.
3. **Filtros do fluxo**: *«Checkout iniciado» zero vezes desde que este fluxo começou* (se chegou ao checkout, aquele fluxo cuida) **e** *«Carrinho esvaziado» zero vezes desde que este fluxo começou* (se esvaziou, não há o que recuperar). Some *«Assinatura criada» zero vezes* para cobrir uma compra direta.
4. **E-mail**: `{{ event.recovery_url }}` abre o checkout com o carrinho.

Por webhooks os tópicos são **`cart.started`** e **`cart.emptied`**.

> [!NOTE]
>
> Isto exige a versão atualizada do bloco do carrinho no tema (publicada com o app). Até a loja tê-la, os carrinhos não são registrados; os checkouts sim.

## Webhooks

O mesmo evento chega aos seus endpoints com o tópico **`checkout.started`** se você o assinar em **Integrações → Webhooks**, com as mesmas propriedades em `data`. Veja [Webhooks](https://docs.appreval.com/pt/desenvolvedores/webhooks.md).

> [!NOTE]
>
> O Shopify Flow não recebe este evento por enquanto: o gatilho «Evento de assinatura» dele é vinculado a uma assinatura, e aqui ainda não há nenhuma.


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