Comece com a Whalestack

Crie uma conta na Whalestack para desbloquear o poder dos pagamentos em criptomoeda para o seu site.

Habilitar Desenvolvimento de Aplicativo Personalizado

Antes de poder criar um aplicativo personalizado para sua loja, você precisa habilitar o desenvolvimento de aplicativos personalizados. Apenas o proprietário da loja pode habilitar o desenvolvimento de aplicativos personalizados.

1. A partir do seu admin Shopify, navegue até Settings > Apps and sales channels.
2. Clique em Develop apps.
3. Clique Allow custom app development.
4. Leia o aviso e as informações fornecidas e, em seguida, clique Allow custom app development.

Criar Seu Aplicativo Personalizado

1. A partir do seu admin Shopify, navegue até Settings > Apps and sales channels.
2. Clique em Develop apps.
3. Clique Create an app.
4. Na janela modal, insira o nome do Aplicativo (Whalestack) e selecione um Desenvolvedor de Aplicativo. O desenvolvedor do aplicativo pode ser o proprietário da loja ou qualquer funcionário ou colaborador com permissão de apps Developer.
5. Clique Create app.

Selecionar Escopos da API

1. In the app that you just created Apps and Sales channels -> Develop apps -> Whalestack, click the Configure Admin API scopes button
2. Role para baixo até a seção Orders e ative ambos write_orders e read_orders.
3. Na parte inferior da página, na seção Webhook subscriptions, escolha Latest no menu suspenso.
4. Click Save, and then click Install app at the top of the page and confirm it on the modal popup.

Coletar Token de Acesso API

1. Na aba API credential, clique em Reveal token once e salve em um local seguro.

Criar um Webhook

Este webhook é um evento de retorno personalizado que envia notificações para a sua conta Whalestack.

1. Na sua conta Shopify, vá para Settings -> Notifications.
2. Desça até o final da página e encontre a seção Webhooks.
3. Clique em Create webhook.
4. Escolha os seguintes parâmetros na janela pop-up:
   • Evento: Criação de pedido
   • Formato: JSON
   • URL: https://www.whalestack.com/api/v1/shopify-order
   • Versão da API do Webhook: Escolha a Mais Recente
5. Clique em Save.

Crie um Novo Método de Pagamento Cripto

Este método de pagamento se torna uma opção na sua loja Shopify.

1. Na sua conta Shopify, vá para Settings -> Payments.
2. Desça na lista de provedores de pagamento até a seção Manual payment methods.
3. Clique no menu suspenso para Manual payment methods e escolha Create custom payment method.
4. Digite os campos na janela pop-up da seguinte forma:
   • Nome do método de pagamento personalizado: Digite Whalestack ou Bitcoin via Whalestack. Importante: Você pode personalizar o nome como preferir, mas ele deve incluir a palavra Whalestack, caso contrário, não poderemos capturar os pagamentos. Além disso, Bitcoin via Whalestack será mais fácil de ser entendido pelos seus clientes do que apenas Whalestack.
   • Detalhes adicionais: Insira uma breve descrição para o método de pagamento Whalestack, por exemplo: Pague com Bitcoin e outras moedas digitais ou stablecoins via Whalestack.
   • Instruções de pagamento: Estas instruções aparecem na página de confirmação de pedido e devem informar os compradores de que receberão um e-mail para efetuar o pagamento e finalizar o pedido. Exemplo: Verifique seu e-mail agora, você receberá instruções para finalizar o pagamento.
5. Clique em Activate.

Personalizar a Exibição do Método de Pagamento

• Na sua conta Shopify, vá para Settings -> Checkout.
• Desça até o final da página e encontre a seção Order status page.
• Copie o seguinte trecho Liquid na área de texto:

  <script>
    {% assign gateway = checkout.transactions[0].gateway | downcase %}
    {% if gateway contains 'whalestack' %}
    Shopify.Checkout.OrderStatus.addContentBox(`
      <div class="text-container">
          <h2 style="font-weight:bold;color:red">Payment Instructions</h2>
          <p>Please check your email inbox for instructions from <strong>Whalestack // Service</strong> on how to pay this order securely with Bitcoin, Lightning, Litecoin, XLM, USDC, or EURC.</p>
          <p>Powered by <img src="https://www.whalestack.com/images/ws-logo-blue.svg" width="100px"></p>
          </div>`)
    {% endif %}
  <script>

• Clique em Save.

Configurar Credenciais da API do Shopify no Whalestack

1. Entre na sua conta Whalestack e navegue até a página Configurações da API Shopify.
2. Preencha os campos da seguinte forma:
   • URL da Loja Shopify: Digite a URL da sua loja no formato https://{your-store-name}.myshopify.com.
   • Token de Acesso: Digite o token de acesso à API obtido no passo 2 (Criar um aplicativo personalizado Shopify) deste guia.
   • Chave de Assinatura do Webhook: Navigate to Settings -> Notifications -> Webhooks. You will find the signing key there.
   • Ativo de Liquidação: O ativo de liquidação no qual sua conta é creditada quando um checkout é concluído. Escolha "ORIGIN" para ser creditado no mesmo ativo que seu cliente pagou.
   • Idioma da Página de Checkout: O idioma em que a página de checkout, onde seu cliente paga, será exibido. Escolha "auto" para detectar automaticamente o idioma do usuário.
3. Clique em Submit.

Confirmação de Pedido

Após a confirmação do pedido, um e-mail é enviado ao usuário contendo um link para pagar o pedido de forma segura pela página de pagamento do Whalestack.

Informação de Pagamento

Pagamentos concluídos atualizarão automaticamente os pedidos do Shopify para Paid.

Reembolsos

Gerencie todos os pagamentos e reembolsos na sua conta Whalestack. Você receberá...

Página de Pagamento

Personalize a página de checkout para corresponder à aparência e ao estilo da sua marca diretamente nas configurações do Brand Connect de sua conta Whalestack. Configure informações da marca, imagens, fontes, cores e mais. Consulte o guia do Brand Connect para mais detalhes.