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
- Your customer selects CheckoutPay at checkout and places the order.
- 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).
- 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-Keyheader.
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
- Upload the
copn-payment-gatewayfolder to/wp-content/plugins/, or install the plugin ZIP via Plugins Add New Upload Plugin. - Activate the plugin through the Plugins screen. WooCommerce must be installed and active.
- Go to WooCommerce Settings Payments, find CheckoutPay, toggle Enable, then click Manage.
Phase 2 — Configure CheckoutPay
- Sign up or log in at CheckoutPay.
- In your CheckoutPay dashboard, create or copy your API key.
- In WooCommerce CheckoutPay settings, set API URL and API Key.
- Register your store Website URL and Webhook URL in CheckoutPay (Dashboard Websites).
- Click Refresh charges to confirm the API connection.
Phase 3 — Test and go live
- Click Refresh charges in plugin settings — if fees load, your API connection is working.
- Place a small test order and select CheckoutPay at checkout.
- Confirm bank details on the thank-you page and that the order updates when payment is approved.
- 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.
ContributorsTranslate “COPN Payment Gateway for Nigerian Businesses” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
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 tocopn-blocks.js/ handlecopn-blocks; translation template metadata updated.
1.4.2
- WordPress.org slug alignment: folder
copn-payment-gateway, main filecopn-payment-gateway.php, text domaincopn-payment-gateway, admin script handles prefixed withcopn-.
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.
