Aplicativo Shopify personalizado

Modelo de integração

A integração do Shopify usa o fluxo do aplicativo Shopify V2 Dev Dashboard. O comerciante fornece um token CLI do parceiro da Shopify único para que MakeCrypto possa criar o app fixo MakePay no Shopify Dev Dashboard com a CLI da Shopify. MakeCrypto lê automaticamente o ID do cliente gerado. Shopify ainda mostra o segredo do cliente apenas no painel de desenvolvimento, portanto, o comerciante copia esse segredo para MakeCrypto antes da implantação.

Depois de implantar e instalar o app, o Shopify inicia o MakeCrypto com um token de sessão assinado. MakeCrypto valida esse token com o segredo do cliente e o troca por um token de administrador offline API. Esse token é criptografado em repouso e usado para o mesmo fluxo de pedido MakePay: sincronização de pedido, links de pagamento hospedados, notas/etiquetas, webhooks e automação opcional de marcação de pagamento.

A configuração legada com token de acesso Admin API não é mais compatível com novas conexões do Shopify. As lojas existentes conectadas a esse fluxo anterior devem se reconectar usando a configuração V2.

Aplicativo Shopify Dev Dashboard

MakeCrypto cria automaticamente o aplicativo Dev Dashboard a partir do token Partner CLI. O nome do aplicativo é sempre MakePay. Depois de criá-lo, abra as configurações do aplicativo MakePay no Dev Dashboard e copie o segredo do cliente para MakeCrypto.

Administrador de escopos API necessário:

• read_customers
• write_customers
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_themes
• write_themes

O nome do aplicativo Shopify implantado é sempre MakePay.

Configuração MakeCrypto

Abra MakeCrypto, escolha a empresa e vá em E-commerce > Shopify. Adicione uma loja com:

• Slug da loja Shopify, que é a parte anterior a .myshopify.com
• Token único da CLI do parceiro da Shopify
• Segredo do cliente Shopify, copiado após MakeCrypto criar o aplicativo
• Nome da forma de pagamento manual

O token Partner CLI é criptografado até que MakeCrypto crie, implemente e instale o aplicativo e, em seguida, seja excluído. Durante a criação do aplicativo, MakeCrypto também detecta o ID da organização do Shopify Dev Dashboard no token. O segredo do cliente e o token offline do administrador API são criptografados em repouso.

Para gerar um token CLI do parceiro, abra as configurações do portal do parceiro Shopify, role para baixo até token CLI, gerencie tokens e gere um novo. Ele pode ser revogado após a instalação do aplicativo MakePay ser concluída com sucesso.

Instalação e blocos do checkout

Quando a implantação aparecer como implantada, abra o portal do parceiro Shopify, selecione o aplicativo, vá para Distribuição > Distribuição personalizada e instale o aplicativo na loja. Shopify redireciona de volta para MakeCrypto após a instalação.

Em seguida, abra o administrador do Shopify e vá para Configurações > Checkout > Personalizar. Adicione o bloco MakePay à página de agradecimento e à página Status do pedido e salve.

O bloco MakePay verifica o token de sessão do Shopify, solicita MakeCrypto o link de pagamento correspondente e exibe um botão Pagar agora. Caso a solicitação webhook ainda esteja sendo processada, o bloco aguarda brevemente enquanto MakePay prepara o link.

Método de pagamento manual

No admin do Shopify, abra Configurações > Pagamentos > Métodos de pagamento manuais e crie um método de pagamento personalizado. Seu nome deve corresponder exatamente ao nome do método de pagamento da conexão MakeCrypto. Novas conexões MakePay usam por padrão:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Quando os clientes escolhem esse método, o Shopify cria o pedido como não pago. MakePay Sync anexa o URL do checkout hospedado à nota do pedido e pode enviar um e-mail de solicitação de pagamento MakePay quando ativado.

Webhooks e sincronização

MakeCrypto registra webhooks de criação/atualização de pedido e desinstalação do aplicativo após concluir a instalação da V2. Uma sincronização agendada também verifica as lojas conectadas recentemente, para que os pedidos sejam retirados mesmo que a entrega do webhooks Shopify esteja atrasada.

As assinaturas webhooks recebidas do Shopify são verificadas antes de aceitar a carga útil. A solicitação e os logs webhooks são mantidos na página de login para solução de problemas.

Mapeamento de estado

Quando um pedido do Shopify está pendente usando o método de pagamento manual MakePay, MakePay cria ou reutiliza um link de pagamento MakePay para o total do pedido e o e-mail do cliente.

Quando o pagamento MakePay atinge complete, MakePay adiciona uma nota/etiqueta paga e usa orderMarkAsPaid do Shopify Admin API quando a marcação automática de pagamento está habilitada.

Quando um pagamento MakePay chega a failed, expired ou cancelled, MakePay adiciona uma nota de status e deixa o pedido não pago do Shopify para análise do comerciante.

Solução de problemas

Se a criação ou implementação do aplicativo falhar, confirme se o token da CLI do parceiro começa com atkn_ e não foi revogado antes de iniciar o trabalho e tente novamente a partir de MakeCrypto.

Se a instalação falhar, confirme se o app Shopify foi criado pela mesma configuração MakeCrypto e se o app URL gerado por MakeCrypto está configurado pelo deploy.

Se a conexão de teste falhar, verifique se o aplicativo tem todos os escopos necessários e reinstale ou reimplante o aplicativo.

Se o bloco Pagar agora permanecer pronto, confirme se o bloco MakePay está instalado em ambas as páginas checkout e se o pedido do Shopify usa exatamente o nome do método de pagamento manual.