Instale o Cartão de Crédito Asaas na Shopify

Use o App Cartão de Crédito Asaas para receber pagamentos por cartão diretamente no checkout da Shopify, sem redirecionar o comprador para uma página externa.

O app permite configurar parcelamento em até 12 vezes e um valor mínimo por parcela.

Antes de começar

Você precisa:

• de uma loja Shopify;
• de uma conta Asaas;
• de uma chave de API de Produção;
• opcionalmente, de uma conta e chave de API de Sandbox para testes;
• configurar o contato do cliente na Shopify exclusivamente por e-mail.

Na Shopify, acesse:

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

Selecione apenas E-mail.

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

1. Instale o App Cartão de Crédito Asaas

Acesse o Cartão de Crédito - Asaas na Shopify App Store.

Com sua loja autenticada, clique em Instalar.

Revise as permissões solicitadas pelo app e clique novamente em Instalar para continuar.

2. Configure as chaves de API

Informe:

• Chave de API de Produção: utilizada para transações reais;
• Chave de API de Sandbox: utilizada para testes.

Produção e Sandbox possuem contas e chaves independentes. Utilize a credencial correspondente ao ambiente configurado.

Você pode utilizar a mesma chave de API nos diferentes Apps Asaas da Shopify. Para facilitar a identificação e manutenção, prefira criar chaves identificáveis, por exemplo:

Chave API Shopify Cartão

Consulte como criar e gerenciar chaves de API.

3. Configure o parcelamento

Defina:

• quantidade máxima de parcelas, limitada a 12 vezes;
• valor mínimo por parcela.

A quantidade de parcelas exibida no checkout é calculada a partir do valor total da compra e dessas duas configurações.

Por exemplo, mesmo que o limite seja 12 vezes, uma compra pode exibir menos parcelas quando as demais opções não atingirem o valor mínimo configurado.

Após configurar, clique em Salvar.

Alterações nas regras de parcelamento afetam apenas novas compras. Pedidos e pagamentos já processados não são recalculados.

4. Escolha o ambiente e ative o app

Utilize Modo de teste para definir qual ambiente processará as novas transações:

Para utilizar o Sandbox, informe uma chave de Sandbox antes de ativar o Modo de teste.

Alterar essa configuração afeta apenas novas transações.

Após definir o ambiente, ative o App Cartão de Crédito Asaas e clique em Salvar.

Resultado esperado

A opção Cartão de Crédito deve ficar disponível no checkout da Shopify.

Antes de operar em Produção, realize uma compra de teste e confirme:

• a exibição correta das parcelas;
• o processamento do pagamento;
• a atualização do pedido após uma transação aprovada.

Fluxo de pagamento

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Iniciar o checkout"] --> B["Selecionar Cartão de Crédito"]
    B --> C["Informar os dados do cartão"]
    C --> D["Enviar o pagamento ao Asaas"]
    D --> E["Aprovar a transação"]
    E --> F["Confirmar o pedido na Shopify"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D,E validacao
    class F sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

Erros comuns

Se o pagamento não funcionar como esperado, verifique se:

• a forma de contato do cliente está configurada apenas como e-mail;
• a chave de API está ativa e pertence ao ambiente selecionado;
• o Modo de teste está coerente com a chave configurada;
• o valor mínimo por parcela não está reduzindo as opções de parcelamento esperadas;
• o app está ativo na Shopify.

Para outros cenários, consulte o FAQ da integração Shopify.

Próximos passos

• Consulte as configurações gerais da Shopify
• Consulte o FAQ da integração Shopify
• Configure o Pix Asaas na Shopify
• Configure o Boleto Asaas na Shopify
• Crie e gerencie suas chaves de API