Merchant Apps

Shopify

Required Steps:

  1. Creating a custom app

  2. Creating a webhook

  3. Creating the Wirecash payment option

  4. Customizing the checkout order page

  5. Entering Shopify API credentials into your Wirecash account

Step 1: Creating a custom app

A custom app is an app that you only build for your own Shopify store.

1. Enabling custom app development from the Shopify admin (if it isn't already enabled)

image info

  • From Shopify admin, go to Apps
  • Click App and sales channel settings
  • Click Develop apps for your store button
  • Read the warning and information provided, and then click Allow custom app development

2. Creating the Wirecash custom app

  • From Shopify admin, go to Apps
  • Click App and sales channel settings
  • Click Develop apps for your store button
  • Click Create an app

image info

  • In the modal window, enter the App name (WIRECASH) and select an App developer. The app developer can be the store owner, or any staff or collaborator account with the Develop apps permission
  • Click Create app

3. Selecting API Scopes

image info

  • Click Button Configure Admin API scopes

  • Scroll down to section Orders and activate write_orders and read_orders

  • At the bottom of the page, in section Webhook subscriptions, choose Latest from the dropdown menu

  • Click Save

  • Click Install app

4. Saving API access token

  • In tab API credentials, click on Reveal token once and save it in a secure place

Step 2: Creating a webhook

  • Go to Settings > Notifications in your Shopify Account

image info

  • Find section Webhooks, on the bottom of the page
  • Click 'Create webhook'

image info

  • Enter the following parameters in the popup window:

  • Click Save webhook

Step 3: Creating the Wirecash payment option

image info

  • Go to Settings > Payments in your Shopify Account
  • Find at the bottom of the list Manual payment methods and select on the dropdown Create custom payment method

image info

  • Enter the following fields:
    • Custom payment method name: Pay with Crypto ₿ ⟠ ₮ Ð (Wirecash)
      Important: Wirecash name must be included in method name, otherwise we will not be able to capture the payment.
    • Additional details: Pay with Bitcoin, ETH, USDC, USDT, XLM and 20+ cryptocurrencies via Wirecash.
    • Payment instructions: Pay with Bitcoin, ETH, USDC, USDT, XLM and 20+ cryptocurrencies via Wirecash.
  • Click activate

Step 4: Customizing the checkout order page

image info

  • Go to Settings > Checkout in your Shopify Account
  • Scroll to bottom of page and find section Order status page scripts
  • Paste the following code snippet into the textarea:

{% assign gateway = checkout.transactions[0].gateway | downcase %} {% if gateway contains 'wirecash' and order.financial_status != 'paid' %} <script type="text/javascript" src="https://assets.w.cash/apps/shopify.js?v1"></script> {% endif %}

  • Click save

Step 5: Entering Shopify API credentials into your Wirecash account

image info

  • Sign in to your Wirecash account and go to your desired merchants account and to Apps
  • Enter the following fields:
    • Shopify Store URL: Your store URL
    • Access Token: The API access token you retrieved in step 1 of this guide
    • Webhook Signing Key: Go to Settings > Notifications and on the bottom of the page you will find the Webhook section. There you will find the key, which is highlighted in yellow.
  • Click send

And thats it! You can create a test purchase to confirm that everything runs smoothly.

Previous
Teams