FAQ - Shopify

Este FAQ reúne dúvidas frequentes sobre a integração entre o Asaas e a Shopify, com foco na configuração dos Apps de Pagamento, comportamento do checkout, uso dos ambientes de Produção e Sandbox, ajustes operacionais após a instalação e cuidados para evitar falhas no processamento dos pedidos.

A Shopify permite que lojistas criem e gerenciem lojas virtuais, enquanto os Apps do Asaas permitem processar vendas por Boleto, Pix e Cartão de Crédito diretamente no fluxo de compra da loja.

Cada forma de pagamento possui um app próprio e pode ser instalada individualmente, conforme a necessidade da operação.

Quando utilizar este FAQ

Utilize esta página quando precisar esclarecer dúvidas sobre:

• configuração dos Apps do Asaas na Shopify;
• ajuste de parcelamento no Cartão de Crédito;
• uso de Produção e Sandbox;
• requisitos para funcionamento correto do checkout;
• instalação dos apps de Boleto, Pix e Cartão de Crédito;
• uso de uma mesma conta Asaas em mais de uma loja Shopify;
• impacto das configurações no checkout e na confirmação dos pedidos;
• cuidados após alterações em chaves, ambiente ou formas de pagamento.

Para o passo a passo completo de instalação de cada app, consulte também as páginas específicas de Shopify na documentação.

Regras importantes da integração

Antes de configurar os Apps do Asaas na Shopify, considere que:

• cada forma de pagamento possui um app próprio;
• a chave de API de Produção é obrigatória na configuração dos apps;
• a chave de API de Sandbox é opcional e deve ser usada apenas para testes;
• o ambiente utilizado depende da configuração de Modo de teste no app;
• para pagamentos via Pix, é necessário possuir uma chave Pix cadastrada na conta Asaas;
• para pagamentos com Cartão de Crédito, a loja deve estar configurada para contato do cliente exclusivamente por e-mail;
• alterações nas configurações afetam apenas novas compras realizadas após a atualização;
• reembolsos e estornos devem ser acompanhados no painel da Shopify e na conta Asaas para garantir a conciliação correta.

Configurações e parâmetros importantes

Durante a instalação e manutenção dos Apps Asaas na Shopify, algumas configurações impactam diretamente o comportamento da integração:

1. É possível ajustar o número de parcelas no cartão?

Sim. O ajuste pode ser feito diretamente no App de Cartão de Crédito dentro da Shopify.

Caminho:

• Configurações > Apps > Cartão de Crédito – Asaas
• Abrir o app
• Ajustar as configurações de parcelamento
• Salvar as alterações

Essa tela é a mesma exibida durante a instalação do app e permite configurar:

• quantidade máxima de parcelas;
• valor mínimo por parcela.

A quantidade de parcelas exibida ao comprador será calculada automaticamente com base nessas configurações e no valor total da compra.

2. Alterar o parcelamento afeta pagamentos já realizados?

Não. A alteração das regras de parcelamento afeta apenas novas compras realizadas após a atualização da configuração.

Pagamentos já concluídos, pedidos já criados e cobranças já processadas não são recalculados automaticamente.

3. Quais cuidados devo ter ao configurar parcelas?

Antes de definir a quantidade máxima de parcelas e o valor mínimo por parcela, avalie:

• ticket médio da loja;
• política comercial da operação;
• impacto das parcelas na conversão;
• valor mínimo aceitável por parcela;
• experiência esperada no checkout;
• custo financeiro da operação;
• comunicação comercial exibida ao comprador.

Evite configurar um valor mínimo por parcela muito alto, pois isso pode reduzir a quantidade de opções exibidas ao comprador.

Também evite configurar um valor mínimo muito baixo sem avaliar os impactos financeiros da operação.

4. Por que aparecem menos parcelas do que o limite configurado?

A quantidade de parcelas exibida no checkout depende da combinação entre:

• valor total da compra;
• quantidade máxima de parcelas configurada;
• valor mínimo por parcela definido no app.

Por exemplo, se a loja permitir até 12 parcelas, mas a compra tiver valor baixo, o checkout poderá exibir menos opções para respeitar o valor mínimo por parcela.

Esse comportamento é esperado e não representa falha no app.

5. É possível usar uma única conta Asaas em mais de uma loja Shopify?

Sim. Uma mesma conta Asaas pode ser utilizada para integrar mais de uma loja Shopify.

Nesse cenário, cada loja deve ter seus Apps do Asaas instalados e configurados individualmente.

6. Cada forma de pagamento precisa de um app próprio?

Sim. O Asaas disponibiliza apps separados para cada forma de pagamento na Shopify:

• App de Boleto;
• App de Pix;
• App de Cartão de Crédito.

Você pode instalar apenas a forma de pagamento desejada ou instalar todos os apps para oferecer uma experiência mais completa no checkout.

7. Posso instalar apenas um app de pagamento?

Sim. Cada app pode ser instalado individualmente.

Por exemplo, a loja pode optar por oferecer apenas Pix, apenas Cartão de Crédito, apenas Boleto ou combinar as três formas de pagamento.

A forma de pagamento será exibida no checkout somente quando o app correspondente estiver instalado, configurado e ativo.

8. É obrigatório informar chave de API de Produção?

Sim. Durante a configuração dos Apps do Asaas na Shopify, é obrigatório informar a chave de API de Produção.

A chave de Sandbox é opcional e deve ser informada apenas quando a loja desejar realizar testes antes de operar em produção.

9. Posso usar a mesma chave de API para todos os apps?

É possível utilizar a mesma chave de API, desde que ela pertença à conta Asaas correta e esteja válida.

No entanto, para facilitar a identificação e a manutenção da integração, recomenda-se criar chaves identificáveis para cada app instalado.

Exemplos:

Chave API - Shopify Boleto
Chave API - Shopify Pix
Chave API - Shopify Cartão

Essa prática ajuda a rastrear qual credencial está sendo utilizada em cada forma de pagamento.

10. Como funciona o ambiente de Produção e Sandbox?

O ambiente utilizado depende da configuração de Modo de teste no app de pagamento da Shopify.

• Modo de teste desativado: as transações utilizam a chave de Produção.
• Modo de teste ativado: as transações utilizam a chave de Sandbox.

Para processar transações de teste, é necessário:

• informar a chave de API de Sandbox no app;
• ativar o Modo de teste nas configurações do pagamento.

11. Alterar o Modo de teste afeta pedidos já criados?

Não. A alteração do Modo de teste afeta apenas novas transações realizadas após a mudança.

Pedidos já criados ou pagamentos já processados não são migrados automaticamente entre ambientes.

Por isso, antes de iniciar a operação real da loja, confirme se o app está com o Modo de teste desativado e utilizando a chave de Produção correta.

12. É necessário configurar a forma de contato do cliente?

Sim. Para o correto funcionamento do pagamento com Cartão de Crédito, a loja deve estar configurada para contato do cliente exclusivamente por e-mail.

Caminho:

• Configurações > Checkout > Forma de contato do cliente
• Selecionar apenas E-mail

Essa configuração evita inconsistências no fluxo de pagamento e garante que os dados necessários sejam enviados corretamente durante o checkout.

13. Preciso ter chave Pix cadastrada para usar Pix na Shopify?

Sim. Para disponibilizar Pix na Shopify, é necessário possuir uma chave Pix cadastrada na conta Asaas.

O cadastro pode ser realizado no painel do Asaas em:

• Pix > Minhas Chaves

14. O pagamento por Pix confirma automaticamente o pedido?

Sim. Após a confirmação do pagamento via Pix, o pedido deve ser atualizado conforme o fluxo da Shopify e da integração com o Asaas.

No entanto, se a conta não possuir uma chave Pix cadastrada ou houver atraso na compensação, a confirmação do pedido poderá ser impactada.

Por isso, antes de ativar Pix na loja, valide:

• se a chave Pix está cadastrada;
• se o app Pix está ativo;
• se a chave de API está correta;
• se o ambiente configurado é o esperado;
• se uma compra de teste atualiza o pedido corretamente.

15. O Boleto pode exibir opção de pagamento por Pix?

Em alguns cenários, a fatura do Asaas gerada a partir do pagamento por Boleto também pode permitir pagamento via Pix, desde que a conta Asaas possua uma chave Pix cadastrada.

Esse comportamento pode agilizar a confirmação do pagamento, pois o cliente pode optar por pagar a fatura utilizando Pix.

16. O Asaas suporta reembolsos e estornos na Shopify?

Sim. Os Apps do Asaas para Shopify oferecem suporte a reembolsos e estornos, conforme a forma de pagamento utilizada e o fluxo disponível no painel da loja ou no Asaas.

Após realizar um estorno ou reembolso, recomenda-se acompanhar o status no painel da Shopify e na conta Asaas para garantir que a conciliação do pedido esteja correta.

17. Estornos e reembolsos são concluídos imediatamente?

Depende da forma de pagamento utilizada e do fluxo de processamento.

Alguns meios de pagamento podem ter processamento mais rápido, enquanto outros dependem de prazos bancários, validações ou etapas adicionais.

A integração deve acompanhar o status do pedido na Shopify e o status da cobrança no Asaas antes de considerar a conciliação concluída.

18. Por que uma forma de pagamento não aparece no checkout?

A ausência de uma forma de pagamento no checkout pode ocorrer por diferentes motivos, como:

• app correspondente não instalado;
• app instalado, mas não ativado;
• chave de API inválida ou ausente;
• ambiente configurado incorretamente;
• Modo de teste incompatível com a chave informada;
• configuração obrigatória pendente;
• inconsistência nas configurações da Shopify.

Nesses casos, revise a instalação do app, as chaves configuradas, o ambiente selecionado e as configurações específicas da forma de pagamento.

19. Posso alterar as configurações dos apps a qualquer momento?

Sim. As configurações dos apps podem ser alteradas após a instalação.

No entanto, alterações em chaves, ambiente, parcelamento ou formas de pagamento devem ser testadas antes de períodos de alto volume de vendas.

Essas alterações afetam apenas novas compras realizadas após a atualização.

20. O que validar após instalar ou alterar um app?

Após instalar ou alterar qualquer App Asaas na Shopify, recomenda-se validar:

• se a forma de pagamento aparece no checkout;
• se a chave de API está correta;
• se o ambiente configurado é o esperado;
• se o Modo de teste está coerente com a chave utilizada;
• se o pedido é criado corretamente;
• se o pagamento é confirmado;
• se o pedido é atualizado na Shopify;
• se reembolsos ou estornos seguem o comportamento esperado;
• se o parcelamento aparece conforme configurado, no caso de Cartão de Crédito.

Boas práticas de configuração

Após instalar ou alterar qualquer App do Asaas na Shopify, recomenda-se:

• conferir se a chave de API foi informada no ambiente correto;
• validar se o Modo de teste está coerente com a chave utilizada;
• realizar uma compra de teste antes de ativar a operação em produção;
• revisar as configurações de parcelamento do Cartão de Crédito;
• confirmar se a chave Pix está cadastrada, caso utilize Pix;
• validar se o checkout apresenta corretamente as formas de pagamento desejadas;
• evitar alterações durante campanhas ou períodos de alto volume;
• armazenar as chaves de API em local seguro;
• documentar internamente quais apps estão instalados e quais chaves são utilizadas.

Erros comuns

Alguns problemas comuns na integração entre Asaas e Shopify incluem:

Impactos operacionais

Alterações nas configurações dos Apps do Asaas podem impactar diretamente a experiência de compra do cliente.

Configurações incorretas podem causar:

• ausência da forma de pagamento no checkout;
• exibição de menos parcelas do que o esperado;
• falhas em transações de teste;
• uso indevido de ambiente de Produção ou Sandbox;
• atraso na confirmação de pedidos pagos via Pix, caso não exista chave Pix cadastrada;
• inconsistências no processamento de Cartão de Crédito;
• divergência entre o status do pedido na Shopify e a cobrança no Asaas;
• necessidade de atendimento manual ao comprador.

Por isso, qualquer alteração deve ser validada antes de períodos de alto volume de vendas ou campanhas comerciais.

Conteúdos relacionados

Consulte também:

• Shopify;
• App de Boleto na Shopify;
• App de Pix na Shopify;
• App de Cartão de Crédito na Shopify;
• Configurações gerais da integração Asaas + Shopify;
• Estornos;
• Split de Pagamentos, quando aplicável à operação.