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

# Checkout da AbacatePay na Shopify

> Como instalar o checkout da AbacatePay na sua loja Shopify (passo a passo)

Com o plugin Shopify, o botão de finalizar compra da sua loja leva o cliente ao checkout da AbacatePay. O cliente informa os dados e paga com Pix ou cartão. Depois do pagamento, o pedido aparece pago em **Orders** na Shopify.

> [!TIP]
>
> Este guia **não exige código**. Você só copia e cola valores entre a Shopify e o dashboard da AbacatePay. Reserve uns 15 minutos.

***

## Como funciona a integração

* O checkout da AbacatePay **substitui o checkout da Shopify**. O script que você cola no tema leva o cliente direto do carrinho para a AbacatePay.
* **Preços e estoque vêm da Shopify.** Na hora da compra, a AbacatePay consulta na Shopify o preço atual de cada produto do carrinho e se ele está disponível. O cliente não consegue mudar o preço pelo navegador.
* **O pedido é criado na Shopify depois do pagamento.** Ele chega pago, com os produtos e o cliente. Com a opção **Atualizar estoque** ligada, o estoque dos produtos vendidos é baixado.
* **Os botões de compra expressa ficam ocultos.** Botões como **Comprar agora**, Shop Pay e outras carteiras levariam o cliente ao checkout da Shopify, então o script os esconde.

***

## O que você vai precisar

* Uma conta na AbacatePay ([criar conta grátis](https://app.abacatepay.com)). Para vender de verdade, sua conta precisa estar verificada, veja [Indo para produção](https://docs.abacatepay.com/pages/production.md).
* Uma loja Shopify **em reais (BRL)**.
* Acesso de dono da loja, ou de um colaborador que possa criar apps e editar o tema.

> [!WARNING]
>
> Deixe a **Shopify e a AbacatePay logadas no mesmo navegador** durante a instalação. A instalação termina redirecionando de uma para a outra.

***

## Passo a passo

**1. Acesse o Dev Dashboard da Shopify**

1. No admin da Shopify, clique em **Configurações** (canto inferior esquerdo).
2. Abra **Apps** e clique em **Desenvolver apps**.
3. Escolha **Criar apps no Dev Dashboard**.

> [!NOTE]
>
> Se a Shopify pedir, crie uma organização em **Shopify Partners**: informe o Brasil como local e os dados da sua empresa.

**2. Crie o app**

1. No Dev Dashboard, clique em **Criar app** e dê um nome, por exemplo **AbacatePay Checkout**.
2. Em **URLs**, preencha:
   * **App URL**: `https://dash.abacatepay.com/shopify/app`
   * **Redirect URLs**: `https://dash.abacatepay.com/shopify/oauth/callback`
3. Deixe **desmarcada** a opção **Embed app in Shopify admin**.
4. Em **Access**, cole no campo **Scopes**:

```text theme={null}
read_products,read_orders,write_orders,read_inventory,write_inventory,write_draft_orders
```

5. Role até o final e clique em **Release**. Na janela de confirmação, clique em **Release** de novo.

> [!WARNING]
>
> Cole as URLs e os escopos **exatamente como estão aqui**. Se faltar um escopo, a instalação para com o aviso "Faltam os escopos …". Não altere nada nas seções **POS** e **App Proxy**.

**3. Peça acesso aos dados do cliente**

No app, solicite o acesso a **Protected customer data** e marque **nome**, **e-mail** e **endereço**.

A AbacatePay usa esses dados para criar o pedido em nome do cliente e para conferir que o pedido foi criado.

> [!WARNING]
>
> Sem esse acesso, o pedido pode ser criado na Shopify sem que a AbacatePay consiga confirmar a criação.

**4. Conecte a loja na AbacatePay**

1. No app do Dev Dashboard, abra **Configurações** e copie o **Client ID** e o **Client Secret**.
2. No dashboard da AbacatePay, acesse **Integração → Plugins → Shopify**.
3. Preencha:
   * **URL da loja**: o domínio `sua-loja.myshopify.com`
   * **Client ID** e **Client Secret** que você copiou
   * **Métodos de pagamento**: Pix, Cartão de crédito ou os dois
   * **Atualizar estoque**: ligado, cada pedido pago baixa na Shopify o estoque dos produtos vendidos. Desligue se você controla o estoque por outro sistema.
4. Clique em **Salvar**. O status muda para **Aguardando instalação do app na Shopify**.

> [!WARNING]
>
> A conexão vale para o modo em que você está no dashboard. Conecte a loja com o **Dev mode desligado** para vender de verdade: uma loja Shopify conectada fica presa àquela conta e àquele modo.

> [!WARNING]
>
> Use o domínio **`.myshopify.com`** gerado pela Shopify, que fica em **Configurações → Domínios**. O domínio próprio da sua loja (por exemplo, `minhaloja.com.br`) não funciona aqui.

> [!NOTE]
>
> O **Client Secret** é a chave do seu app. Não compartilhe. Se trocar o Client ID depois, informe o Client Secret de novo.

**5. Instale o app na loja**

1. No Dev Dashboard, abra **Distribution** e escolha **Custom distribution**.
2. Informe o mesmo domínio `.myshopify.com` e gere o link de instalação.
3. Abra o link numa nova aba e clique em **Instalar**.

Ao aprovar, você volta para a página do plugin na AbacatePay com a mensagem **Loja conectada à AbacatePay**, e o status muda para **Loja conectada**.

> [!NOTE]
>
> Salve a loja na AbacatePay (passo 4) **antes** de instalar. Se instalar antes, aparece o aviso "Esta loja ainda não está configurada no plugin". Basta salvar e abrir o link de instalação de novo.

**6. Adicione o checkout ao tema**

1. No admin da Shopify, acesse **Loja virtual → Temas**, clique em **⋯** no tema publicado e depois em **Editar código**.
2. Abra o arquivo `layout/theme.liquid`.
3. Cole esta linha logo antes de `</body>` e clique em **Salvar**:

```html theme={null}
<script src="https://dash.abacatepay.com/shopify/storefront.js?shop={{ shop.permanent_domain }}" defer></script>
```

A mesma linha aparece pronta para copiar na página do plugin.

> [!WARNING]
>
> O script fica no tema. Se você **trocar de tema** ou publicar outro, cole a linha de novo no `theme.liquid` do tema novo.

**7. Personalize o checkout (opcional)**

No dashboard da AbacatePay, acesse **Personalizar checkout** e escolha o layout **Shopify**. Ele mostra contato e pagamento numa página só, com o resumo do pedido ao lado.

Você pode ajustar a **logo**, a **cor do botão** e o **texto do rodapé**.

**8. Faça um pedido de teste**

1. Na sua loja, adicione um produto ao carrinho e clique em **Finalizar compra**. Você deve cair no checkout da AbacatePay.
2. Preencha seus dados e pague.
3. Em poucos segundos, o pedido aparece pago em **Pedidos** na Shopify.

> [!TIP]
>
> Se a loja foi conectada com o [Dev mode](https://docs.abacatepay.com/pages/devmode.md) ligado, o pagamento é simulado e o pedido entra na Shopify marcado como **teste**.

Pronto! Sua loja Shopify já vende com o checkout da AbacatePay. 🥑

***

## Considerações finais

* **Teste antes de divulgar.** Faça um pedido completo antes de mandar tráfego para a loja.
* **Cupons e descontos da Shopify** não são aplicados no checkout da AbacatePay. O cliente paga o preço do produto na Shopify.
* **Não remova escopos** nem desinstale o app depois da instalação. Sem acesso, a AbacatePay não consegue criar os pedidos pagos.
* O pedido criado pela AbacatePay leva a tag `abacatepay`, e o pagamento aparece com o gateway **AbacatePay**.

> [card] Precisa de ajuda?
>
> Nossa equipe pode ajudar na integração com a Shopify. Entre em contato pelo e-mail  [ajuda@abacatepay.com](mailto:ajuda@abacatepay.com)


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