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

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# MiniCart

> Componente de carrinho que alterna automaticamente entre modo dropdown e drawer lateral com base na configuração.

Ponto de entrada do carrinho no header. Renderiza o `DropdownCart` ou o `SideCart` dependendo do valor de `cartType`. É o componente recomendado para incluir o carrinho em templates customizados de header.

## Uso

Carrinho dropdown (padrão):

```twig theme={"system"}
<mini-cart
  cart-type="suspended"
  :show-cart-savings="true"
  :show-product-cart-savings="true"
  empty-cart-helper-text="Seu carrinho está vazio."
  empty-cart-text-button="Explorar produtos"
  empty-cart-link-button="/produtos"
  highlighted-price="pix"
  :cashbacks="{{ cashbacks | json_encode }}"
/>
```

Carrinho lateral (side cart):

```twig theme={"system"}
<mini-cart
  cart-type="side_cart"
  empty-cart-text-button="Explorar produtos"
/>
```

## Propriedades

| Propriedade              |    Tipo   | Obrigatória |                Valor padrão                | Descrição                                                                                          |
| :----------------------- | :-------: | :---------: | :----------------------------------------: | :------------------------------------------------------------------------------------------------- |
| `emptyCartTextButton`    |  `String` |      ✅      |                      —                     | Texto do botão exibido quando o carrinho está vazio.                                               |
| `cartType`               |  `String` |      ❌      |                `'suspended'`               | Tipo de exibição do carrinho. Valores: `'suspended'` (dropdown) ou `'side_cart'` (drawer lateral). |
| `showCartSavings`        | `Boolean` |      ❌      |                   `true`                   | Exibe o resumo de economia total no rodapé do carrinho.                                            |
| `showProductCartSavings` | `Boolean` |      ❌      |                   `true`                   | Exibe a economia individual de cada produto no carrinho.                                           |
| `emptyCartHelperText`    |  `String` |      ❌      | `'Navegue pela loja e adicione produtos.'` | Texto descritivo exibido quando o carrinho está vazio.                                             |
| `emptyCartLinkButton`    |  `String` |      ❌      |                    `''`                    | URL de destino do botão exibido no carrinho vazio.                                                 |
| `highlightedPrice`       |  `String` |      ❌      |                    `''`                    | Destaca o preço de um método de pagamento específico. Valores: `'pix'`, `'billet'` ou `''`.        |
| `cashbacks`              |  `Array`  |      ❌      |                    `[]`                    | Lista de cashbacks ativos para exibição no carrinho.                                               |