COPN Payment Gateway for Nigerian Businesses

Description

COPN stands for CheckoutPay Nigeria. COPN Payment Gateway for Nigerian Businesses is the official extension that connects your online store to CheckoutPay for Nigerian bank-transfer payments.

Install WooCommerce separately; this plugin adds CheckoutPay as a payment method. COPN is operated by CheckoutPay and is not affiliated with WooCommerce or Automattic.

How it works

  1. Your customer selects CheckoutPay at checkout and places the order.
  2. The plugin creates a payment request on your CheckoutPay business account and shows bank transfer instructions on the order thank-you page (account number, bank name, amount).
  3. When CheckoutPay confirms the incoming transfer, the order updates automatically via webhook, or the customer can use Check payment status on the thank-you page.

Who it is for

Store owners in Nigeria who want reliable bank-transfer checkout with virtual account details, fee transparency, and automatic order status updates — without custom code.

Requirements

  • WordPress 5.8 or later
  • WooCommerce 7.0 or later
  • A CheckoutPay merchant account with an API key and an approved website URL

Features

  • WooCommerce classic checkout and Cart/Checkout blocks
  • HPOS (High-Performance Order Storage) compatible
  • Virtual account / bank details on the thank-you page
  • Webhook endpoint for automatic order status updates
  • Optional mark order completed when payment is approved
  • Thank-you page: check payment status and correct paid amount if the customer transferred a different sum
  • Test mode for development
  • Admin settings: copy webhook URL and website URL, live fee preview from CheckoutPay

This plugin does not add “powered by” links or promotional banners on your storefront. Links to CheckoutPay appear only in the WordPress admin settings screen where you configure API credentials.

Ownership

Developed and maintained by CheckoutPay (check-outpay.com). COPN is the CheckoutPay Nigeria product line for merchant bank-transfer checkout.

External services

This plugin relies on CheckoutPay (operated by CheckoutPay / check-outpay.com), a third-party payment platform in Nigeria. CheckoutPay is required to create bank-transfer payment requests, show virtual account details to customers, confirm payments, and load fee rules for your store. The plugin does not process payments on its own.

Service: CheckoutPay merchant API (default base URL: https://check-outpay.com/api/v1). Merchants may point the API URL setting to another CheckoutPay-hosted endpoint if instructed by CheckoutPay support.

What data is sent and when

Data is sent only after you save your API URL and API Key in WooCommerce Settings Payments CheckoutPay.

  • When a customer completes checkout — order amount, currency, customer name, WooCommerce order reference, your store website URL, and webhook URL (to create a payment request and receive bank details).
  • When a customer checks payment status on the order thank-you page — order reference and amount (to query payment status).
  • When a customer updates the paid amount on the thank-you page — order reference and corrected amount.
  • When a store admin refreshes charges in plugin settings — your store website URL (to load fee rules configured in CheckoutPay).
  • On each API request — your merchant API key in the X-API-Key header.

CheckoutPay may also send data to your site when a payment is approved: a server-to-server webhook POST to the webhook URL shown in plugin settings (order reference, payment status, and related payment metadata).

Terms of service and privacy policy

CheckoutPay is provided by CheckoutPay. By using this plugin you are also subject to CheckoutPay’s policies:

  • Terms of service: https://check-outpay.com/terms-and-conditions
  • Privacy policy: https://check-outpay.com/privacy-policy
  • Service website: https://check-outpay.com/

Installation

Phase 1 — Install in WordPress

  1. Upload the copn-payment-gateway folder to /wp-content/plugins/, or install the plugin ZIP via Plugins Add New Upload Plugin.
  2. Activate the plugin through the Plugins screen. WooCommerce must be installed and active.
  3. Go to WooCommerce Settings Payments, find CheckoutPay, toggle Enable, then click Manage.

Phase 2 — Configure CheckoutPay

  1. Sign up or log in at CheckoutPay.
  2. In your CheckoutPay dashboard, create or copy your API key.
  3. In WooCommerce CheckoutPay settings, set API URL and API Key.
  4. Register your store Website URL and Webhook URL in CheckoutPay (Dashboard Websites).
  5. Click Refresh charges to confirm the API connection.

Phase 3 — Test and go live

  1. Click Refresh charges in plugin settings — if fees load, your API connection is working.
  2. Place a small test order and select CheckoutPay at checkout.
  3. Confirm bank details on the thank-you page and that the order updates when payment is approved.
  4. Keep Enable CheckoutPay turned on at WooCommerce Payments — you are live.

FAQ

What does COPN mean?

COPN stands for CheckoutPay Nigeria — the official WooCommerce integration brand for CheckoutPay bank transfers.

Does this work with block checkout?

Yes. The plugin registers with WooCommerce Cart/Checkout blocks.

Does the plugin work without WooCommerce?

No. WooCommerce must be installed and active.

How do I know I am ready for production?

Click Refresh charges in WooCommerce Payments CheckoutPay. If your fee preview loads, your API key and website URL are correct. Then place a small test order, confirm bank details appear, and check that the order status updates when CheckoutPay approves the payment. Keep Enable CheckoutPay on — there is no separate sandbox mode.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“COPN Payment Gateway for Nigerian Businesses” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.4.6

  • Update CheckoutPay logo to the current brand mark (blue COPN icon).

1.4.5

  • Replace unused Test mode checkbox with a clear test-and-go-live checklist (Refresh charges test order enable gateway).

1.4.4

  • WordPress.org review: expand External services section with CheckoutPay terms of service and privacy policy links.

1.4.3

  • WordPress.org slug copn-payment-gateway: blocks script renamed to copn-blocks.js / handle copn-blocks; translation template metadata updated.

1.4.2

  • WordPress.org slug alignment: folder copn-payment-gateway, main file copn-payment-gateway.php, text domain copn-payment-gateway, admin script handles prefixed with copn-.

1.4.1

  • Plugin Check: literal text domain strings; COPN rebrand polish.

1.4.0

  • Rebrand to COPN (CheckoutPay Nigeria): display name COPN Payment Gateway for Nigerian Businesses.

1.3.4

  • WordPress.org: remove “WooCommerce” from plugin display name.

1.3.3

  • WordPress.org review: ownership, webhook sanitization, enqueued scripts.

1.3.0

  • WordPress.org review: enqueue scripts, sanitization, Checkoutpay_* class prefix.