Installation & Usage Guide

Accept 100+ cryptocurrencies at checkout on your WooCommerce store with the JOVEpay for WooCommerce plugin. Customers pay on JOVEpay's hosted checkout page; completed payments are reported back to your store automatically via webhooks.

This guide walks through prerequisites, installation, dashboard setup, plugin configuration, testing, and day-to-day usage.

Prerequisites

Before installing the plugin, make sure your store meets these requirements:

Important: Install and configure WooCommerce first — products, currency, and checkout must be working before you add JOVEpay as a payment method.

What you'll need from JOVEpay

After creating your JOVEpay account, gather the following from the dashboard:

• API Key — authenticates checkout requests from your store
• IPN Secret Key — used to verify incoming webhook (IPN) notifications
• Merchant wallet / payout settings — configured in the dashboard so settled funds reach your wallet or bank account

If you do not have an account yet, register at https://app.jovepay.com/signup.

Download the plugin

Download the latest release from the JOVEpay plugin page or use the direct link below.

• Plugin page: jovepay.com/plugins/woocommerce
• Direct download (v1.0.0): jovepay-woocommerce-1.0.0.zip

Save the .zip file to your computer — do not extract it. WordPress installs plugins directly from the archive.

Install the plugin in WordPress

Step 1 — Open the plugin uploader

1. Log in to your WordPress admin dashboard.
2. Go to Plugins → Add New.
3. Click Upload Plugin at the top of the page.

Step 2 — Upload and install

1. Click Choose File and select jovepay-woocommerce-1.0.0.zip.
2. Click Install Now.
3. Wait for WordPress to finish installing the plugin.

Step 3 — Activate

1. After installation completes, click Activate Plugin.
2. Alternatively, go to Plugins → Installed Plugins, find JOVEpay for WooCommerce, and click Activate.

Once activated, JOVEpay appears as a payment method under WooCommerce settings.

Set up your JOVEpay account

If this is your first time using JOVEpay, complete merchant setup in the dashboard before configuring the plugin.

1. Create an account at https://app.jovepay.com/signup (or log in if you already have one).
2. Complete your business profile and payout / wallet settings so you can receive settled payments.
3. Open Payment Settings in the dashboard:
   • API credentials: app.jovepay.com/en/payments-settings#api
   • Webhooks / IPN: app.jovepay.com/en/payments-settings#webhooks

Copy your API Key

On the API tab of Payment Settings, copy your API Key. You will paste this into the WooCommerce plugin settings.

Copy your IPN Secret Key

On the Webhooks tab, copy your IPN Secret Key. This secret is used to verify that payment notifications sent to your store are genuinely from JOVEpay.

Configure the plugin in WooCommerce

Step 1 — Open payment settings

1. In WordPress admin, go to WooCommerce → Settings → Payments.
2. Find JOVEpay in the payment methods list and click Manage (or Set up).

Step 2 — Fill in the settings

3. Click Save changes.

Note: The API Key field is required. The plugin will not save settings without it.

Step 3 — Register the webhook URL (if needed)

The plugin displays a Webhook URL in the settings panel (typically in the form https://yourstore.com/?wc-api=JPWC_Gateway). If your JOVEpay dashboard asks for a callback or webhook endpoint, paste this URL there so order statuses update automatically when payments complete.

How checkout works

When a customer selects JOVEpay and places an order:

1. WooCommerce creates the order and redirects the customer to JOVEpay's hosted payment page.
2. The customer chooses a supported cryptocurrency and completes payment.
3. JOVEpay sends an IPN (webhook) notification to your store.
4. WooCommerce updates the order status based on the payment result.

Order status mapping

You can review payment events and order notes in the WooCommerce order detail screen.

Test your integration

Use the JOVEpay demo environment to verify everything works before going live.

Demo dashboard credentials

Sign in with these credentials, copy the API Key and IPN Secret Key from Payment Settings, and paste them into your WooCommerce plugin settings.

Enable test mode

In the plugin settings, check Enable Testnet while testing. This routes payments through JOVEpay's test environment instead of live networks.

Live demo store

Visit the pre-configured demo store to see the full checkout flow in action:

https://woocommerce.jovepay.com/

Testnet faucets

Demo stores run on test networks. Use these faucets to obtain test tokens for trial payments:

• Tron Nile Testnet
• BNB Testnet
• Solana Devnet
• Solana USDC Devnet

Testing checklist

1. Enable Testnet in plugin settings and save.
2. Log in to the demo dashboard and copy API + IPN credentials.
3. Place a test order on your store and select JOVEpay at checkout.
4. Complete payment on the JOVEpay hosted page.
5. Confirm the WooCommerce order status updates to On hold or Processing.
6. Disable Testnet and switch to your production API credentials when ready to go live.

Supported cryptocurrencies

JOVEpay supports 100+ cryptocurrencies including popular assets such as:

• Bitcoin (BTC), Ethereum (ETH), Litecoin (LTC), Dogecoin (DOGE)
• BNB Smart Chain (BEP20), Polygon (POL), Arbitrum (ARB), Optimism (OP), Solana (SOL)
• Stablecoins: USDT, USDC, DAI, BUSD, TUSD, PYUSD, and more

Customers can pay with any supported coin; JOVEpay handles conversion and settlement according to your dashboard configuration.

Troubleshooting

JOVEpay does not appear at checkout

• Confirm WooCommerce is installed and active.
• Confirm JOVEpay is enabled under WooCommerce → Settings → Payments.
• Check that the API Key is saved in the plugin settings.

Order status does not update after payment

• Verify the IPN Secret Key in the plugin matches the value in your JOVEpay dashboard.
• Confirm your store's Webhook URL is reachable over HTTPS (not blocked by a firewall or security plugin).
• Check WooCommerce → Status → Logs for JOVEpay-related errors.

"API Key is required" error on save

The API Key field cannot be empty. Copy a valid key from Payment Settings → API and try again.

Payments fail in test mode

Ensure Enable Testnet is checked in the plugin and you are using credentials from the demo dashboard. Use testnet faucets to fund your test wallet before attempting a payment.

Going live

When you are satisfied with testing:

1. Disable Testnet in the plugin settings.
2. Replace demo credentials with your production API Key and IPN Secret Key.
3. Confirm payout / wallet settings in your JOVEpay dashboard.
4. Place a small real order to verify end-to-end settlement.

Support and resources

• Plugin download: jovepay.com/plugins/woocommerce
• Create an account: app.jovepay.com/signup
• Dashboard login: app.jovepay.com/login
• Demo store: woocommerce.jovepay.com
• Contact: [email protected]

For installation help or merchant onboarding, reach out to the JOVEpay team — support is available 24/7.