Configurações gerais

Este documento reúne orientações de configuração, dúvidas frequentes e comportamentos esperados da integração entre Asaas e Shopify, servindo como referência para suporte técnico e uso adequado da solução.

Configurações a serem realizadas após a instalação

1. Após a instalação, é preciso alterar a "forma de contato" apenas para e-mail.

Para o funcionamento correto do pagamento com Cartão de Crédito, o Asaas exige que o contato do cliente seja exclusivamente por e-mail.

✅ A loja deve estar configurada da seguinte forma:

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

Esta configuração é obrigatória para o correto funcionamento dos pagamentos por Cartão de Crédito. Caso outro método de contato esteja habilitado, poderão ocorrer inconsistências durante o checkout, impedindo o processamento correto da transação.

2. Ambiente: Produção x Sandbox

Durante a configuração inicial do plugin Asaas na Shopify, é obrigatório informar a chave de Produção. A chave de Sandbox é opcional e pode ser informada caso o cliente deseje realizar testes.

Para que as transações sejam processadas em ambiente de testes, é necessário ativar o "Modo de teste" nas configurações do pagamento.

O caminho da configuração é:

a. Configurações > Pagamentos > Cartão de Crédito > Gerenciar
b. Ativar a flag Modo de teste

📌 Comportamento:

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

Impactos operacionais

As configurações desta página impactam diretamente o funcionamento dos Apps Asaas na Shopify.

Antes de disponibilizar a loja em produção, valide se todas as configurações foram realizadas corretamente.

• Caso a loja não utilize apenas E-mail como forma de contato do cliente, pagamentos com Cartão de Crédito poderão apresentar inconsistências durante o checkout.
• Caso a chave de Produção não seja informada corretamente, as transações reais não serão processadas.
• Caso o Modo de teste esteja ativado utilizando apenas a chave de Produção, ou desativado sem que exista uma chave válida para o ambiente correspondente, poderão ocorrer falhas no processamento das transações.
• Antes de iniciar a operação da loja, recomenda-se realizar uma compra de teste para validar o comportamento do ambiente configurado.

Conteúdos relacionados

Consulte também:

• Shopify;
• FAQ - Shopify;
• Boleto Asaas na Shopify;
• Pix Asaas na Shopify;
• Cartão de Crédito Asaas na Shopify;
• Área de Integrações (geração de chaves de API);
• Sandbox do Asaas.