README

JOVEpay Crypto Payment Gateway

JOVEpay is a crypto payment gateway. Accept Bitcoin, Ethereum, stablecoins, and 100+ other cryptocurrencies on Magento Open Source and Adobe Commerce storefronts. Settlement goes to your wallet via JOVEpay.

The hosted payment widget supports light and dark themes, and displays in multiple languages based on the customer’s Magento store locale.

What is a Crypto Payment Gateway?

A crypto payment gateway acts as a bridge between the merchant’s website and the cryptocurrency network, allowing the merchant to receive payments in cryptocurrency. Customers pay on JOVEpay’s hosted checkout widget; Magento receives order status updates through secure Instant Payment Notifications (IPN).

Requirements

Magento Open Source / Adobe Commerce 2.x (2.4.x recommended)
PHP >= 7.3
An open and activated JOVEpay merchant account. If you do not have an account yet, create one. The plugin cannot process payments until the account is activated.
Merchant ID (API key) and IPN Secret from the JOVEpay dashboard

Plugin Installation Guide

1. Install From Magento Marketplace

You can install the JOVEpay plugin from the Magento Marketplace with Composer.

Log in to your server and go to your Magento root directory.
Download the plugin using this command:

composer require jovepay/magento2:1.0.0

1.0.0 is the current plugin version. Check for the latest version before running the command.

You may be asked for a username and password while installing.
Get the public key and private key from Access Keys under My Profile on the Adobe Commerce Marketplace.
Enter the public key as the username and the private key as the password.
Enable the module:

php bin/magento module:enable Jovepay_Checkout

2. Install Manually (app/code)

Copy the Jovepay/Checkout module into app/code/Jovepay/Checkout.
Enable the module:

php bin/magento module:enable Jovepay_Checkout

3. After Downloading The Plugin

In order to proceed further, please run the following commands:

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 enable and adjust JOVEpay by implementing these steps:

Stores → Configuration → Sales → Payment Methods

Plugin Configuration

On the configuration page, scroll to the JOVEpay payment method box and fill in the settings for your store.

Make sure Yes is selected in the Enabled option. You can change the Title according to your preferences.
Optionally enable Testnet Mode for safe end-to-end testing.
Choose the payment widget theme with Dark Mode Checkout:
- No — light theme
- Yes — dark theme
Enter a valid Merchant ID and IPN Secret from the JOVEpay dashboard (see below).
Be sure when selecting New Order Status and Paid Order Status, because these appear on your website when the order status is displayed to the customer.
Optionally enable Debug to write IPN details to var/log/jovepay.log.
To save this setting, use the Save Config button at the top right of the page.

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

Get Credentials From JOVEpay Dashboard

Before enabling payments, complete the following in app.jovepay.com:

Sign in (or create and activate) your merchant account.
Open Payment Settings.
Under API, copy your Merchant ID / API key.
Under Webhooks (Instant Payment Notifications), copy your IPN Secret.
Head back to your Magento store, paste these values into the JOVEpay payment method settings, and click Save Config.

Payment processing is handled by JOVEpay. See jovepay.com for terms and privacy details.

How To Make Payment

Once a customer fills in the mandatory details and orders a product, the system takes them to the Magento checkout payment step.
They select JOVEpay (or the title you configured) and click Place Order.

Magento redirects them to the JOVEpay hosted payment widget. The widget supports light and dark themes and the store’s language.

The customer pays with their preferred cryptocurrency.
JOVEpay sends a signed IPN to Magento. The plugin verifies the signature, updates the order status, and can create an invoice automatically.
Once payment is confirmed, the customer is redirected to the Magento order success page.

Congratulations! The customer has successfully paid for the product with JOVEpay.

Check Order Details

Go to your Magento admin panel menu and click Sales. Once the sidebar opens, click Orders.

Once you reach the orders page, you will see a list of your orders. Select an order paid using JOVEpay’s payment option.
Click View on the order. Confirm the payment method and that the order status matches your configured Paid Order Status after a successful IPN.

If debug logging is enabled, review var/log/jovepay.log for IPN details when troubleshooting.

Features

Hosted JOVEpay payment widget with light and dark themes
Multi-language checkout UI based on the Magento store locale
HMAC-signed Instant Payment Notifications (IPN)
Automatic invoice creation on successful payment
Configurable order statuses and testnet mode
Optional debug logging to var/log/jovepay.log

Release Notes

Version 1.0.0 (Initial Release)

Initial public release of the JOVEpay crypto payment gateway for Magento Open Source and Adobe Commerce 2.x
Hosted payment widget with light and dark themes
Multi-language checkout UI based on the Magento store locale
HMAC-signed Instant Payment Notifications (IPN) with signature verification
Automatic invoice creation on successful payment
Configurable new/paid order statuses, testnet mode, and optional debug logging
Merchant ID and IPN Secret stored as encrypted admin configuration
Storefront and admin strings translatable, with locale packs included
Payment method disabled by default until configured

Support

Email: dev@jovepay.com
Website: https://www.jovepay.com

License

GPL-3.0-or-later. See LICENSE.txt.

jovepay / magento2

Package info

Security

Statistics