WooCommerce
Install and configure the Cardencer Checkout plugin for WordPress and WooCommerce: cards, Apple Pay, Google Pay, refunds and order sync.
Cardencer Checkout is one plugin for WordPress and WooCommerce. It adds an embedded payment form to your checkout (including checkout blocks), accepts cards, Apple Pay and Google Pay, and keeps WooCommerce orders in sync through signed webhooks. Refunds and manual captures happen from the WordPress admin.
Requirements#
- WordPress 4.0 or later (tested up to 6.5)
- WooCommerce 4.0 or later (tested up to 8.6)
- PHP 8.0 or later
- HTTPS on your store
1. Install the plugin#
- Get the latest Cardencer Checkout package (
.zip) from Cardencer support. - In WordPress, go to Plugins → Add New → Upload Plugin, choose the file and click Install Now.
- Click Activate.
2. Collect your keys#
In the dashboard, open API keys and copy:
- your secret API key (
snd_…to test,prd_…live), - your publishable key (
pk_snd_…orpk_prd_…), - your profile ID,
- your webhook signing key.
3. Configure the gateway#
Go to WooCommerce → Settings → Payments → Cardencer and fill in:
| Setting | Value |
|---|---|
| Enable/Disable | Ticked. |
| API key | Your full secret key. Masked values containing ******** do not work. The key stays on your server and is never sent to the browser. |
| Publishable key | Your publishable key. Use a test publishable key with a test secret key. |
| Business Profile ID | Your profile ID. |
| Webhook HMAC key | Your webhook signing key. |
| Enable Webhook | Ticked. |
| Capture Method | Automatic to charge at checkout, or Manual to authorize and capture later from the order screen. |
| Enable Saved Payment Methods | Lets logged-in customers pay with a saved card. |
| Show Card Form Always | Opens the card form by default. |
| Hold Order on Processing Payments | Keeps stock reserved while a payment is processing. |
Leave API base URL and SDK loader URL under Advanced service endpoints empty for production. For sandbox testing, set API base URL to https://sandbox.cardencer.com.
Click Save changes.
4. Register the webhook URL#
The settings page shows the plugin's webhook URL under Enable Webhook. Send it to Cardencer support, specifying sandbox or live, so it is registered on your business profile. Without it, orders update only when the customer returns to your store.
The plugin verifies X-Webhook-Signature-512 on every delivery and rejects unsigned or invalid requests. Duplicate events are ignored per order.
5. Test a payment#
- With sandbox keys, place an order on your store.
- Pay with
4242 4242 4242 4242, any future date and any CVC. - The order moves to Processing and the payment appears in the Cardencer dashboard.
Try 4000 0038 0000 0446 to see 3D Secure, and 4000 0000 0000 0002 for a decline. See Sandbox & test cards.
Daily operations#
- Refunds: open the order, click Refund, enter the amount and confirm. The refund is sent to Cardencer and the order is updated.
- Manual capture: with Capture Method set to Manual, capture authorized orders from the order screen once you ship.
- Sync: you can re-sync an order's payment status manually from the order screen.
- Appearance: adjust the payment form's appearance object and choose a tabs or accordion layout in the plugin settings. See Customization for the available variables.
Go live#
Replace the keys with your prd_ secret key, pk_prd_ publishable key and live webhook signing key, clear the API base URL override, and register your webhook URL for live. See Going live.