Installation & Usage Guide

Accept 100+ cryptocurrencies at checkout on Magento Open Source and Adobe Commerce with the JOVEpay for Magento module. Customers pay on JOVEpay's hosted checkout page; completed payments are reported back to your store automatically via Instant Payment Notifications (IPN).

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

Prerequisites

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

Important: Magento checkout (products, currency, and payment step) must work before you add JOVEpay as a payment method. The module cannot process payments until your JOVEpay account is activated.

What you'll need from JOVEpay

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

• Merchant ID (API Key) — authenticates checkout requests from your store
• IPN Secret — 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.

Install the module

Download the package from the JOVEpay plugin page, then install with Composer (when available on Marketplace) or manually into app/code.

• JOVEpay plugin page: jovepay.com/plugins/magento
• Direct download (v1.0.0): jovepay-magento2-1.0.0.zip

Option A — Composer (Marketplace)

When the module is available on the Adobe Commerce Marketplace:

1. Log in to your server and go to your Magento root directory.
2. Install the package:

composer require jovepay/magento2:1.0.0

3. If prompted for credentials, use your Adobe Commerce Marketplace Access Keys (public key as username, private key as password).
4. Enable the module:

php bin/magento module:enable Jovepay_Checkout

Option B — Manual install (app/code)

1. Extract the zip so the module files are at:

magento_root/app/code/Jovepay/Checkout/

registration.php and composer.json must be in that folder.

2. Enable the module:

php bin/magento module:enable Jovepay_Checkout

After installing (required)

From the Magento root, run:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

You can now configure JOVEpay under Stores → Configuration → Sales → Payment Methods.

Set up your JOVEpay account

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

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 Merchant ID (API Key)

On the API tab of Payment Settings, copy your Merchant ID / API Key. You will paste this into Magento as Merchant ID.

Copy your IPN Secret

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

Configure the module in Magento

Step 1 — Open payment settings

1. In Magento admin, go to Stores → Configuration → Sales → Payment Methods.
2. Scroll to JOVEpay Crypto Payments.

Step 2 — Fill in the settings

3. Click Save Config.
4. Flush Magento cache if the payment method does not appear immediately.

Note: Merchant ID and IPN Secret are stored encrypted. Re-save the configuration after upgrading if credentials need to be re-entered.

Step 3 — IPN endpoint

The module receives signed IPNs at Magento's REST endpoint (typically):

https://yourstore.com/rest/V1/jovepay/ipn

The callback URL is provided to JOVEpay when checkout starts. Ensure this URL is reachable over HTTPS and not blocked by a firewall or WAF.

The payment widget language follows the storefront locale automatically (for example en, de, fr, es, ar, zh, and others supported by JOVEpay).

How checkout works

When a customer selects JOVEpay and places an order:

1. Magento creates the order and redirects the customer to JOVEpay's hosted payment widget.
2. The customer chooses a supported cryptocurrency and completes payment.
3. JOVEpay sends a signed IPN notification to Magento.
4. The module verifies the signature, updates the order status, and can create an invoice automatically.
5. The customer is redirected to the Magento order success page.

Order status mapping

You can review payment comments and history on the Magento order detail screen (Sales → Orders).

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 Merchant ID and IPN Secret from Payment Settings, and paste them into Magento.

Enable test mode

In the module settings, set Testnet Mode to Yes 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://magento.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 Mode and save config.
2. Log in to the demo dashboard and copy Merchant ID + IPN Secret.
3. Place a test order and select JOVEpay at checkout.
4. Complete payment on the JOVEpay hosted page.
5. Confirm the Magento order status updates to your Paid Order Status.
6. Disable Testnet Mode and switch to your production 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 the module is enabled: php bin/magento module:status Jovepay_Checkout
• Confirm Enabled is Yes under Stores → Configuration → Sales → Payment Methods → JOVEpay.
• Flush cache: php bin/magento cache:flush
• Check that Merchant ID is saved.

Order status does not update after payment

• Verify the IPN Secret in Magento matches the value in your JOVEpay dashboard.
• Confirm the IPN endpoint (/rest/V1/jovepay/ipn) is reachable over HTTPS.
• Enable Debug and review var/log/jovepay.log for IPN details.

Payments fail in test mode

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

Static content or DI compile errors after install

Re-run setup and deploy from the Magento root:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Going live

When you are satisfied with testing:

1. Set Testnet Mode to No.
2. Replace demo credentials with your production Merchant ID and IPN Secret.
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 page: jovepay.com/plugins/magento
• Create an account: app.jovepay.com/signup
• Dashboard login: app.jovepay.com/login
• Demo store: magento.jovepay.com
• Contact: [email protected]

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