Back to Top

User Guide for Magento 2 Bitcoin and Crypto Payments

Updated 15 March 2024

Magento 2 Bitcoin and Crypto Payments extension is a powerful payment solution designed to enable e-commerce businesses to accept payments in cryptocurrencies. This extension supports more than 50+ cryptocurrencies.

With this extension, the merchants can seamlessly integrate popular cryptocurrencies like Bitcoin, Dogecoin, Ripple, and others into their Magento 2 stores, providing customers with a secure and efficient payment option.

Cryptocurrency transactions are lightning-fast, providing a seamless shopping experience for your customers and reducing the Magento 2 Abandon Cart rates.

Check the below mentioned video to understand the workflow of the extension:


Features of Magento 2 Bitcoin and Crypto Currencies

  • Customers can pay with cryptocurrencies for the orders placed within your store.
  • The admin can add, edit, and delete crypto payment methods.
  • Wallet QR Code can be displayed on the checkout and on the respective order details page.
  • A payment reminder email is sent to the customer.
  • The customer receives the transaction mail.
  • Payment receipt mail is sent to the customer after the crypto payment is confirmed.
  • Specify how many reminders will be sent to customers and over what period of time.
  • The admin can specify the number of days after which the order gets canceled automatically if the customer did not make the payment.
  • For specific customer groups, currencies, and carriers the admin can restrict crypto payment methods.
  • Display crypto payment methods in a flat or dropdown list as required at the checkout time.
  • The admin can set a custom title for the crypto payment method.
  • On the order details page the customers can view the crypto payment details.
  • Add destination tag/memo for crypto currencies that require one.

Note: Due to the fact that cryptocurrency rates update frequently, the exchange rate at the time the order is placed is considered. At the time of placing the order, the customer must pay the exact crypto amount.

Searching for an experienced
Magento 2 Company ?
Find out More


#Download Module

Firstly, you need to log in to Webkul Store, go to My Account>My Purchased Products section, verify and then download and extract the contents of this zip folder on the system.

#Upload Folder

Once the module zip extracts, follow path src>app and then copy the app folder into the Magento 2 root directory on the server as shown below:

Magento 2 opencart connector installation

#3 Run Commands

You need to run the following commands:

  • php bin/magento setup:upgrade
  • php bin/magento setup:di:compile
  • php bin/magento setup:static-content:deploy
  • php bin/magento indexer:reindex
  • php bin/magento cache:flush

Language Translation

For translating the module language, navigate through src/app/code/Webkul/BitcoinCryptoPayment/i18n and edit the en_US.csv file. Thereafter, rename the CSV as “en_SA.csv” and translate all right side content after the comma in the Arabic language. After editing the CSV, save it.

Magento 2 opencart connector language translation

Now, upload it to the path src/app/code/Webkul/BitcoinCryptoPayment/i18n where the installation of Magento 2 is on the server. The module translates into the Arabic Language. It supports both RTL and LTR languages.

The user can edit the CSV like the image below.


Initial Configuration

After the successful installation of the extension, the admin will configure the extension. To do so, navigate through Stores->Configuration->Sales->Payment methods->Webkul BitCoinCryptoPayment.


Here, the admin will configure the payment gateway by –

  • Enabling or disabling the BitCoin Crypto Payment.
  • Setting up the title for the crypto payment method visible at the checkout to customers.
  • Choose to display the wallet address as a QR code with wallet details to the customers.
  • Choose the payment listing style at the checkout as a Flat or Drop-down option.
  • Enable the mail to admin on the payment confirmation.
  • Enable sending a payment reminder mail to the customer.
  • Choose the number of reminder emails to send to the customer.
  • Set the reminder interval as required between the emails.
  • Enable cancel order to cancel the order after the provided time period automatically.
  • Set the cancel order time period in days. It should be greater than the reminder time in days.
  • Set the sort order of the payment method at the checkout time.

Lastly, save the configuration settings by tapping the Save Config button.

Email Configuration Settings

To select the configured email templates, the admin can navigate through Stores->Configuration->Webkul->Bitcoin Payments.


Here, the admin will choose the respective email templates –

  • Select the payment receipt email template.
  • Choose the template for the customer transaction.
  • Select the email template for the customer reminder email.

Lastly, save the configuration by tapping the Save Config button in the top right-hand corner.

Add Magento 2 Bitcoin Crypto Payment Methods

After the successful installation, the admin will find the BitCoin Crypto Payments option on the side panel. Under that option, the admin will find all of the crypto payment lists if the admin has added any.


For the already added crypto payment lists the admin can perform bulk actions like – Delete and change the status of the crypto payments.


Apart from that, for each crypto payment, the admin can edit it, view the respective orders placed using the same, and delete the crypto payment.


Tapping the view order will display the details of the order placed using the cryptocurrencies.

To add a new crypto payment, the admin can tap the Add New button in the top-right-hand corner of the same page. This brings up the crypto payment form section to add a new crypto payment as shown below in the snapshot.

Here, the admin will –

  • Enter the crypto payment name to display to the customers at checkout time.
  • Set the unit for the crypto payment like – BTC, XRP, ETH, etc.
  • Enter the wallet address to receive the payment from the customer.
  • Enable the destination tag/memo if required for the crypto payment method.
  • Enter the number of decimal places you want to display for the cryptocurrency.
  • Select the customer groups to whom this crypto payment will be accessible.
  • Select the currencies for which the crypto payment method will be accessible.
  • Select the carriers for which the crypto payment method is accessible.
  • Set the position of the crypto payment method.
  • Enable the crypto payment method.

Lastly, tap the Save button to save the crypto payment method.

Note – If you want to create an NFT Marketplace check our Magento 2 NFT Marketplace extension for buying and selling digital assets.

Magento 2 BitCoin Crypto Payments – Storefront Workflow

Once a customer has added products to the cart, he can view the crypto payment method under the payment methods when he proceeds to checkout on the review & payments page.


The above display of the crypto payment methods is in the flat style. If the admin chooses the display style as drop-down then the crypto payment methods display in a drop-down style as shown below.


The customer can choose the crypto payment method as required and can proceed further by tapping the Place Order button. This brings up the below pop-up on the screen as shown below.

Here, from the configuration settings the admin has set to display the QR code as well so the address QR code displays on the pop-up.


The customer can see the details like – the amount in cryptocurrency that needs to be paid, the wallet address where payment is to be done, and the product reservation days.

Now, the customer needs to tap on the Place Order button and after that can see the below details.


Now, to confirm the payment, after the customer has paid to the wallet address, the customer will enter the transaction id on the respective order details page.


After entering the transaction id and tapping the confirm payment the customer for the respective order can see the below details.


After the admin receives the cryptocurrency and verifies the payment in his wallet he will generate the invoice and shipment for the order and the customer can then see the details for the same.


Some of the crypto payment methods require a destination tag/memo to be setup to receive the payments.

Now, in this case, when the admin is creating a crypto payment method, the admin can enable the toggle button for enabling the destination tag/memo field for the respective cryptocurrency.

After saving the cryptocurrency, if the customers choose this cryptocurrency payment method then they can see the admin’s wallet address along with the destination tag/memo as required.

Email Notifications

Payment Reminder mail to customer

Awaiting Crypto Payment Mail

Crypto Payment Confirmed by Customer

Admin Order Details View Bitcoin Crypto Payments

When the customer places the order without making the payment on the wallet address, the status for the order is shown as awaiting payment.

When the customer makes the payment on the wallet address, the status for the order is shown as Verifying Crypto Payment.


The admin can also see the crypto payment method selected by the customer along with the status.


After the realization of the crypotocurrency credit, the admin will generate the invoice and shipping for the order. Apart from that, for the particular order, the admin can view the details of the transaction id and the parent transaction id.



That is all about the Magento 2 BitCoin Crypto Payments extension. If you have any queries regarding the plugin, please contact us at Webkul Support System.

If you’re looking to create a custom e-commerce website, it’s a great idea to hire Magento developers who can help you build a powerful and scalable online store.

You can also check our complete Magento 2 extensions.

Current Product Version - 4.0.1

Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*

Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content