Description
Nephila Payment Gateway for Epoch is an independent WooCommerce integration for merchants who already have an approved Epoch merchant account.
The plugin sends the required transaction information to Epoch’s hosted payment service and redirects the customer to the Epoch hosted checkout page. Payment card details are entered on the hosted Epoch payment page rather than on the merchant’s WordPress site.
After payment, the plugin can receive Epoch PostBack notifications and use the verified payment response to update the related WooCommerce order.
This plugin is independently developed and is not affiliated with, endorsed by, sponsored by, or officially maintained by Epoch. Epoch is the payment service provider. Merchants must establish and maintain their own merchant relationship with Epoch.
Features
- WooCommerce payment method for Epoch hosted checkout.
- One-time WooCommerce payments.
- Epoch staging and production environments.
- JWT-signed Dynamic Pricing invoice requests.
- Hosted payment redirect.
- Success and denial return handling.
- Epoch PostBack handling.
- Optional epoch_digest HMAC verification when provided by Epoch.
- Epoch IP allowlist verification.
- Decline-reason mapping.
- WooCommerce order notes and logging.
- WooCommerce HPOS compatibility.
- Local testing tools for order-status and callback-flow testing.
Requirements
- WordPress 6.5 or newer.
- WooCommerce 8.0 or newer.
- PHP 7.4 or newer.
- An approved Epoch merchant account.
- Epoch merchant-specific Dynamic Pricing Client ID and JWT shared key.
- HTTPS is strongly recommended for production stores and is required by many payment environments.
Payment Confirmation
The plugin treats a verified Epoch PostBack as the authoritative payment confirmation signal.
A customer returning to the store after checkout does not by itself mark the order as paid. This helps prevent an unverified browser return from being treated as a successful payment.
External Services
This plugin connects to Epoch’s external payment service to create hosted payment transactions and receive payment status notifications.
Service provider: Epoch
Website: https://epoch.com/
The plugin may send transaction and customer information required to create a payment, which can include:
- WooCommerce order/invoice reference.
- Payment amount and currency.
- Customer name and email address.
- Billing/postal information when required by the configured payment request.
- Merchant site hostname.
- Success, denial, and PostBack URLs.
Payment card information is entered on Epoch’s hosted payment page and is not collected or stored by this plugin.
The information sent to Epoch is subject to the merchant’s agreement with Epoch and Epoch’s applicable policies. Review the provider’s current privacy information before enabling the integration:
https://epoch.com/legal_docs/privacy_policy.html
For Epoch merchant/account terms and payment-service requirements, merchants should use the current agreements and documentation supplied by Epoch for their account.
This plugin does not send analytics, advertising, telemetry, or unrelated tracking data to its developer.
Data and Privacy
The plugin stores WooCommerce order-related information and payment transaction references in the normal WooCommerce order and logging mechanisms needed to operate the gateway.
It does not intentionally collect or store payment card numbers, CVV/CVC values, or other card-entry data.
When the merchant enables and uses the gateway, required transaction information is transmitted to Epoch as part of the payment service. By configuring the integration, the merchant authorizes those service requests as necessary to process payments.
Security
- Never share the Epoch JWT shared key.
- Use staging before production.
- PostBack verification is required for payment confirmation.
- Prefer epoch_digest verification when Epoch provides the required key for the merchant account.
- Otherwise use the Epoch IP allowlist verification supported by the plugin.
- Keep WordPress, WooCommerce, PHP, and the plugin updated.
Testing
Without live Epoch credentials, administrators can test plugin activation, settings validation, checkout availability, simulated callback/order-status flows, and local behavior.
A real Epoch staging account and merchant-specific credentials are required to test the complete hosted payment flow against Epoch.
The built-in simulation tools are for local/staging testing only. They do not represent real payment processing and must not be used as evidence of a completed payment.
Support
For plugin-specific issues, use the support forum on the plugin’s WordPress.org page.
For merchant-account approval, credentials, transaction disputes, payment processing, or Epoch account configuration, contact Epoch directly.
Installation
- Install and activate the plugin.
- Open WooCommerce > Settings > Payments.
- Enable Nephila Payment Gateway for Epoch.
- Open the gateway settings.
- Select Staging while configuring and testing the integration.
- Enter the Epoch Client ID, JWT shared key, and site hostname supplied/configured by Epoch.
- Save the settings.
- Copy the PostBack/DataPlus callback URL shown by the plugin.
- Contact Epoch merchant support and ask them to configure the applicable callback settings for your merchant account.
- Complete a staging test before switching to production.
FAQ
-
Is this an official Epoch plugin?
-
No. This is an independent integration developed for WooCommerce. It is not affiliated with, endorsed by, sponsored by, or officially maintained by Epoch.
-
Do I need an Epoch account?
-
Yes. You need your own approved Epoch merchant account and the credentials supplied by Epoch.
-
Does the plugin store card details?
-
No. Customers enter payment card information on Epoch’s hosted payment page.
-
Can I use the plugin without an Epoch account?
-
You can install and inspect the plugin and test local behavior, but a valid Epoch merchant account is required for real payment processing and Epoch staging transactions.
-
Does this version support WooCommerce Subscriptions?
-
No. Version 1.0 is focused on one-time WooCommerce payments.
-
What confirms a successful payment?
-
A verified Epoch PostBack confirms the payment. The customer browser return is not treated as sufficient payment confirmation.
-
Where do I configure the Epoch callback URL?
-
The callback URL is displayed in the gateway settings. Configure the applicable PostBack/DataPlus settings with Epoch according to the requirements of your merchant account.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Nephila Payment Gateway for Epoch” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Nephila Payment Gateway for Epoch” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial WordPress.org release.
- Added Epoch hosted checkout integration for WooCommerce.
- Added Epoch PostBack handling and payment confirmation.
- Added staging and production configuration.
- Added payment-status handling and verified PostBack confirmation.
- Added HPOS compatibility and local testing tools.


