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çãoEssa 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ção | Ambiente utilizado |
|---|---|
| Modo de teste desativado | Produção |
| Modo de teste ativado | Sandbox |
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
ImportanteProduçã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
Updated 5 days ago
