Founder online now · WhatsApp reply < 30 min
From $199/mo
WooCommerce custom gateway

WooCommerce custom payment gateway: build a plugin, use a generic one, or host the checkout.

WooCommerce lets you add any gateway, in theory. In practice the acquirer that approved you may have no plugin, the generic "custom payment gateway" plugins only create pending orders, and a bespoke plugin is a few weeks of PHP plus permanent maintenance. Here are the three real options and what each one costs you in time, PCI scope and resilience.

See pricing →   How it works →

Option 1: the generic custom payment gateway plugins

Plugins named "custom payment gateway" for WooCommerce add a payment method with a title, description and instructions. They record the order as pending or on-hold and capture nothing. They are for bank transfer, invoice and cash-on-delivery style flows. If your goal is to charge a card through a specific processor, they do not do it.

Option 2: write a gateway plugin

WooCommerce's payment gateway API lets a developer implement a class that renders a payment form, calls the processor, and updates the order. Done properly it also handles hosted card fields for PCI scope, 3-D Secure redirects, webhooks for asynchronous results, refunds from the order screen, subscriptions, and the blocks checkout. Budget several weeks for a first version and ongoing work as WooCommerce, PHP and the processor's API change. It is the right call when the processor is unusual and you have a developer who will own it for years.

Option 3: a hosted checkout that connects any API

1

Keep WooCommerce

Products, cart, coupons, shipping and accounts stay where they are. A small plugin hands the cart to the hosted checkout.

2

Any gateway behind it

We integrate the processor's API once, on our side: tokenised fields, 3DS, webhooks, refunds. Custom HTTP endpoints included.

3

Orders back in WooCommerce

Paid orders created through the REST API with full detail, so nothing downstream changes.

The difference from a plugin is what comes with it: more than one gateway with automatic retry on soft declines, currency per buyer, one ledger across processors, and no card data on your server. Adding a processor later is configuration, not a plugin project. High-risk gateways for WooCommerce.

Comparing the three

Generic pluginBespoke pluginHosted checkout
Captures cardsNoYesYes
TimeMinutesWeeks24-48 hours after keys
PCI scopeNoneDepends on buildSAQ A, card never on your server
Failover to a second processorNoNoYes
MaintenanceNoneYours, ongoingOurs
Currency per buyerNoIf builtYes, where the gateway allows

What we need from you

  1. API documentation or sandbox access for the processor, if it is one we have not connected before.
  2. Sandbox and live credentials.
  3. WooCommerce REST API keys with write access to orders, created in WooCommerce settings.
  4. A subdomain you control for the checkout, pointed at us.

Most connections to processors with a documented REST API are live within two working days; unusual ones are scoped first.

Frequent questions

Can I add a custom payment gateway to WooCommerce?

Yes, by writing a gateway plugin, or by connecting the processor's API through a hosted checkout that writes paid orders back into WooCommerce.

Do the 'custom payment gateway' plugins charge cards?

No. They create pending or on-hold orders for manual payment methods like bank transfer.

How long does a bespoke WooCommerce gateway plugin take?

Several weeks for a first version with hosted fields, 3DS, webhooks and refunds, plus ongoing maintenance.

Can a hosted checkout connect a processor with no public plugin?

Yes. Any processor with an API, including custom HTTP endpoints, can be integrated on our side and used as a route.

Bring your store URL and the gateway that already said yes.

Live in 24-48 hours. Founder-answered support on WhatsApp.

See pricing →

High-risk gateways for WooCommerce → · WooCommerce own-domain checkout → · Hosted checkout page → · Integrations →

CascadeCheckout is checkout software, not a payment service provider, bank or merchant-account seller. You contract with your own gateway or acquirer, disclose your real business category to them, and receive payouts from them. We never hold funds and we do not promise that any processor will approve you.