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

# Carrinho Abandonado

> Formato do payload enviado no evento: Cart-Abandoned (versão 1.0)

* **Versão 1.0** = sistema antigo da Pepper (em produção até 2024)
* **Versão 2.0** = sistema atual da Pepper

<Note>Para **garantir a compatibilidade com versões anteriores** já configuradas em outras plataformas, você pode escolher entre a versão 1.0 ou 2.0. Consulte a documentação da plataforma que deseja integrar.</Note>

## Dados enviados no payload do webhook:

<ParamField path="event" type="string">
  Tipo de evento, fixado como "cart.abandoned".
</ParamField>

<ParamField path="created_at" type="string">
  Data e hora de criação no formato ISO 8601 (ex.: 2025-04-29T15:45:22+00:00).
</ParamField>

<ParamField path="abandoned_id" type="string">
  Identificador único do carrinho abandonado.
</ParamField>

<ParamField path="platform" type="string">
  Nome da empresa ou plataforma associada ao carrinho.
</ParamField>

<ParamField path="checkout_url" type="string">
  URL para a página de checkout do carrinho.
</ParamField>

<ParamField path="customer" type="object">
  Informações do cliente que abandonou o carrinho.
</ParamField>

<ParamField path="transaction" type="object">
  Detalhes da transação financeira (pode conter dados preliminares ou estar vazia).
</ParamField>

<ParamField path="offer" type="object">
  Informações sobre a oferta associada ao carrinho.
</ParamField>

<ParamField path="items" type="array">
  Lista de itens incluídos no carrinho.
</ParamField>

<ParamField path="tracking" type="object">
  Dados de rastreamento de marketing (UTM e fonte).
</ParamField>

<ParamField path="ip" type="string">
  Endereço IP do cliente (pode ser nulo).
</ParamField>

<ParamField path="fbp" type="string">
  Cookie do Facebook Pixel (fbp, pode ser nulo).
</ParamField>

<ParamField path="fbc" type="string">
  Cookie do Facebook Click ID (fbc, pode ser nulo).
</ParamField>

## Subestrutura: Customer

<ParamField path="customer.hash" type="string">
  Hash único do cliente.
</ParamField>

<ParamField path="customer.name" type="string">
  Nome completo do cliente.
</ParamField>

<ParamField path="customer.email" type="string">
  E-mail do cliente.
</ParamField>

<ParamField path="customer.phone_number" type="string">
  Número de telefone do cliente com código de país (ex.: +5511987654321).
</ParamField>

<ParamField path="customer.document" type="string">
  Documento do cliente (ex.: CPF).
</ParamField>

## Subestrutura: Transaction

<ParamField path="transaction.hash" type="string">
  Hash único da transação (pode estar vazio).
</ParamField>

<ParamField path="transaction.payment_type" type="string">
  Tipo de pagamento (ex.: "online", pode estar vazio).
</ParamField>

<ParamField path="transaction.payment_method" type="string">
  Método de pagamento (ex.: "pix", pode estar vazio).
</ParamField>

<ParamField path="transaction.payment_status" type="string">
  Status do pagamento (ex.: "pending", pode estar vazio).
</ParamField>

<ParamField path="transaction.amount" type="string">
  Valor da transação (ex.: "19990", pode estar vazio).
</ParamField>

<ParamField path="transaction.installments" type="string">
  Número de parcelas (ex.: "1", pode estar vazio).
</ParamField>

<ParamField path="transaction.payment_data" type="string">
  Dados adicionais de pagamento (ex.: JSON com código Pix, pode estar vazio).
</ParamField>

<ParamField path="transaction.created_at" type="string">
  Data de criação da transação no formato ISO 8601 (pode estar vazio).
</ParamField>

## Subestrutura: Offer

<ParamField path="offer.hash" type="string">
  Hash único da oferta.
</ParamField>

<ParamField path="offer.title" type="string">
  Título ou nome da oferta.
</ParamField>

<ParamField path="offer.payment_methods" type="array">
  Lista de métodos de pagamento aceitos (ex.: \["credit\_card", "pix"]).
</ParamField>

<ParamField path="offer.price" type="number">
  Preço da oferta (ex.: 19990).
</ParamField>

<ParamField path="offer.discount_percentage" type="number">
  Porcentagem de desconto da forma de pagamento selecionada (ex.: 10).
</ParamField>

<ParamField path="offer.price_with_discount" type="number">
  Preço da oferta com o desconto por forma de pagamento aplicado (ex.: 1990).
</ParamField>

## Subestrutura: Items

<ParamField path="items[].hash" type="string">
  Hash único do item.
</ParamField>

<ParamField path="items[].title" type="string">
  Título ou nome do item.
</ParamField>

<ParamField path="items[].price" type="number">
  Preço do item.
</ParamField>

<ParamField path="items[].quantity" type="number">
  Quantidade do item (padrão 1 se não especificado).
</ParamField>

<ParamField path="items[].cover" type="string">
  URL da imagem de capa do item.
</ParamField>

## Subestrutura: Tracking

<ParamField path="tracking.src" type="string">
  Código de origem do cliente.
</ParamField>

<ParamField path="tracking.utm_source" type="string">
  Fonte da campanha de marketing (ex.: "google").
</ParamField>

<ParamField path="tracking.utm_campaign" type="string">
  Nome da campanha de marketing (ex.: "summer\_promo").
</ParamField>

<ParamField path="tracking.utm_medium" type="string">
  Meio da campanha (ex.: "cpc").
</ParamField>

<ParamField path="tracking.utm_term" type="string">
  Termo da campanha (ex.: "premium\_plan").
</ParamField>

<ParamField path="tracking.utm_content" type="string">
  Conteúdo da campanha (ex.: "banner\_ad").
</ParamField>

## Exemplo de Payload - Abadono de carrinho

```json theme={null}
{
  "event": "cart.abandoned",
  "created_at": "2025-04-29T15:45:22+00:00",
  "abandoned_id": "cart_987654",
  "platform": "pepper",
  "checkout_url": "https://go.pepper.com.br/abc12",
  "customer": {
    "hash": "cust_a1b2c3d4e5",
    "name": "Maria Silva",
    "email": "maria.silva@example.com",
    "phone_number": "+5511987654321",
    "document": "12345678901"
  },
  "transaction": {
    "hash": "",
    "payment_type": "",
    "payment_method": "",
    "payment_status": "",
    "amount": "",
    "installments": "",
    "payment_data": "",
    "created_at": ""
  },
  "offer": {
    "hash": "offer_x9y2z",
    "title": "Plano Premium",
    "payment_methods": ["credit_card", "pix", "billet"],
    "price": 1999,
    "discount_percentage": 10,
    "price_with_discount": 1791
  },
  "items": [
    {
      "hash": "item_m5n7p2q8r3",
      "title": "Assinatura Anual Premium",
      "price": 1999,
      "quantity": 1,
      "cover": "https://picsum.photos/200/300"
    }
  ],
  "tracking": {
    "src": "src_d4e5f",
    "utm_source": "google",
    "utm_campaign": "summer_promo",
    "utm_medium": "cpc",
    "utm_term": "premium_plan",
    "utm_content": "banner_ad"
  },
  "ip": "192.168.1.1",
  "fbp": "_fbp=fb.1.1234567890.abcdef",
  "fbc": "_fbc=fb.1.1234567890.ghijkl"
}
```
