Configurações gerais da Shopify

⚙️ Integração Asaas + Shopify

Após instalar os Apps Asaas na Shopify, valide duas configurações antes de processar pagamentos:

  • a forma de contato do cliente, obrigatória para o Cartão de Crédito;
  • o ambiente utilizado pelo app, definido pelo Modo de teste.

Configure o contato do cliente para Cartão de Crédito

Para utilizar o App Cartão de Crédito Asaas, configure o contato do cliente exclusivamente por e-mail.

Na Shopify, acesse:

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

Selecione apenas E-mail.


⚠️

Atenção

Essa configuração é obrigatória para pagamentos com Cartão de Crédito.

Caso outro método de contato esteja habilitado, podem ocorrer inconsistências no checkout e o pagamento pode não ser processado corretamente.

Essa configuração não é um requisito específico dos Apps de Boleto ou Pix.

Configure Produção ou Sandbox

Durante a configuração dos Apps Asaas, informe uma chave de API de Produção.

A chave de Sandbox é opcional e deve ser configurada quando você quiser realizar transações de teste.

O ambiente utilizado depende do Modo de teste:

ConfiguraçãoAmbiente utilizado
Modo de teste desativadoProdução
Modo de teste ativadoSandbox

Para processar uma transação em Sandbox, o app precisa ter uma chave de API de Sandbox configurada e o Modo de teste ativado.

As imagens abaixo mostram essa configuração no App Cartão de Crédito:

Configurações > Pagamentos > Cartão de Crédito > Gerenciar

📘

Importante

Produção e Sandbox possuem contas e chaves de API independentes.

Ativar o Modo de teste sem uma chave de Sandbox válida pode causar falha no processamento da transação.

Consulte como criar e gerenciar chaves de API.

Valide a configuração

Antes de disponibilizar a forma de pagamento aos compradores, realize uma compra de teste.

Confirme se:

  • o app utiliza o ambiente esperado;
  • a forma de pagamento aparece no checkout;
  • a transação é processada;
  • o pedido é atualizado após a confirmação do pagamento;
  • para Cartão de Crédito, o checkout está configurado para utilizar somente e-mail como forma de contato.

Alterações no Modo de teste afetam apenas novas transações. Pedidos e pagamentos já processados não são migrados entre Sandbox e Produção.

Próximos passos


Did this page help you?