Como conectar a Shopify ao Plasma
Crie o app da sua loja na Shopify, marque as permissões e conecte ao Plasma por OAuth para levar o comprador ao checkout transparente.
Como a integração funciona
A Shopify se conecta ao Plasma por um app personalizado criado na sua própria loja. Você cria o app, marca as permissões que o Plasma precisa e informa no painel as duas chaves dele. O Plasma então pede a autorização pela Shopify (OAuth) e recebe o acesso sozinho. Nada disso passa pela App Store da Shopify.
Depois de conectada, a loja passa a:
- sincronizar produtos, variantes, estoque e pedidos com o Plasma;
- ter os webhooks registrados automaticamente, sem você cadastrar nenhum;
- levar o comprador do botão de finalizar compra para o checkout do Plasma.
Apps criados a partir de 2026
Desde 1º de janeiro de 2026, a Shopify cria apps personalizados novos pelo Dev Dashboard. O caminho continua começando no admin da sua loja, que leva você até lá. Apps criados antes dessa data seguem funcionando no admin.
Passo a passo
Crie o app na Shopify
- No admin da Shopify, abra Configurações e depois Apps (Apps e canais de vendas).
- Clique em Desenvolver apps. Se a Shopify mostrar a opção de criar o app no Dev Dashboard, siga por ela.
- Crie um app com o nome
Plasma Checkout.
Configure as URLs do app
Nas configurações do app, preencha os dois endereços abaixo.
URL do app (App URL)
https://app.plasmacheckout.com/loja/aplicativos/shopifyURL de redirecionamento (Redirect URL)
https://app.plasmacheckout.com/api/auth/shopify/callbackDesmarque a opção Incorporar app no admin da Shopify (Embed app in Shopify admin). Com ela ligada, a conexão não abre do jeito certo.
Marque as permissões (escopos)
Nas permissões da API Admin do app, marque todos estes escopos:
read_customers, write_customers, read_orders, write_orders, read_products, write_products, read_inventory, read_themes, write_themes, read_discounts, read_price_rulesSalve. No Dev Dashboard, publique a versão do app para as URLs e os escopos passarem a valer.
Copie as credenciais
Nas credenciais do app, copie a Chave de API (Client ID) e a Chave secreta da API (Client secret). Guarde as duas para o próximo passo.
Conecte no painel do Plasma
- No painel do Plasma, abra Aplicativos e escolha Shopify.
- Em URL da loja, informe o endereço
.myshopify.comda loja (por exemplominhaloja.myshopify.com), semhttps://, semwwwe sem domínio.com.br. - Cole a Chave de API e a Chave secreta da API.
- Clique em Conectar com Shopify e confirme a instalação na tela da Shopify.
Você volta ao Plasma com a loja conectada. O Token de acesso da API Admin é preenchido sozinho pelo OAuth, e o catálogo começa a sincronizar em segundo plano.
Configurações avançadas
Na mesma tela da Shopify no Plasma, três chaves ajustam como o comprador chega ao checkout:
- Interceptar todos os Ajax Carts: força o redirecionamento quando o tema adiciona ao carrinho por
/cart/adde o botão não leva ao Plasma. - Interceptar eventos do Cart Drawer: bloqueia a gaveta de carrinho do tema na origem, para temas que disparam eventos próprios.
- Pular carrinho: leva o comprador direto ao checkout, sem passar pela página de carrinho.
Problemas comuns
A Shopify recusa a autorização. Quase sempre falta um escopo. O Plasma pede exatamente a lista do passo 3, e a Shopify recusa a tela de autorização se o app não declara algum deles. Marque a lista inteira, salve e conecte de novo.
Acrescentei um escopo depois e nada mudou. A permissão da Shopify fica presa ao token emitido na conexão. Depois de marcar o escopo novo, desconecte a Shopify no Plasma e conecte outra vez para gerar um token com a permissão.
O botão de comprar continua indo para o checkout da Shopify. Ligue Interceptar todos os Ajax Carts e, se o tema usa gaveta de carrinho, Interceptar eventos do Cart Drawer.
Não acho "Desenvolver apps". Só o dono da loja ou um colaborador com permissão de desenvolver apps vê essa opção.