Shopify Integration
Add a "Pay with XRP" button to your Shopify store in under 2 minutes. No Shopify app approval needed — just a single script tag.
How It Works
Widget Loads
The XRPay script detects your cart page and injects a 'Pay with XRP' button.
Customer Clicks
Cart total is sent to XRPay's API. A checkout session is created with live XRP exchange rates.
Payment Modal
A branded modal opens with a QR code. Customer scans with Xaman or any XRP wallet.
Confirmed in 3s
XRPL validates the payment. The Shopify cart is cleared and customer sees confirmation.
Quick Setup (2 Minutes)
Step 1: Get Your API Key
Sign in to your XRPay Dashboard and copy your Publishable Key (starts with pk_live_).
Step 2: Add the Script to Your Theme
In your Shopify Admin, go to Online Store → Themes → Actions → Edit Code. Open theme.liquid and paste this before the closing </body> tag:
<script src="https://xrpay.it/shopify-widget.js" data-xrpay-key="pk_live_YOUR_KEY_HERE" data-xrpay-position="cart" data-xrpay-currency="USD" data-xrpay-theme="dark"> </script>
Step 3: Done!
Visit your cart page. You'll see a "Pay with XRP" button below the standard checkout button. Test it with a small amount to verify everything works.
Configuration Options
| Attribute | Description | Default |
|---|---|---|
data-xrpay-key | Your XRPay publishable API key | Required |
data-xrpay-position | Where to show the button: cart, product, or both | cart |
data-xrpay-currency | Store's fiat currency (USD, EUR, GBP, etc.) | USD |
data-xrpay-theme | Button theme: dark or light | dark |
data-xrpay-text | Custom button text | Pay with XRP |
data-xrpay-host | XRPay API host (for self-hosted) | https://xrpay.it |
Supported Themes
The widget automatically detects the checkout button in popular Shopify themes:
- Dawn (default Shopify theme)
- Debut
- Minimal / Simple / Supply
- Any theme with standard
form[action="/cart"]markup
If the button doesn't appear, your theme may use a custom cart. Contact us and we'll add support.
How Payments Work
No Shopify Payments Partner approval needed. The widget works outside the Shopify checkout — it reads the cart total via Shopify's public /cart.js API, creates an XRP payment session via XRPay, and clears the cart after payment confirmation. Orders appear in your XRPay dashboard.
Important: Since this bypasses Shopify's checkout, orders are not automatically created in Shopify Admin. You can reconcile them from your XRPay dashboard's transaction history. Full Shopify order sync is coming soon via the Shopify Admin API.
Test Mode
Use a test API key (pk_test_) for development. Test payments use the XRPL Testnet and no real XRP is exchanged.
<script src="https://xrpay.it/shopify-widget.js" data-xrpay-key="pk_test_YOUR_TEST_KEY" data-xrpay-position="cart"> </script>
FAQ
Does this require Shopify Plus?
No. The widget works on any Shopify plan, including Basic.
Are there extra Shopify transaction fees?
No. Since we don't use Shopify Payments, there are no additional Shopify transaction fees.
Will my Shopify inventory update?
Not yet — orders are tracked in XRPay. Shopify inventory sync is on the roadmap.
Can customers still use normal checkout?
Absolutely. The XRP button is an additional option alongside the standard checkout.