Configurações gerais

⚙️ Integração Asaas + Shopify

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 email.

Para funcionamento correto do pagamento com cartão, 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”

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 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 de Modo 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