Cost+Docs

Magento

Integrate Cost+ with your Magento store (2.x and 1.9 / OpenMage LTS)

Magento

Integrate Cost+ as a payment method in your Magento store. The Cost+ extension is available for Magento 2 (2.4.6 – 2.4.8) and Magento 1.9 (including OpenMage LTS 20+).

Prerequisites

  • Active Cost+ merchant account
  • Magento 2.4.6 – 2.4.8 installation
  • PHP 8.2 – 8.4
  • Admin access to your Magento admin panel
  • SSH access to your server (for Composer installation)
  • Active Cost+ merchant account
  • Magento 1.9.x or OpenMage LTS 20+
  • PHP 7.4 or later
  • Admin access to your Magento admin panel
  • SSH or FTP access to your server

1. Install the Extension

Connect to your Magento server via SSH and navigate to your Magento root directory.

Install the plugin:

composer require nopayn/nopayn-magento-2

Run Magento setup commands:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

If you are in production mode, also run:

php bin/magento setup:static-content:deploy

Method B: Manual Installation

  1. Navigate to your app/code directory
  2. Download and unzip the Cost+ release from GitHub
  3. Run the setup commands:
php bin/magento setup:upgrade
php bin/magento cache:clean

If in production mode:

php bin/magento setup:static-content:deploy

Download or clone the module from GitHub.

Copy the contents of app/ into your Magento root app/ directory:

cp -r app/* /path/to/magento/app/

Clear the Magento cache:

rm -rf var/cache/*

Log in to the Magento admin panel and navigate to System → Configuration → Sales → Payment Methods to verify the NoPayn Payment Gateway section appears.

The module creates a nopayn_transactions table in your database to track payment transactions. This is created automatically on first use.

2. Configure the Plugin

  1. Go to Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Enter your API key (see step 3 below)
  3. Enable the payment methods you have been approved for
  4. Save changes
  1. Go to System → Configuration → Sales → Payment Methods
  2. Locate the NoPayn Payment Gateway section
  3. Enter your API key (see step 3 below)
  4. Enable individual payment methods (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Optionally restrict by country
  6. Save configuration

3. 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

Paste the API key into the configuration field and save.

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

Supported Payment Methods

Checkout NameNoPayn Identifier
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Payment Flow

  1. Customer selects a payment method at checkout and places the order
  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
  1. Customer selects a payment method at checkout and places the order
  2. Order is created with status Pending Payment
  3. Customer is redirected to the NoPayn secure payment page
  4. After payment:
    • Success — customer returns, status verified via API, order set to Processing
    • Cancelled — customer returns, order set to Canceled
    • Expired (5-minute timeout) — webhook fires, order set to Canceled
  5. NoPayn sends a webhook for asynchronous status confirmation

Order Status Mapping

NoPayn StatusMagento Order StateMagento Order Status
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhooks

The module registers a webhook endpoint at /nopayn/payment/webhook. This URL is automatically sent to NoPayn when creating orders. The webhook always verifies the order status via the NoPayn API before updating the Magento order.

No manual webhook configuration is required — the module handles registration automatically.

4. Test Your Setup

  1. Place a few test transactions — both successful and failed
  2. Verify all enabled payment methods appear at checkout
  3. Configure capture behavior (auto-capture vs. manual) based on your fulfillment process

Support

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

On this page