Shopify Plugin Deployment Guide

Pay Protocol Shopify payment plugin can provide a seamless checkout experience for your customers. This guide will walk you through the steps to deploy the plugin.

0. Prerequisites

• A Shopify store
• A Pay Protocol merchant account, you can read the introduction here.
• Get your merchant API key from Pay Protocol admin console referring to this guide.

1. Add Pay Protocol payment method

The first step is to add Pay Protocol as a manual payment method in your Shopify store.

1. Log in to your Shopify admin site, go to Settings in the lower left corner of admin page.

2. Click Payment in the Settings page.

3. Scroll down to the Manual payments methods section, click Add manual payment method and select Create custom payment method.

4. Enter Cryptocurrency Payments - Pay Protocol in the Custom payment method name field, and fill in the other two fields, then click Activate.

• Additional details: This is the payment method description that will be displayed to your customers. Copy the text below and paste it into the field (you can modify it according to your actual situation).

We accept payments in multiple cryptocurrencies such as ETH, USDT, BNB and TRX. Support MetaMask, Coinbase, TronLink and more wallets. Please tap "Complete Order" to pay.

• Payment instructions: This is the payment method instructions that will be displayed to your customers on the checkout confirm page. Copy the text below and paste it into the field.

After clicking “Cryptocurrency Payment”, you will be redirected to Pay Protocol - Payment Gateway to complete your purchase securely.

warning

Please make sure that the payment method name includes Pay Protocol, otherwise the plugin will not work properly.

5. Now you can see the Pay Protocol payment method in the Manual payments methods section.

2. Create a private app

The purpose of this step is to synchronize and update the payment status of orders in your Shopify store.

1. Go to Apps and sales channels in Settings, click Develop apps.

2. Click Create an app, enter Pay Protocol Payment Gateway in the App name field, and click Create app.

3. After the app is created, the following page will be displayed, click Configure Admin API scopes.

4. Search and select the following permissions, then click Save.

read_orders, write_orders, write_order_edits, read_order_edits

5. Select API credentials tab, click Install app.

6. After the app is installed, the following page will be displayed. Reveal the Admin API access token and save it for later use.

warning

To protect your data, you’ll only be able to reveal your Admin API token once. Copy and save your Admin API access token in a secure place.

7. Send your shop's information to bd@payprotocol.network

• Your merchant name in Pay Protocol admin console: Your company name
• Your Shopify store URL: https://your-store.myshopify.com
• Your Shopify Admin API access token: the token you saved in step 6
• Your Shopify store quote currency: USD, JPY, HKD, etc.

3. Add the Pay Protocol Shopify plugin

This step aims to call up the Pay Protocol Shopify plugin on the order status page to complete the payment. This plugin only supports the English order status page.

1. Open Settings in the lower left corner of admin page, click Checkout.

2. Scroll down to the Order status page section, copy the following code and paste it into the Additional scripts field.

<style>.os-header__hanging-icon,.step__footer__continue-btn,#main-header {visibility: hidden;}
 .os-step__special-description {display: none;}</style>
<noscript><strong style="color:red">We're sorry but it doesn't work properly without JavaScript enabled. Please enable it to continue.</strong></noscript>
<script id="payprotocol-shopify" data-sandbox="false" data-api="your-api-key" src="https://plugin.payprotocol.network/shopify.js"></script>

Change your-api-key to your Pay Protocol API key. If you want to test the plugin in Pay Protocol sandbox environment, change data-sandbox="false" to data-sandbox="true".

Click Save on the bottom right corner of the page.

After completing the above steps, you successfully deployed the Pay Protocol Shopify plugin. You can now accept cryptocurrency payments in your Shopify store.

How to pay cryptocurrency with Pay Protocol Shopify plugin

1. Add products to your shopping cart and click Check out.

2. Fill in the Contact and Billing address information, select Pay Protocol as the payment method, and click Complete order.

3. Now you will be redirected to order confirmation page, click Cryptocurrency Payment.

4. After clicking Cryptocurrency Payment, you will be redirected to Pay Protocol payment page. Select the network and cryptocurrency you want to pay with, and click Scan To Pay to start the payment.

5. After successful payment, click Return to merchant to return to the order confirmation page.

6. Now you can see the order is confirmed and paid.