After you’ve installed and activated the plugin, iwocaPay becomes available as an additional payment option in your WooCommerce checkout.
Payments made through iwocaPay automatically reconcile with your store data.
With iwocaPay, your customers can pay in instalments (through the Pay Later option).
They can also pay in full (with the Pay Now option), which uses instant bank-to-bank transfers at no extra cost.
Before You Begin
Linking iwocaPay with WooCommerce takes a few minutes and needs no technical expertise.
Your WordPress account has access to your WooCommerce settings
Get your API key and Seller ID by clicking Install Plugin on the WooCommerce tab of the Integrations page in your iwocaPay dashboard. This sends a request to your Account Manager. You can also contact your Account Manager directly.
Choose your pricing structure
With iwocaPay, you decide who covers the cost of Pay Later transactions.
Log in to your WordPress account and go to Plugins in the left panel.
Click Add New, then search for iwocaPay in the search bar.
Click Install Now, and after installation, click Activate to enable the plugin.
iwocaPay now appears under Settings in your WooCommerce store, on the Payments tab.
Click Finish Set Up and select the Enable box.
Choose the payment options you’d like to show (either Pay Later, or both Pay Later and Pay Now).
Enter the API key and Seller ID provided, then click Save Changes.
Here’s a video that shows the setup process:
Your checkout page now shows iwocaPay as a payment option.
In WooCommerce, you can also choose whether to show only Pay Later at checkout, or both Pay Later and Pay Now.
Pay Now is always free for both you and your customers.
To choose which payment options appear:
Go to your WordPress dashboard, then navigate to WooCommerce > Settings.
Click the Payments tab, then choose iwocaPay from the list.
In the Payment modes pull-down menu, choose which options to display (either Pay Later, or both Pay Later and Pay Now).
We offer a number of optional features in the WooCommerce plugin that you can configure in WooCommerce > Settings > Payments > iwocaPay.
Display iwocaPay in a pop-up window: By default, iwocaPay opens in the same window. Select Display iwocaPay in a Pop-Up Window to open it in a pop-up instead.
Hold stock and auto-cancel failed orders: By default, a declined or failed order is marked Failed and stock isn’t released automatically. Enable this to have the plugin mark it Cancelled, release stock, and report the cancellation back to iwocaPay.
Auto-cancel abandoned checkout orders: Requires Hold stock and auto-cancel failed orders to also be enabled. Cancels an order if the buyer returns to checkout before iwocaPay has approved them (order still CREATED or PENDING). Approved orders are never cancelled this way.
When a buyer selects iwocaPay at checkout, the WooCommerce plugin creates an order via the iwocaPay ecommerce API. The order progresses through these statuses:
iwocaPay status
WooCommerce status
What happened
CREATED
On-hold
Order placed, buyer redirected to iwocaPay checkout
PENDING
On-hold
Buyer has started their application or login
APPROVED
On-hold
Buyer approved for credit (Pay Later only)
SUCCESSFUL
Processing
Payment confirmed — buyer completed checkout
UNSUCCESSFUL
Failed
Buyer declined, abandoned, or payment failed
The plugin receives status updates via signed webhook, not polling.
When the order moves to SUCCESSFUL, WooCommerce moves it to Processing, at which point you can take the actions needed to deliver the goods or services.
By default, an UNSUCCESSFUL order stays Failed and stock isn’t released.
Enable Hold stock and auto-cancel failed orders (see Optional features) to move it to Cancelled, release stock, and report the cancellation back to iwocaPay.
New buyers without an existing Spending Limit go through the iwocaPay credit assessment and security checks before they can check out with Pay Later.
For some new customers, we run additional manual checks that can take around an hour.
For returning buyers with an active Spending Limit, checkout takes a few minutes.
During this time, the WooCommerce order sits in On-hold with stock reserved.
If you have short stock-hold windows or limited stock, account for this when setting them.
The plugin receives an UNSUCCESSFUL webhook. By default, the order is marked Failed only. With Hold stock and auto-cancel failed orders enabled, it’s moved to Cancelled and stock is released.
Buyer abandons mid-checkout
No webhook is sent for silent abandonment. The order stays On-hold with stock reserved until you clean it up.
Buyer clicks back to store
The buyer is returned via the redirect URL. By default, nothing changes — the order stays On-hold. With Hold stock and auto-cancel failed orders and Auto-cancel abandoned checkout orders both enabled, an order still CREATED or PENDING (not yet approved) is cancelled; approved orders are never cancelled this way.
Seller cancels the order
The seller (or plugin) calls DELETE /ecommerce/order/{orderId}/. This sets the iwocaPay status to UNSUCCESSFUL and triggers a webhook back.
The WooCommerce order reference is passed to iwocaPay at order creation, so it’s available if you need to match orders against your own payment records.
Webhook notifications on each status change keep WooCommerce order statuses in sync in real time.
Stock-hold duration: Because we run manual checks on some new customers, the iwocaPay checkout can occasionally take around an hour. If you have tight inventory, set WooCommerce’s stock-hold timeout with this in mind, so orders aren’t cancelled before the buyer completes.
Abandoned order cleanup: Silent abandonment (no decline, no completion) doesn’t trigger a cancellation webhook. Have a cleanup strategy.
No partial fulfilment support: iwocaPay orders are for the full order amount. Manage split-shipment or partial-fulfilment workflows outside the iwocaPay order lifecycle.
Duplicate orders: If a buyer abandons and restarts, a new iwocaPay order is created. The original stays On-hold unless it’s cleaned up.
