How it works
- The shopper places an order and chooses the Kelviq payment method.
- They’re taken to Kelviq checkout to pay the order total, with cards, Apple Pay, Google Pay, PayPal and the other payment methods you’ve turned on.
- Kelviq tells your store the payment succeeded, and the shopper returns to the order confirmation page. Before marking the order paid, the plugin checks the payment with the Kelviq API.
Before you start
You need:- A WordPress site with WooCommerce 8.0 or later, reachable from the internet over HTTPS. Kelviq sends payment confirmations to your site, so it can’t be a local or password-protected site.
- A Kelviq Server API key, from Settings → API keys.
- A one-time plan that WooCommerce orders are sold under:
- Open Products and add a product, for example
WooCommerce store. - Add a plan with a one-time price, for example
WooCommerce order, and publish it. The price doesn’t matter: the shopper always pays the order total. - Copy the plan’s identifier, for example
woocommerce-order.
- Open Products and add a product, for example
Install the plugin
- In Kelviq, open Settings → Integrations, click Configure WooCommerce, then Download plugin.
- In WordPress, open Plugins → Add New Plugin → Upload Plugin.
- Choose
kelviq-for-woocommerce.zip, click Install Now, then Activate.
Connect it to Kelviq
- In WordPress, open WooCommerce → Settings → Payments, and click Kelviq.
- Tick Enable Kelviq.
- Choose the Environment: Sandbox for test payments or Live for real ones.
- Paste your Server API key for that environment.
- Enter the Kelviq plan identifier.
- Choose how Tax works:
- My prices include tax (default): the shopper pays exactly your price, and Kelviq takes the tax out of it.
- Add tax on top of my prices: Kelviq adds tax for the shopper’s country at checkout.
- Optionally, change the Title and Description shoppers see at checkout.
- Click Save changes.
WooCommerce: <your site>. You’ll see Kelviq is connected at the top of the page.
Kelviq calculates tax, so turn off WooCommerce taxes in WooCommerce → Settings → General (untick Enable tax rates and calculations). Otherwise shoppers are charged tax twice.
Refunds
- From WooCommerce: open the order, click Refund, enter the amount, and click the Refund … via button with your Kelviq title. The refund is made in Kelviq.
- From Kelviq: refund the order in Sales → Orders. The refund also appears on the WooCommerce order. A full refund sets the order to Refunded.
Order details
Each paid order shows:- The Kelviq order ID as the Transaction ID.
- Order notes for each step, for example Shopper sent to Kelviq checkout and Paid with Kelviq.
wc_order_id, wc_order_number), so you can match orders in both places.
Troubleshooting
Errors are shown at the top of the Kelviq settings page, and on the order as order notes. For more detail, tick Debug log and open WooCommerce → Status → Logs (sourcekelviq).