Shopify Integration Guide

Connect your Shopify store to PayArmorX in just a few clicks. Your products will automatically sync to your terminal and custom shop page.

Integration Overview

How PayArmorX integrates with Shopify stores

PayArmorX seamlessly integrates with your Shopify store through a simple OAuth connection. Once connected, your Shopify products automatically appear in:

  • Payment Terminal: Search and add products directly from your Shopify store when processing in-person payments
  • Custom Shop Page: Your products are automatically displayed on your PayArmorX shop page for customers to browse and purchase
  • Real-time Sync: Product information, prices, and inventory stay in sync automatically

Quick Start Guide

Connect your Shopify store in minutes

1

Log into Your Merchant Account

Access your PayArmorX merchant dashboard

Make sure you're logged into your PayArmorX merchant account. If you don't have an account yet, sign up here.

2

Navigate to Settings

Go to your merchant settings page

In your merchant dashboard, click on Settings in the navigation menu. You'll find the Shopify integration section there.

3

Add Your Shopify Store

Click "Add Store" and enter your Shopify domain

Click the "Add Store" button in the Shopify Stores section. Enter your Shopify store domain. You can enter it in either format:

  • your-store.myshopify.com
  • your-store (we'll add .myshopify.com automatically)
4

Connect with Shopify

Authorize PayArmorX to access your store

Click the "Connect with Shopify" button. You'll be redirected to Shopify's authorization page where you can review and approve the permissions PayArmorX needs:

Required Permissions:

  • read_products - To sync your product catalog
  • write_draft_orders - To create draft orders when needed
  • read_draft_orders - To read draft order information

After approving, you'll be automatically redirected back to PayArmorX and your store will be connected.

5

That's It!

Your products are now synced and ready to use

Once connected, PayArmorX automatically:

  • Syncs all your Shopify products
  • Makes them available in your payment terminal
  • Displays them on your custom PayArmorX shop page
  • Keeps product information, prices, and inventory up to date

Prerequisites

What you need before connecting

  • A PayArmorX merchant account (sign up here if you don't have one)
  • A Shopify store (development or production store)
  • Admin access to your Shopify store

Using Your Connected Store

How to use your Shopify products after connecting

Payment Terminal

Access your Shopify products directly from your payment terminal

Once your store is connected, you can use Shopify mode in your payment terminal:

  • Search for products by name or SKU
  • Add products to cart with variants and quantities
  • Process payments for Shopify products just like regular inventory items
  • All product information, prices, and images are automatically synced

Custom Shop Page

Your Shopify products appear on your PayArmorX shop page

Your Shopify products are automatically displayed on your custom PayArmorX shop page:

  • Customers can browse all your Shopify products
  • Product images, descriptions, and prices are synced automatically
  • Customers can add products to cart and checkout using PayArmorX payment methods
  • Inventory levels are kept up to date in real-time

Managing Your Stores

Activate, deactivate, or remove connected stores

In your Settings page, you can manage your connected Shopify stores:

  • Activate/Deactivate: Toggle stores on or off without disconnecting them
  • Test Connection: Verify that your store connection is working properly
  • Remove Store: Disconnect a store if you no longer need it
  • Multiple Stores: Connect multiple Shopify stores to one PayArmorX account

How It Works

What happens behind the scenes when you connect your store

1. OAuth Authorization

When you click "Connect with Shopify", PayArmorX redirects you to Shopify's secure authorization page where you approve the connection.

2. Secure Token Storage

After authorization, Shopify provides an access token that PayArmorX securely encrypts and stores in your account.

3. Automatic Product Sync

PayArmorX automatically fetches your Shopify products and makes them available in your terminal and shop page.

4. Real-Time Updates

Product information, prices, and inventory levels are kept in sync automatically whenever you access them.

Troubleshooting

Common issues and solutions

Connection Issues

  • Can't connect to Shopify: Make sure you're entering the correct store domain and have admin access to the store
  • OAuth redirect fails: Check that your browser allows redirects and that you're not blocking pop-ups
  • Permission denied: Make sure you approve all required permissions on the Shopify authorization page

Product Sync Issues

  • Products not appearing: Make sure your store is set to "Active" in the settings
  • Outdated product info: Product information is synced on-demand when accessed. Try refreshing or searching again
  • Missing products: Only products that are published in Shopify will appear in PayArmorX

API Access (For Developers)

Access Shopify products programmatically using the PayArmorX API

If you want to access your Shopify products programmatically, you can use the PayArmorX API. Once your store is connected, products are automatically available through the inventory API endpoints.

Example: Fetch Shopify Products

GET /api/v1/inventory?shopify_store_id={store_id}

// Returns all products from the connected Shopify store
// Products are automatically synced and available

For more information about using the API, see the API Reference documentation.

Additional Resources