Shopify
A Shopify é uma plataforma de e-commerce que permite criar, configurar e gerenciar lojas virtuais.
O Asaas disponibiliza Apps de Pagamento para Shopify, permitindo que lojas processem vendas por Boleto, Pix e Cartão de Crédito utilizando o gateway de pagamento do Asaas.
Cada forma de pagamento possui um app próprio e pode ser instalada individualmente, conforme a necessidade da operação da loja.
Quando utilizar
Utilize a integração entre Asaas e Shopify quando sua loja precisar:
- oferecer Boleto, Pix ou Cartão de Crédito no checkout da Shopify;
- processar pagamentos pelo gateway do Asaas;
- centralizar recebimentos na conta Asaas;
- permitir reembolsos e estornos conforme a forma de pagamento utilizada;
- configurar pagamentos parcelados no cartão de crédito;
- utilizar uma experiência de checkout integrada à loja.
Essa integração é indicada para lojistas que desejam operar pagamentos na Shopify sem desenvolver uma integração própria com a API do Asaas.
Apps de pagamento disponíveis
O Asaas fornece três Apps de Pagamento para Shopify:
| App | Quando utilizar |
|---|---|
| Boleto Asaas | Para lojas que desejam oferecer pagamento por boleto bancário |
| Pix Asaas | Para lojas que desejam oferecer pagamento instantâneo por Pix |
| Cartão de Crédito Asaas | Para lojas que desejam aceitar pagamentos com cartão, incluindo parcelamento |
Você pode instalar apenas uma forma de pagamento ou instalar todos os apps para oferecer uma experiência mais completa ao comprador.
Diferença entre os apps
Boleto
O app de Boleto Asaas deve ser utilizado quando a loja deseja disponibilizar boleto bancário no checkout.
Após selecionar essa opção, o comprador é direcionado para a fatura do Asaas, onde poderá copiar a linha digitável ou baixar o boleto.
Em alguns cenários, a fatura também pode permitir pagamento via Pix, desde que a conta Asaas possua uma chave Pix cadastrada.
Pix
O app de Pix Asaas deve ser utilizado quando a loja deseja oferecer pagamento por Pix no checkout.
Após selecionar essa opção, o comprador é direcionado para a fatura do Asaas para realizar o pagamento. Após a confirmação, o pedido é atualizado conforme o fluxo da Shopify.
AtençãoPara utilizar Pix na Shopify, é necessário possuir uma chave Pix cadastrada na conta Asaas.
Caso a conta não possua chave Pix cadastrada, a compensação das cobranças pode ocorrer de forma tardia, impactando a confirmação do pedido na Shopify.
Cartão de Crédito
O app de Cartão de Crédito Asaas deve ser utilizado quando a loja deseja aceitar pagamentos com cartão diretamente no checkout da Shopify.
Essa opção permite configurar parcelamento, quantidade máxima de parcelas e valor mínimo por parcela.
Para o funcionamento correto do pagamento com cartão, a loja deve estar configurada para contato do cliente exclusivamente por e-mail.
Fluxo geral da integração
O fluxo de configuração dos Apps Asaas na Shopify normalmente segue as etapas abaixo:
Escolher a forma de pagamento desejada
↓
Instalar o app correspondente na Shopify
↓
Informar a chave de API do Asaas
↓
Configurar ambiente de Produção ou Sandbox
↓
Ajustar configurações específicas do app
↓
Ativar o app na Shopify
↓
Realizar uma compra de teste
↓
Disponibilizar a forma de pagamento no checkoutCada app possui configurações próprias, detalhadas nas páginas específicas de Boleto, Pix e Cartão de Crédito.
Informações importantes para configuração
Durante a instalação dos Apps Asaas, alguns dados e configurações são essenciais para o funcionamento correto da integração.
| Configuração | Função |
|---|---|
| Chave de API de Produção | Obrigatória para processar transações reais |
| Chave de API de Sandbox | Opcional, utilizada para testes |
| Modo de teste | Define se o app utilizará Produção ou Sandbox |
| Chave Pix | Necessária para funcionamento adequado do Pix |
| Forma de contato do cliente | Para cartão de crédito, deve estar configurada como e-mail |
| Parcelamento | Define quantidade máxima de parcelas e valor mínimo por parcela no app de Cartão de Crédito |
AtençãoA chave de API é exibida apenas uma vez no momento da criação.
Armazene a chave em local seguro. Caso ela seja perdida, será necessário gerar uma nova chave.
Produção e Sandbox
Durante a configuração dos apps, é obrigatório informar a chave de API de Produção.
A chave de Sandbox é opcional e deve ser informada apenas quando a loja desejar realizar testes antes de operar com transações reais.
O ambiente utilizado depende da configuração de Modo de teste no app:
| Configuração | Comportamento |
|---|---|
| Modo de teste desativado | Transações utilizam a chave de Produção |
| Modo de teste ativado | Transações utilizam a chave de Sandbox |
Antes de ativar a operação em Produção, recomenda-se realizar uma compra de teste para validar o fluxo completo.
Comportamentos esperados
Após a instalação e ativação dos apps:
- as formas de pagamento habilitadas passam a ser exibidas no checkout da Shopify;
- os pagamentos são processados pelo Asaas;
- o status do pedido é atualizado conforme a confirmação do pagamento;
- reembolsos e estornos podem ser realizados conforme a forma de pagamento utilizada e o fluxo disponível no painel da loja ou no Asaas;
- alterações em configurações dos apps afetam apenas novas compras realizadas após a atualização.
Impactos operacionais
A configuração dos Apps Asaas pode impactar diretamente o fluxo de pedidos da loja.
Configurações incorretas podem causar:
- ausência da forma de pagamento no checkout;
- uso indevido do ambiente de Produção ou Sandbox;
- falha em transações de teste;
- exibição de menos parcelas do que o esperado;
- atraso na confirmação de pedidos pagos via Pix, caso não exista chave Pix cadastrada.
Por isso, alterações em chaves, ambiente, parcelamento ou formas de pagamento devem ser validadas antes de períodos de alto volume de vendas.
Boas práticas
Ao configurar a integração entre Asaas e Shopify, recomenda-se:
- instalar apenas os apps das formas de pagamento que serão utilizadas pela loja;
- criar uma chave de API identificável para cada app instalado;
- armazenar as chaves de API em local seguro;
- validar se o Modo de teste está coerente com a chave configurada;
- cadastrar uma chave Pix antes de ativar Pix na loja;
- revisar as configurações de parcelamento antes de ativar o cartão de crédito;
- realizar uma compra de teste após qualquer alteração relevante.
Conteúdos relacionados
Para consultar o passo a passo completo de cada forma de pagamento, acesse:
Updated 16 days ago
