Cost+Docs

OpenCart

Integrate Cost+ with your OpenCart store (4.x and 3.x / ocStore 3)

OpenCart

Integrate Cost+ as a payment method in your OpenCart store. The official NoPayn Payment Gateway extension is available for OpenCart 4 and OpenCart 3 / ocStore 3.

Prerequisites

  • Active Cost+ merchant account
  • OpenCart 4.0.0.0 or later
  • PHP 8.0 or later
  • Admin access to your OpenCart dashboard
  • Active Cost+ merchant account
  • ocStore 3.0.x or OpenCart 3.0.3.x
  • PHP 7.4 or later
  • Admin access to your OpenCart dashboard

Supported Payment Methods

  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Install the Extension

  1. Download the latest .ocmod.zip release from GitHub
  2. In your OpenCart admin, go to Extensions → Installer
  3. Upload the .ocmod.zip file
  4. Go to Extensions → Extensions → Payment
  5. Find NoPayn Payment Gateway and click Install, then Edit

Method B: Manual Upload

  1. Download or clone the repository
  2. Copy the contents of the upload/ folder into your OpenCart root directory
  3. Go to Extensions → Extensions → Payment
  4. Find NoPayn Payment Gateway and click Install, then Edit

Architecture

OpenCart 3 uses a multi-extension setup:

  • NoPayn - Global Settings — shared configuration (API key, order statuses, method availability, manual capture, debug logging)
  • NoPayn - Card Payments — credit/debit card checkout
  • NoPayn - Apple Pay / Google Pay — wallet checkout (if only one wallet is enabled, the label adjusts automatically)
  • NoPayn - Vipps MobilePay — Vipps/MobilePay checkout
  • NoPayn - Swish — Swish checkout
  1. Download the .ocmod.zip asset from the latest GitHub release

Use the .ocmod.zip asset from the release — not GitHub's auto-generated "Source code" downloads, which contain the repository layout, not the installer layout.

  1. In admin, go to Extensions → Installer
  2. Upload the .ocmod.zip file
  3. Go to Extensions → Extensions → Payments
  4. Install NoPayn - Global Settings first
  5. Open NoPayn - Global Settings and configure:
    • API key
    • Completed, pending, and cancelled order statuses
    • Available payment methods your merchant account is approved for
    • Optional: card manual capture
    • Optional: debug logging
  6. Install the checkout modules you want to expose:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. For each checkout module, set: Status, Geo Zone, and Sort Order

Method B: Manual Upload

  1. Download or clone the repository
  2. Copy the contents of the upload/ folder into your store root
  3. Go to Extensions → Extensions → Payments
  4. Follow the same install order as Method A (Global Settings first, then checkout modules)

2. Enter API Credentials

Log into the Merchant Portal and navigate to Websites, then click on the website you want to connect. Click on Integration where you will find your API key.

Cost+ Merchant Portal showing API key

In the NoPayn Payment Gateway settings, enter your API Key in the corresponding field.

In NoPayn - Global Settings, enter your API Key in the corresponding field. The API key is shared across all checkout modules — you only need to enter it once.

3. Configure Payment Settings

  1. Enable the payment methods you have been approved for
  2. Set your preferred order statuses for completed, pending, and cancelled payments
  3. Optionally restrict payments by Geo Zone
  4. Set Status to Enabled
  5. Click Save

Global Settings

NoPayn - Global Settings stores all shared configuration:

SettingDescription
API KeyYour NoPayn API key
Order StatusesCompleted, pending, and cancelled status mapping
Method AvailabilityWhich payment methods your merchant account is approved for
Manual CaptureAuthorize credit card payments only — capture later
Debug LoggingEnable detailed logging for troubleshooting

Checkout Module Settings

Each checkout module has its own storefront settings:

SettingDescription
StatusEnable or disable this payment method at checkout
Geo ZoneRestrict to specific geographic zones
Sort OrderDisplay order on the checkout page

Only activate the payment methods you have been approved for and received confirmation for.

Payment Flow

  1. Customer selects a Cost+ payment method at checkout
  2. Customer is redirected to the NoPayn Hosted Payment Page
  3. After payment, the customer returns and the order status is updated automatically
  4. NoPayn sends a webhook for asynchronous status confirmation

The extension uses the Cost+ Hosted Payment Page, meaning customers are redirected to a secure payment form. No sensitive card data is handled by your server.

Each checkout module is a separate OpenCart payment extension, giving customers distinct radio options at checkout (e.g. "Card Payments", "Apple Pay & Google Pay").

  1. Customer selects a payment method label at checkout (e.g. Card Payments)
  2. The extension creates a NoPayn hosted payment order
  3. Customer is redirected to the secure NoPayn payment page
  4. After payment, the customer returns and the order status is updated automatically
  5. NoPayn sends a webhook for asynchronous status confirmation

The Apple Pay / Google Pay module sends both methods in one transaction so the NoPayn hosted page can offer both wallet options in a single flow.

Upgrading from v1.0.0 to v2.0.0

Version 1.0.0 used a single checkout method called "NoPayn Checkout". Version 2.0.0 changes to separate checkout modules per payment method. When upgrading:

  1. Upload the new package
  2. Your existing "NoPayn Checkout" entry becomes NoPayn - Global Settings
  3. Review and save the global settings
  4. Install and enable the new checkout modules you want customers to see

4. Test and Launch

Place a few test transactions to ensure everything works smoothly. We recommend testing both successful and failed payments to confirm all scenarios are handled correctly.

Support

Need help? Reach out to our support team at support@costplus.io.

On this page