Skip to main content

Nimbbl supports easy acceptance of payments on your Opencart store. We have created a simple plugin that you can install on your store. This guide will explain the step by step process to integrate the plugin.

SAMPLE EXPERIENCE
  • To see our checkout in action on Opencart you can click here and perform a live transaction.

Compatibilities and Dependencies​

  1. Always keep a backup of your existing Opencart installation including the Mysql Database, before installing a new module
  2. Nimbbl supports Opencart 2.3 and 3.0

Install Plugin​

You can Install the Nimbbl plugin either from the Opencart Extension Installer or by manually uploading the code zip file

Install via Opencart Extension Installer(Recommended)​

  1. Login to the Opencart Admin panel and go to Extension Installer. Make sure the Extension installer is already configured and working

    Open_cart_installer

  2. Click on "Upload file" and select the downloaded module ocmod.zip

    Opencart_installion_done

Installing Manually​

  1. Download the latest Source code zip file.

  2. Unzip the content of the module zip in a folder. Upload the content of “upload” folder (admin, catalogue) to your Opencart root folder.

  3. Now in Opencart, login to your admin account and go to Extensions-> Payments option. It will show you the Nimbbl module. opencart_payments

  4. Click the Install option on the right to install the module in the Opencart engine.

    opencart_install

  5. Now click Save and your customers will get the Nimbbl option during the checkout process.

    IMPORTANT
    • If you are installing the module for the first time then all files will be uploaded automatically to the appropriate locations, or else, a list of files will be shown to be overwritten, and clicking on the Continue button will perform the copy/installation.

Configure Plugin​

Once the plugin has been installed, you need to configure it so you can start accepting payments. There are multiple configurations that you can do to customise the plugin for your needs.

To be able to manage the configuration, you need to search for Nimbbl

  1. Choose extension type as payments

    opencart_payments

  2. Find Nimbbl to be able to see your configuration options

    opencart_Nimbbl

Enable/Disable Nimbbl​

To accept payments through Nimbbl, the plugin should always be Activated. If you deactivate the plugin, the Nimbbl option will not show up on your checkout page.

  1. To Enable/Disable - click on "Install/Uninstall"

    opencart_uninstall

Managing Credentials & Environments​

The Nimbbl opencart Plugin works for both Test and Live environments. You can configure different keys for each environment and toggle settings to use different environments.

  1. Click on Edit to conifgure credentials and manage environments.

    opencart_Nimbbl

  2. Set the Payment Mode to Test or Live depending on your requirement.

    opencart-extension1

    IMPORTANT
    • Using Test Payment Mode does not affect your Live data or interact with the banking networks.
    • Using Live Payment Mode results in actual transactions and money being deducted from your bank or card.

  3. Add in your Live and Test access_key and access_secret available in the Nimbbl Dashboard. Enter the endpoint URL as https://api.nimbbl.tech for both Environments

    opencart_credspage

    IMPORTANT
    • If you don't currently have Live keys, you can keep it blank and update it later.
    • access_secret is like a password, please don't share with others.

Setting up Webhooks​

The plugin is designed to consume webhooks from the Nimbbl server. These webhooks can help update the status of a "Pending" order if the payment transaction becomes successful in the future. It is rare but totally normal for payments to not succeed in real time. To read about payment states, you can click here.

  1. Click on Edit to conifgure credentials and manage environments.

    opencart_Nimbbl

  1. Your webhook URL is automatically generated by the plugin and is displayed as shown below.

    opencart_webhook

  1. Share this Webhook URL with the Nimbbl team to whitelist.

    IMPORTANT
    • Ensure that your webhook URL is publicly accessible and is not blocked by a firewall
    • If you need to whitelist our IP to hit this URL, please reach out to us and we will provide our IP address

Test Your Store​

Ensure the Test Mode is enabled as shown above. You can test your store by using these test values.

Go Live​

Once everything is running fine in the test mode, you can write to us at help@nimbbl.biz. We will review your integration and help you get ready to go on production.

In parallel, ensure that you or your team has completed your payment gateway documentation so that the payment partner (PSP) of your choice can approve your credentials.

As soon as your account is approved by the PSP and your integration is working fine, you will be able to view your Live access_key & access_secret in the dashboard. To learn how to view and download your keys, please click here

You will need to add the Live keys and toggle the Payment Mode to Live as explained above.