We’re here to help

back icon Back to help page

Monetha Payment Integrations

  • How do I make a test transaction with MetaMask?

    This short guide will show you how to make a transaction with MetaMask to test Monetha's payment gateway in your e-commerce store. 

    The guide assumes that you already have Monetha's payment plugin installed and active. 

    Here's what you'll need to do:

    1. Download the MetaMask extension for your web browser.

    2. Create a new account. 

    3. Select "Ropsten Test Network" as the network of choice.

    mceclip0.png

    4. Select "Deposit", then "Get Ether" under "Test Faucet". This will open a new tab. 

    Meta_guide.png

    5. Request one or more Ethers from the faucet.

    6. On your website, add any item to a cart, go to checkout, and select "Monetha" as the payment method. 

    7. On the payment screen, select "Ethereum (ETH)" as your currency.

    mceclip3.png

    8. Open the MetaMask extension, select "Send", enter the transaction details, and confirm your payment. 

    mceclip4.png

    That's it! You've just made a test payment. 

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • Preliminary steps

    Thank you for your interest in Monetha's payment gateway! This article will help you prepare for the integration. 

    1. Fill in the form

    First, please complete our Merchant form. It will provide us with the necessary information about your business.

    2. Enable payments

    a. Go to https://www.monetha.io/user/login, then sign in or sign up.

    b. Navigate to "Payment settings" and enter the required information. If you're using the Monetha wallet, please make sure that you have its password. We recommend using our wallet.

    Payments_screen_-_no_wallet.png

    That's it for now! We will contact you and give you further instructions. 

  • PrestaShop 1.6 integration

    This article will show you how to install and set up Monetha's PrestaShop 1.6 plugin. 

    1. Install PrestaShop 1.6 plugin

    a. Download PrestaShop 1.6 plugin here.

    b. Go to PrestaShop admin panel. Navigate to "Modules and Services" and press "Add a new module". 

     step1.png

    c. In “Add a new module” section press “Choose a file” and select ZIP package that you have downloaded previously. 

    step2.png

    2. Configure PrestaShop 1.6 plugin

    a. After the successful upload and installation of the plugin, you will be able to see it in the list of modules. To configure the Monetha plugin press “Configure” next to "Monetha Gateway". 

     step3.png

    b. Select "Yes" next to "Enabled", enter the following information:

    • Merchant Secret
    • API key

    At first, we will provide you with test credentials to try out the payment gateway in a safe sandbox environment.  

    • Set Test Mode to "Yes" for live shop 

     Presta_1.6_gateway_configure.png

    3. Test the gateway

    When you are ready, contact us and we will send a test order to your shop. Alternatively, you can explore the gateway yourself.

    4. Set it live

    a. After making sure that everything is working, we will create your own "Merchant Secret" and "API key". They can be found in "Payment settings".

    API_Secret.png

    b. Simply replace the test credentials with your newly made "Merchant Secret" and "API key", then set Test Mode to "No".

    That’s it! You are ready to accept cryptocurrency!

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • PrestaShop 1.7 integration
     

    This article will show you how to install and set up Monetha's PrestaShop 1.7 plugin. 

    1. Install PrestaShop 1.7 plugin

    a. Download PrestaShop 1.7 plugin here. 

    b. Go to PrestaShop admin panel. Navigate to “Modules and Services” and press “Upload a module”

    Presta_1.7_upload_a_module.png

    c. Select ZIP package that you have downloaded previously.

    2. Configure PrestaShop 1.7 plugin

    a. After the successful upload and installation of the plugin, you will be able to see it in the list of modules. To configure the Monetha plugin press “Configure” next to “Monetha Gateway”. 

    Presta_1.7_configure_modules.png

    b. Select "Yes" next to "Enabled", enter the following information:

    • Merchant Secret
    • API key

    At first, we will provide you with test credentials to try out the payment gateway in a safe sandbox environment.  

    • Set Test Mode to "Yes" for live shop

    Presta_1.7_gateway_configure.png

    3. Test the gateway

    When you are ready, contact us and we will send a test order to your shop. Alternatively, you can explore the gateway yourself.

    4. Set it live

    a. After making sure that everything is working, we will create your own "Merchant Secret" and "API key". They can be found in "Payment settings".

    API_Secret.png

    b. Simply replace the test credentials with your newly made "Merchant Secret" and "API key", then set Test Mode to "No".

    That’s it! You are ready to accept cryptocurrency!

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • WooCommerce integration

    This article will show you how to install and set up Monetha's plugin for WooCommerce. 

    1. Install WooCommerce plugin

    a. Go to the "Plugins" section in the menu and Click "Add new".

    38b81b3cc463071bd5c49089f4e04119.png 

    b. Search for a "WooCommerce" plugin and click "Install".

    1fba8dbf86443110331beb05b37e0ed3.png 

    c. After the plugin has been successfully installed, activate the "WooCommerce" plugin.

    2. Configure WooCommerce plugin

    a. Go to WooCommerce -> Settings section in the menu.

    b. Set your local currency, selling location, and other settings.

    c228dc3312f7d45148a48d944ada7c01.png

    3. Install Monetha extension

    a. Go to the "Plugins" section in the menu and click "Add New".

    737799f8c93760168d33954ca7b1a101.png

    b. Click "Upload plugin".

    a855c4855ba90c8996d0edb7275c469b.png

    c. Upload Monetha WooCommerce extension which can be downloaded from here.

    2f1df47bddc16e4e7bac01fa176a9da0.png 

    d. Activate the extension after the successful upload.

    d0dacae92628665b3d5114909b41a95b.png

    4. Configure Monetha extension

    a. Go to WooCommerce -> Settings section in the menu.

    b. Go to the "Payments" tab, you will see Monetha among other payment gateways. Click on Monetha.

    Woo_configure_modules.png

     c. Enter the following information:

    • Merchant Secret
    • API key (token)

    At first, we will provide you with test credentials to try out the payment gateway in a safe sandbox environment.  

    • Make sure that "Test Mode" is checked.

    Woo_gateway_configure.png

    d. Save your changes.

    5. Test the gateway

    When you are ready, contact us and we will send a test order to your shop. Alternatively, you can explore the gateway yourself.

    6. Set it live

    a. After making sure that everything is working, we will create your own "Merchant Secret" and "API key". They can be found in "Payment settings".

    API_Secret.png

    b. Simply replace the test credentials with your newly made "Merchant Secret" and "API key", then uncheck "Test Mode".

    That’s it! You are ready to accept cryptocurrency!

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • Magento 1.9 integration

    This article will show you how to install and set up Monetha's Magento 1.9 plugin. 

    1. Install Magento 1.9 plugin

    a. Download the Magento 1.9 plugin here.

    b. Extract the downloaded ZIP package and copy the contents of the "app" folder to your Magento's "app" folder.

    c. Flush the Magento cache. Navigate to administration panel "System" > "Cache Management", press "Flush Magento Cache" and then "Flush Cache Storage".

    2. Configure Magento 1.9 plugin

    a. Go to Magento Admin Panel > System > Configuration. 

    b. Find the “Sales” section on the left side of the window and click “Payment Methods”. 

     3. Expand the section of Monetha Gateway and enable the gateway. Fill in the following information:

    • Title
    • Merchant Secret
    • API token

    At first, we will provide you with test credentials to try out the payment gateway in a safe sandbox environment.  

    • Set Test Mode to "Yes" for live shop 

    3. Test the gateway

    When you are ready, contact us and we will send a test order to your shop. Alternatively, you can explore the gateway yourself.

    4. Set it live

    a. After making sure that everything is working, we will create your own "Merchant Secret" and "API key". They can be found in "Payment settings".

    b. Simply replace the test credentials with your newly made "Merchant Secret" and "API key", then set Test Mode to "No".

    That’s it! You are ready to accept cryptocurrency!

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • Magento 2 integration

    This article will show you how to install and set up Monetha's Magento 2 plugin. 

    1. Install Magento 2 plugin

    a. Download the Magento 2 plugin from here.

    b. Copy Monetha folder into app/code

    1.

    php ./vendor/composer/composer/bin/composer config repositories.monetha/payment-plugin-php-sdk vcs https://github.com/monetha/payment-plugin-php-sdk.git

    2.

    php ./vendor/composer/composer/bin/composer require monetha/payment-plugin-php-sdk:dev-master

    (in case if you're updating the plugin version, run this instead)

    php ./vendor/composer/composer/bin/composer update monetha/payment-plugin-php-sdk)

    c. Perform the following actions:

    • Disable Magento cache with 'php bin/magento cache:disable'.
    • Install the extension with 'php bin/magento setup:upgrade' command.
    • Enable Magento cache with 'php bin/magento cache:enable'.
    • Re-deploy static content of Magento in case it missing after upgrade 'php bin/magento setup:static-content:deploy'.

    Access tokens for repo.magento.com (if required) you can get here.

    Issues that you may encounter on the 2-3 steps can be related with outdated build-in composer binary.

    In this case download newest composer.phar and run it instead like php /path/to/composer.phar ... or just composer ... if you have it in your $PATH).

    2. Configure Magento 2 plugin

    a. Go to Magento -> Stores -> Configuration section in the menu. 

    step1.png

    b. Under "Sales" select "Payment Methods".

    step2.png

    c. Click "Other Payment Options".

    step3.png

    d. Select "Yes" next to "Enabled", enter the following information:

    • Merchant Secret
    • API key

    At first, we will provide you with test credentials to try out the payment gateway in a safe sandbox environment.  

    • Set Test Mode to "Yes" for live shop 

    Screenshot_2018-11-12_at_11.18.37.png

    3. Test the gateway

    When you are ready, contact us and we will send a test order to your shop. Alternatively, you can explore the gateway yourself.

    4. Set it live

    a. After making sure that everything is working, we will create your own "Merchant Secret" and "API key". They can be found in "Payment settings".

    API_Secret.png

    b. Simply replace the test credentials with your newly made "Merchant Secret" and "API key", then set Test Mode to "No".

    That’s it! You are ready to accept cryptocurrency!

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • Add a customized "Buy Now" button
     

    Here are the steps you will need to start using the "Buy Now" button:

     

    1. Set up "Buy Now" button

    a. Visit the "Buy now" button creation page.

    b. Set the "API Token" that was provided to you by the Monetha team. You can also define "Return URL" where users should be redirected when a purchase is completed.

    BuyNow1.png

    c. Set the product information that you are going to sell via the Monetha "Buy now" button:

    • Product name
    • Item ID (your internal id, for order tracking)
    BuyNow2.png
     d. Customise the button's text and size.
    BuyNow3.png
     e. Click "Create button" after you add all required information.
     

    2. Add "Buy Now" button to your site

    a. After you click "Create button", HTML code and required Javascript code will be generated. 

    BuyNow4.png

    b. Place this code in your site depending on its configuration: e.g. in Wordpress you can simply put the button and javascript code on the same page.

    step5.png 

    That's it! You are ready to accept cryptocurrency!

    You can create as many "Buy now" buttons as you need to your website and avoid any integration overhead.

    If you have any questions or requests, feel free to ask them via merchants@monetha.io

  • API integration

    You can use Monetha's APIs to build your own custom solutions on top of Monetha's technology. Currently, we provide two application programming interfaces: