We’re here to help

back icon Back to help page

Payment gateway integration

  • 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, sign in or sign up.

    b. Navigate to "Payment settings" and enter the required information. Please make sure you remember your wallet's password. You won't be able to recover it if it's lost.

    Payments_screen_-_no_wallet.png

    That's it for now! We will contact you soon with further instructions. 

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

E-commerce plugins

  • WooCommerce integration

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

    1. Install the WooCommerce plugin

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

    38b81b3cc463071bd5c49089f4e04119.png 

    b. Search for the "WooCommerce" plugin, install it.

    1fba8dbf86443110331beb05b37e0ed3.png 

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

    2. Configure the WooCommerce plugin

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

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

    c228dc3312f7d45148a48d944ada7c01.png

    3. Install the Monetha extension

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

    737799f8c93760168d33954ca7b1a101.png

    b. Select "Upload plugin".

    a855c4855ba90c8996d0edb7275c469b.png

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

    2f1df47bddc16e4e7bac01fa176a9da0.png 

    d. Activate the extension after the successful upload.

    d0dacae92628665b3d5114909b41a95b.png

    4. Configure the Monetha extension

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

    b. Go to the "Payments" tab; you will see Monetha among other payment gateways. Select it.

    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" on the Monetha website.

    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

  • PrestaShop 1.6 integration

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

    1. Install the PrestaShop 1.6 plugin

    a. Download the PrestaShop 1.6 plugin here.

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

     step1.png

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

    step2.png

    2. Configure the PrestaShop 1.6 plugin

    a. After you successfully upload and install 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". 

     Presta_1.6_gateway_configure.png

    3. Test the gateway

    When you are ready, contact us, and we'll 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 payment gateway plugin for PrestaShop 1.7. 

    1. Install the PrestaShop 1.7 plugin

    a. Download the PrestaShop 1.7 plugin here. 

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

    Presta_1.7_upload_a_module.png

    c. Select the ZIP package that you downloaded previously.

    2. Configure the PrestaShop 1.7 plugin

    a. After you successfully upload and install 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".

    Presta_1.7_gateway_configure.png

    3. Test the gateway

    When you are ready, contact us, and we'll 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

  • Magento 1.9 integration

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

    1. Install the 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 the admin panel, "System" -> "Cache Management", press "Flush Magento Cache" and then "Flush Cache Storage".

    2. Configure the Magento 1.9 plugin

    a. Go to "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 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".

    3. Test the gateway

    When you are ready, contact us, and we'll 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 payment gateway plugin for Magento 2. 

    1. Install the Magento 2 plugin

    a. Download the Magento 2 plugin from here.

    b. Copy the 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

    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's cache with 'php bin/magento cache:disable'.
    • Install the extension with 'php bin/magento setup:upgrade' command.
    • Enable Magento's cache with 'php bin/magento cache:enable'.
    • Re-deploy the static content of Magento in case it's missing after the upgrade with 'php bin/magento setup:static-content:deploy'.

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

    If you encounter any issues on steps 2-3, they may due to an outdated build-in composer binary.

    In this case, download the 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 the Magento 2 plugin

    a. Go to "Magento" -> "Stores" -> "Configuration" 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".

    Screenshot_2018-11-12_at_11.18.37.png

    3. Test the gateway

    When you are ready, contact us, and we'll 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

  • 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

"Buy Now" button

  • Add a customized "Buy Now" button
     

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

    1. Set up a "Buy Now" button

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

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

    BuyNow1.png

    c. Enter the details of the product you are going to sell via Monetha's "Buy now" button:

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

    2. Add the "Buy Now" button to your site

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

    BuyNow4.png

    b. Place this code in your site following 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 on your website and avoid any integration overhead.

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

API & SDKs

  • 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: 

Reputation snippet

  • Add Monetha's Reputation Widget to your page

    1. Get your public profile link

    Open the Profile screen on the Monetha app, select the blue “Share your profile” button, and then "Copy link".     

    2. Add Monetha's Reputation Widget to your site

    1. Visit the "Reputation widget" creation page and paste the link you have copied into the section "Profile URL". Chose your preferred widget type.

    2. Click on the green "Create widget" button, copy the generated code.

    3. Add the code to your website.

    That is it! Your reputation snippet will be visible to all your website visitors.

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

E-commerce settings

  • Set up ERC20 to Ether exchange

    This guide will help you set up the gateway to automatically exchange your received ERC20 tokens into Ether. 

    1. Sign up for a Binance account on www.binance.com

    2. Follow their guide to create your API keys.

    3. Log into Monetha's website, go to "Payments" -> "Token Exchange", and enter the keys into "Binance API Public Key" and "Binance API Private Key" fields. 

    4. Configure your token exchange settings if needed.

    That's it! The gateway will now automatically exchange the ERC20 tokens you receive into Ether. 

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

  • Set up ether to fiat exchange and withdrawal

    This guide will show you how to set up the gateway so that you could:

    a. Automatically exchange received cryptocurrency into fiat money.

    b. Withdraw the funds to your bank account.

    1. Sign up to Kraken

    a. Go to kraken.com, create a new account.

    Screenshot_2018-11-08_at_17.24.08.png

    b. Select “Get Verified”, enter the required information. You will need at least Tier 2 verification to enable crypto to fiat conversion.

    Screenshot_2018-11-08_at_17.25.24.png

    2. Configure Kraken settings

    a. Go to “Settings” -> “API”. Press “Generate a new key”. Check all the permissions and generate the key. 

    Screenshot_2018-11-08_at_17.37.38.png

    b. Go back to the key list, select your newly created key. You will see fields called “API Key” and “Private Key”.

    Screenshot_2018-11-08_at_17.40.29.png

    b. Go to Monetha’s website. Log in, select “Payment Settings” -> “Exchange to FIAT”. Copy the “API Key” and “Private Key” to the two empty fields under “Kraken Settings”.

    Fiat.png

    3. Configure exchange settings

    Enter your preferred exchange currency and exchange type. We recommend instant exchange if you are wary of price fluctuations.

    Screenshot_2018-11-08_at_17.47.01.png

    4. Configure withdrawal settings

    a. On Kraken, select “Funding”, then “Withdraw”. Choose your preferred withdrawal currency.

    Screenshot_2018-11-08_at_17.30.05.png

    b. Click “Add account", enter your bank account details. Copy the "Description" field—that is your Withdrawal Key.

    Screenshot_2018-11-08_at_17.33.12.png

    c. Go to the “Exchange to FIAT” tab on Monetha’s website. Under “Withdrawal Settings”, paste the Withdrawal Key.

    Screenshot_2018-11-08_at_15.48.36.png

    d. Select your preferred withdrawal currency and how often you would like the payments to be made.

    That’s it! The gateway will now automatically exchange cryptocurrencies to fiat and transfer the funds to your bank account. 

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