Inizia con Whalestack

Crea un account Whalestack per sbloccare la potenza dei pagamenti con criptovalute per il tuo sito web.

Abilita lo Sviluppo di App Personalizzate

Prima di poter creare un'app personalizzata per il tuo negozio, è necessario abilitare lo sviluppo di app personalizzate. Solo il proprietario del negozio può abilitare lo sviluppo di app personalizzate.

1. Dall'admin di Shopify, vai a Settings > Apps and sales channels.
2. Fai clic su Develop apps.
3. Fai clic su Allow custom app development.
4. Leggi l'avviso e le informazioni fornite, quindi fai clic su Allow custom app development.

Crea la Tua App Personalizzata

1. Dall'admin di Shopify, vai a Settings > Apps and sales channels.
2. Fai clic su Develop apps.
3. Fai clic su Create an app.
4. Nella finestra modale, inserisci il nome dell'app (Whalestack) e seleziona un sviluppatore di app. Lo sviluppatore dell'app può essere il proprietario del negozio o qualsiasi account del personale o collaboratore con il permesso di sviluppare app.
5. Fai clic su Create app.

Seleziona Ambiti API

1. In the app that you just created Apps and Sales channels -> Develop apps -> Whalestack, click the Configure Admin API scopes button
2. Scorri verso il basso fino alla sezione Orders e attiva sia write_orders che read_orders.
3. In fondo alla pagina, nella sezione Webhook subscriptions, scegli Latest dal menu a discesa.
4. Click Save, and then click Install app at the top of the page and confirm it on the modal popup.

Ottieni il Token di Accesso API

1. Nella scheda API credential, clicca su Reveal token once e salvalo in un luogo sicuro.

Crea un Webhook

Questo webhook è un evento di richiamo personalizzato che invia notifiche al tuo account Whalestack.

1. Nel tuo account Shopify, vai a Settings -> Notifications.
2. Scorri fino alla parte inferiore della pagina e trova la sezione Webhooks.
3. Clicca su Create webhook.
4. Scegli i seguenti parametri nella finestra popup:
   • Evento: Creazione ordine
   • Formato: JSON
   • URL: https://www.whalestack.com/api/v1/shopify-order
   • Versione API del Webhook: Scegli l'Ultima
5. Clicca su Save.

Crea un Nuovo Metodo di Pagamento con Criptovalute

Questo metodo di pagamento diventa un'opzione nel tuo store di Shopify.

1. Nel tuo account Shopify, vai a Settings -> Payments.
2. Scorri verso il basso nella lista dei fornitori di pagamento fino alla Manual payment methods sezione .
3. Clicca sul menu a tendina per Manual payment methods e seleziona Create custom payment method.
4. Inserisci i campi nella finestra popup come segue:
   • Nome personalizzato del metodo di pagamento: Inserisci Whalestack o Bitcoin via Whalestack. Importante: Puoi personalizzare il nome a tuo piacimento, ma deve includere la parola Whalestack, altrimenti non saremo in grado di elaborare i pagamenti. Inoltre, Bitcoin via Whalestack sarà più comprensibile per i tuoi clienti rispetto al semplice Whalestack.
   • Dettagli aggiuntivi: Inserisci una breve descrizione per il metodo di pagamento Whalestack, ad esempio: Paga con Bitcoin e altre criptovalute o stablecoin tramite Whalestack.
   • Istruzioni di pagamento: Queste istruzioni appariranno sulla pagina di conferma dell'ordine e dovrebbero informare gli acquirenti che riceveranno un'email per effettuare il pagamento e finalizzare l'ordine. Esempio: Controlla la tua casella di posta elettronica ora, riceverai istruzioni per pagare in modo sicuro tramite la pagina di pagamento Whalestack.
5. Clicca Activate.

Personalizza la Visualizzazione dei Metodi di Pagamento

• Nel tuo account Shopify, vai a Settings -> Checkout.
• Fai scorrere fino in fondo alla pagina e trova la sezione Order status page.
• Copiare il seguente frammento Liquid nella textarea:

  <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>

• Clicca Save.

Configura le Credenziali API di Shopify in Whalestack

1. Accedi al tuo account Whalestack e naviga nella pagina delle impostazioni API di Shopify.
2. Compila i campi nel seguente modo:
   • Shopify Store URL: Inserisci l'URL del tuo negozio nel formato https://{your-store-name}.myshopify.com.
   • Token di Accesso: Inserisci il token di accesso API ottenuto nel passaggio 2 (Creazione di un'app personalizzata Shopify) di questa guida.
   • Chiave di Firma del Webhook: Navigate to Settings -> Notifications -> Webhooks. You will find the signing key there.
   • Asset di Liquidazione: L'asset di liquidazione in cui il tuo account viene accreditato quando un checkout viene completato. Scegli "ORIGIN" per essere accreditato nello stesso asset con cui il cliente ha effettuato il pagamento.
   • Lingua della Pagina di Checkout: La lingua in cui sarà visualizzata la pagina di checkout, dove il tuo cliente effettua il pagamento. Scegli "auto" per rilevare automaticamente la lingua dell'utente.
3. Clicca su Submit.

Ordine Confermato

Dopo la conferma dell'ordine, viene inviata un'email all'utente contenente un link per effettuare il pagamento in modo sicuro tramite la pagina di pagamento di Whalestack.

Informazioni di Pagamento

I pagamenti completati aggiorneranno automaticamente gli ordini Shopify a Paid.

Rimborsi

Gestisci tutti i pagamenti e i rimborsi nel tuo account Whalestack. Riceverai notifiche via email per ogni nuovo pagamento.

Pagina di Pagamento

Personalizza la pagina di checkout per rispecchiare l'aspetto e la sensazione del tuo marchio direttamente nelle impostazioni di Brand Connect del tuo account Whalestack. Configura informazioni sul marchio, immagini, caratteri, colori e altro ancora. Consulta la guida di Brand Connect per ulteriori dettagli.