OpenCart v2.x and v3.x Extension for AtomicPay Payment Gateway
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
upload
CONTRIBUTING.md
LICENSE
README.md

README.md

AtomicPay

AtomicPay For OpenCart Extension

This is an open source extension for OpenCart, allowing merchants to start accepting cryptocurrency payments on their OpenCart website by simply installing the extension. AtomicPay is a decentralized cryptocurrency payment processor that eliminates the involvement of a third-party payment gateway, allowing merchants to accept payments directly from their customers, in a secured and trustless environment.

Follow us on our developments

We develop in lightning speed! If you would like to keep up with what we are building or our upcoming cool features, please follow us on AtomicPay Official Channels:

Meanwhile, here is a short deck to learn more about AtomicPay: https://www.slideshare.net/atomicpay/atomicpay-decentralized-noncustodial-payment-gateway-126944216

Prerequisites

  • Last Version Tested: OpenCart Version 2.3.0 to 3.0.2

Server Requirements

  • SSL is Highly Recommended
  • OpenCart >= 2.1
  • PHP5 Curl Must be compiled with PHP
  • PHP >= 5.4 (Tested on v7.1)
  • JSON

Getting Started

AtomicPay For OpenCart Extension is designed to be "Plug-n-Play" installation without any programming knowledge. Anyone can do it! To set up our extension quickly, please follow the following guide.

Installation

Visit the Releases page of this repository and download the latest version. Once this is done, you can just login to OpenCart's Admin Panel > Extensions > Installer, click on Upload, select the downloaded file and the auto-installation will run. Upon successful installation, you should see the following message: "Success: You have modified extensions!"

Installer

Next, go to Admin Panel > Extensions > Extensions > Select Payments from Dropdown List > Find AtomicPay and click on the green + sign button to install the extension

Click Install

WARNING: It is good practice to backup your databases before installing extensions. Please make sure you have created backups.

Youtube Video - Step by Step Installation

Click on the image to view our installation video

Video - Step by Step Installation For OpenCart Extension

Authorization Pairing

Authorization Pairing can be performed using the Settings of AtomicPay Extension. Once logged in OpenCart admin panel, you can find the configuration settings under Admin Panel > Extensions > Extensions > Select Payments from Dropdown List > AtomicPay > Click on the Edit button

Edit Settings

STEP 1

Login to your AtomicPay Merchant Account and go to API Integration page. You will need the following values for next step: ACCOUNT ID, PRIVATE KEY and PUBLIC KEY.

API Keys

STEP 2

Here you will need to copy and paste the values from STEP 1 into the corresponding fields: Account ID, Private Key and Public Key. Next, select Status > Enabled and click on the Save Button on the top right corner. The extension will attempt to connect to AtomicPay Server for an authorization.

Authorization

FINAL STEP

Once authorization is successful, you should see the following message: "Authorization Successful. AtomicPay plugin settings updated"

Step 3

Congrats your extension is activated and the Pay with AtomicPay option will be available during your customer checkout process.

Configuration

Transaction Speed

You can select a default Transaction Speed value. HIGH Risk speed require 1 confirmation, and can be used for digital goods or low-risk items. MEDIUM Risk speed require at least 2 confirmations, and should be used for mid-value items. LOW Risk speed require at least 6 confirmations (averaging 30 mins, depending on selected cryptocurrency), and should be used for high-value items.

Notification URL (IPN)

AtomicPay will send IPNs to this notification URL, along with the invoice data in JSON format. It is default to the callback function within the extension. Only make changes to this field, if you know what you are doing

Redirect URL

Your customers will be redirected back to this URL after successful, expired or failed payment. It is default to the success function within the extension. Only make changes to this field, if you know what you are doing

Order Status Tab

Here you can configure how AtomicPay's IPN (Instant Payment Notifications) trigger the various order states in your OpenCart store. Click on the blue tip icon to understand more about individual status. You may leave it as our default values which are common values for majority of stores.

Order States

Once configurated, click Save Button at the top right corner.

Usage

Once activated, your customers will be given the option to pay via AtomicPay which will redirect them to AtomicPay checkout UI to complete the payment. On your OpenCart backend, everything remains the same as how you would use other payment processors such as PayPal, etc. AtomicPay is designed to be an addtional option on top of the existing payment options which you are already offering. There will be no conflicts with other extensions.

Note: In order for AtomicPay to generate payment invoices, please remember to setup your cryptocurrency view-only wallets at AtomicPay Merchant Panel.

Troubleshooting and Debugging

AtomicPay for OpenCart Extension is designed with an easy-to-understand and detailed debug logging feature. In the event where you experience issues or bugs, please enable the Debugging option and replicate the issue. Click on View Logs and you will be able to detect any events associated with [Error]. Open an issue with your debug logs by following our Bug Reporting Guidelines

Debug Log

Contributions & Developments

Anyone and everyone is welcome to contribute or develop for this extension. Please take a moment to review the guidelines for contributing to AtomicPay for OpenCart Extension.

License

AtomicPay is released under the MIT License. Please refer to the License file that accompanies this project for more information including complete terms and conditions.