WooCommerce Integration
Accept any cryptocurrency, credit card, or bank transfer at checkout — settled directly to your wallet in XRP or RLUSD. Supports classic checkout and the new Checkout Blocks out of the box.
How It Works
Install Plugin
Download the XRPay plugin ZIP and upload it in your WordPress admin dashboard.
Configure Keys
Copy your Publishable and Secret keys from your XRPay dashboard into the gateway settings.
Customer Pays
At checkout, the customer is redirected to a hosted checkout page. They can pay via WalletConnect (any crypto) or card/bank transfer.
Confirmed in 3s
XRP Ledger confirms the payment. Webhooks update the WooCommerce order status instantly.
Quick Setup
Step 1: Download & Install
Download the WooCommerce plugin ZIP file directly from your XRPay Dashboard or docs. In WordPress, navigate to Plugins → Add New → Upload Plugin, choose the ZIP file, and click Activate.
Step 2: Configure API Keys
Log in to WordPress and navigate to WooCommerce → Settings → Payments → XRPay. Copy your Publishable Key and Secret Key from your XRPay dashboard and paste them into their respective fields.
Step 3: Test & Go Live
Check the Test Mode checkbox in WooCommerce. Generate test transactions using your test API keys. Once you confirm the checkout flow and webhook delivery, uncheck Test Mode and paste your Live keys to start accepting real crypto assets.
Configuration Options
| Setting | Description | Default |
|---|---|---|
enabled | Enable or disable the XRPay payment method at checkout. | Disabled |
title | Payment method label shown to customers at checkout. | Pay with XRPay |
description | Help text displayed under the payment option at checkout. | Pay securely with XRP or RLUSD... |
test_mode | Toggles between Livenet and Testnet API keys. | Disabled |
api_key / secret_key | Your live publishable and secret keys from the dashboard. | None |
payment_action | Choose whether to redirect customers or open a checkout modal. | Redirect to XRPay |
order_status | Order status set on your site once on-chain payment is confirmed. | Processing |
debug_log | Enables logging to WooCommerce status logs for debugging. | Disabled |
How Payments Work
Secure, Non-Custodial Redirect Flow. When a customer submits their order, they are redirected to a secure payment page hosted by XRPay. Once on-chain payment is verified on the XRP Ledger, XRPay pushes an authenticated webhook signed with your Secret Key back to WooCommerce. WooCommerce updates the order status immediately, ensuring a fully automated fulfillment workflow.
Test Mode
Ensure you test the integration using the XRP Ledger Testnet. Enable the test mode settings and use your test keys starting with pk_test_ and sk_test_. This ensures no real assets are spent while verifying webhooks and order transitions.
FAQ
Does this work with Checkout Blocks?
Yes. The plugin is fully integrated with WooCommerce Checkout Blocks using React and wp.blocks APIs.
Are there extra WooCommerce transaction fees?
No. WooCommerce does not charge fees for using custom gateways. You only pay XRPay's flat 0.5% merchant fee.
What about refunds?
Admin-initiated on-chain refunds are deferred to v2. Refunds must be processed manually via your crypto wallet for the time being.
Can customers still use normal checkout?
Yes, XRPay operates as a payment method side-by-side with credit cards, PayPal, and others.
What currencies and payment methods are supported?
XRPay supports fiat currencies like USD, EUR, GBP, and JPY. Customers can pay using XRP, RLUSD, credit cards, bank transfers, or any major cryptocurrency (via WalletConnect and cross-chain swaps), settled directly to your wallet in XRP or RLUSD.