Passar para o conteúdo principal

Como Integrar Yampi com Shopify via API (checkout externo)

Aprenda a integrar a Yampi com a Shopify criando um app privado no painel da Shopify e conectando as credenciais na Yampi. Com essa configuração, o checkout da Yampi passa a se comunicar corretamente com sua loja Shopify de forma segura e estável.

🧭 Quando usar

  • Ao usar Shopify como vitrine e Yampi como checkout

  • Ao configurar integração manual via API

  • Quando o app padrão não resolve a conexão

  • Ao precisar de mais controle sobre pedidos, produtos e temas


✅ Pré-requisitos

  • Loja ativa na Shopify

  • Conta ativa na Yampi

  • Acesso de administrador em ambas as plataformas

  • Loja já criada (mesmo sem produtos)


🛠️ Passo a passo

Passo 1 – Acessar área de apps na Shopify

  1. No painel da Shopify, vá em Configurações » Apps e canais de venda.

  2. Clique em Desenvolver apps.

  3. Se for a primeira vez, aceite os termos da Shopify.


Passo 2 – Criar um novo app

  1. Clique em Criar app.

  2. Dê um nome para o app, por exemplo: Checkout Yampi.

  3. Crie o app e aguarde ele aparecer na lista.


Passo 3 – Configurar permissões da API (Admin API Scopes)

  1. Dentro do app criado, clique em Configurar Admin API Scopes.

  2. Marque as permissões abaixo:

Orders

  • read_orders

  • write_orders

Products

  • read_products

  • write_products

Themes

  • read_themes

  • write_themes

  1. Clique em Salvar.


Passo 4 – Instalar o app e gerar credenciais

  1. Ainda dentro do app, clique em API Credentials.

  2. Clique em Install App.

  3. A Shopify vai gerar automaticamente:

    • Admin API Access Token

    • API Key

    • API Secret Key

  4. Copie esses dados (você vai usar na Yampi).


Passo 5 – Instalar o app da Shopify na Yampi

  1. Acesse o painel da Yampi.

  2. Vá em Apps.

  3. Procure por Shopify.

  4. Clique em Instalar app.


Passo 6 – Conectar Shopify com Yampi

  1. No app da Shopify dentro da Yampi, preencha:

    • URL da loja Shopify (ex.: https://sualoja.myshopify.com)

  2. Em Token de acesso, cole o Admin API Access Token.

  3. Em Chave da API, cole a API Key.

  4. Em Secret, cole a API Secret Key.

  5. Configure as opções de pedidos (baixa de estoque, status, etc.).

  6. Clique em Salvar.


Passo 7 – Finalizar integração

  1. Após salvar, a integração fica ativa automaticamente.

  2. A Yampi passa a se comunicar direto com a Shopify.

  3. Pedidos feitos no checkout da Yampi serão refletidos na Shopify.


🧩 Exemplos práticos

  • Exemplo 1: Shopify exibindo produtos + Yampi processando pagamentos.

  • Exemplo 2: Pedido aprovado na Yampi aparecendo automaticamente na Shopify.

  • Exemplo 3: Integração usada para escalar tráfego com checkout otimizado.


🧪 Solução de problemas

  • Erro/Sintoma: Integração não conecta.
    ​Causa provável: Permissões da API incompletas.
    ​Como resolver: Revisar se orders, products e themes estão com leitura e escrita.

  • Erro/Sintoma: Pedido não aparece na Shopify.
    ​Causa provável: Token incorreto ou app não instalado.
    ​Como resolver: Reinstalar o app e gerar novo token.

  • Erro/Sintoma: Erro ao salvar credenciais.
    ​Causa provável: URL da loja incorreta.
    ​Como resolver: Usar exatamente o domínio myshopify.com.


🔎 Referências e links úteis


🗂️ Metadados

  • Categoria: Integrações

  • Subcategoria: Yampi + Shopify

  • Tags: yampi, shopify, integração, api, checkout externo

  • Nível: intermediário

  • Atualizado em: 2026-01-22

Respondeu à sua pergunta?