FAQ - Shopify

Esta seção reúne as principais dúvidas sobre a integração do Asaas com a Shopify, com o objetivo de apoiar a configuração e utilização da solução.

Consulte este FAQ para dúvidas que envolvem mais de um App Asaas ou comportamentos da integração que não pertencem ao passo a passo de uma forma de pagamento específica.

Para instalar ou configurar Boleto, Pix ou Cartão de Crédito, utilize o guia correspondente.

1. Posso usar uma única conta Asaas em mais de uma loja Shopify?

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

Cada loja, porém, deve ter seus Apps Asaas instalados e configurados separadamente.

🚧
Importante
Mesmo utilizando a mesma conta Asaas, as configurações de cada loja Shopify devem ser realizadas separadamente.
Isso inclui instalação dos apps, chaves de API, ambiente utilizado, configurações de parcelamento e configurações específicas de cada forma de pagamento.

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

Sim. Boleto, Pix e Cartão de Crédito utilizam Apps separados:

Instale somente as formas de pagamento que deseja disponibilizar.

Uma forma de pagamento aparece no checkout quando o respectivo app está instalado, configurado e ativo.

3. Posso usar a mesma chave de API em todos os apps?

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

Para facilitar a identificação e a manutenção, prefira chaves com nomes que indiquem onde são utilizadas.

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

A separação das chaves é uma recomendação de organização, não um requisito para o funcionamento dos apps.

🚧
Atenção
A chave de API é exibida apenas uma vez no momento da criação.
Armazene a chave em local seguro. Caso ela seja perdida, será necessário gerar uma nova chave.

Consulte como criar e gerenciar chaves de API.

4. Como funcionam Produção e Sandbox?

A chave de API de Produção é obrigatória na configuração dos Apps Shopify. A chave de Sandbox é opcional e deve ser informada quando a loja precisar realizar testes.

O ambiente utilizado depende do Modo de teste:

Configuração	Ambiente utilizado
Modo de teste desativado	Produção
Modo de teste ativado	Sandbox

Para realizar uma transação no Sandbox, configure uma chave de Sandbox e ative o Modo de teste.

🚧
Importante
Se o Modo de teste estiver ativado, mas a chave de Sandbox não tiver sido informada corretamente, as transações de teste poderão falhar.

Alterar o Modo de teste afeta apenas novas transações. Pedidos ou pagamentos já processados não são migrados entre os ambientes.

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

No Cartão de Crédito, a quantidade de parcelas exibida depende de:

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

Por isso, configurar até 12 parcelas não significa que todas serão exibidas em qualquer compra.

📘
Exemplo
Se a loja configurar parcelamento em até 12x, mas definir um valor mínimo por parcela, o checkout exibirá apenas as opções que respeitam esse valor mínimo.
Assim, uma compra de valor baixo pode exibir menos parcelas do que o limite máximo configurado.

As configurações podem ser alteradas no App Cartão de Crédito.

Alterações no parcelamento afetam apenas novas compras. Pedidos, cobranças e pagamentos já processados não são recalculados.

🚧
Importante
Após alterar as configurações de parcelamento, recomenda-se realizar uma compra de teste para validar como as opções serão exibidas no checkout da Shopify.

Consulte a configuração do Cartão de Crédito Asaas.

6. Por que o Cartão de Crédito apresenta inconsistências no checkout?

Para utilizar o App Cartão de Crédito Asaas, configure a Shopify para utilizar exclusivamente e-mail como forma de contato do cliente.

Acesse:

Configurações > Checkout > Forma de contato do cliente

Selecione somente E-mail.

❗️
Atenção
Caso a loja permita outras formas de contato além de e-mail, o pagamento com Cartão de Crédito poderá apresentar inconsistências durante o checkout.

Consulte as configurações gerais da integração Shopify.

7. Preciso cadastrar uma chave Pix para utilizar Pix na Shopify?

Sim. Cadastre uma chave Pix na conta Asaas em:

Pix > Minhas Chaves

❗️
Atenção
Caso a conta não possua chave Pix cadastrada, a compensação das cobranças pode ocorrer de forma tardia, impactando a confirmação do pedido na Shopify.

Após a confirmação do pagamento via Pix, o pedido é atualizado conforme o fluxo da integração.

Se isso não ocorrer, confirme se:

a chave Pix está cadastrada;
o App Pix está ativo;
a chave de API está correta;
o ambiente configurado é o esperado.

Consulte a configuração do Pix Asaas.

8. O Boleto pode apresentar Pix como opção de pagamento?

Sim. Em alguns cenários, a fatura do Asaas aberta pelo App Boleto também pode permitir o pagamento por Pix quando a conta possui uma chave Pix cadastrada.

📘
Importante
Se a intenção da loja for oferecer Pix diretamente no checkout da Shopify, utilize também o App Pix Asaas.

Boleto e Pix continuam sendo Apps separados no checkout.

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

Verifique:

Situação	O que conferir
Forma de pagamento não aparece	Se o app correspondente está instalado e ativo
Transação de teste falha	Se o `Modo de teste` está ativo e existe uma chave de Sandbox válida
Pix não confirma como esperado	Se existe uma chave Pix cadastrada
Cartão apresenta inconsistência	Se o contato do cliente está configurado somente como e-mail
Menos parcelas são exibidas	Se o valor mínimo por parcela está restringindo as opções
Erro de autenticação	Se a chave está ativa e pertence ao ambiente utilizado

Se o problema estiver relacionado a uma forma de pagamento específica, consulte o respectivo guia de instalação antes de alterar outras configurações da loja.

10. Como funcionam estornos e reembolsos?

Os Apps Asaas para Shopify suportam estornos e reembolsos conforme a forma de pagamento e o fluxo disponível na Shopify ou no Asaas.

A conclusão pode depender do meio de pagamento e do processamento necessário. Não considere a conciliação concluída apenas porque a solicitação de estorno foi iniciada.

Ao consultar uma cobrança pela API do Asaas, considere o estorno concluído quando o item correspondente no array refunds retornar status igual a DONE.

Consulte como interpretar estornos.

O que validar após instalar ou alterar um app

🚧
Atenção
Antes de ativar a operação em Produção, realize uma compra de teste para validar se a forma de pagamento aparece corretamente no checkout e se o pedido é atualizado após a confirmação do pagamento.

Após uma instalação ou alteração relevante, confirme:

se a forma de pagamento aparece no checkout;
se Produção ou Sandbox está configurado corretamente;
se a transação é processada;
se o pedido é atualizado após o pagamento;
no Cartão de Crédito, se as parcelas aparecem conforme configurado;
no Pix, se a chave Pix da conta está cadastrada.

Próximos passos

Updated 9 days ago

Did this page help you?