Skip to content

🤖 Explain with AI

Setting Up the WooCommerce Plugin for 4Geeks Payments

Overview

The 4Geeks Payments WooCommerce Plugin allows you to accept online payments on your WordPress/WooCommerce store in 5 minutes or less — no coding required. As a Merchant of Record, 4Geeks handles tax compliance, fraud prevention, and chargebacks so you can focus on selling.

In this tutorial, you will:

  • Install the 4Geeks Payments plugin
  • Configure payment methods
  • Test transactions in sandbox mode
  • Go live and start accepting payments

Prerequisites

  • An activated 4Geeks Payments account (activate service)
  • WordPress 5.0+ with WooCommerce installed
  • Admin access to your WordPress dashboard

Step 1: Install the Plugin

Option A: From WordPress Plugin Directory

  1. Go to your WordPress admin dashboard
  2. Navigate to Plugins → Add New
  3. Search for “4Geeks Payments”
  4. Click “Install Now” then “Activate”

Option B: Manual Upload

  1. Download the plugin from docs.4geeks.io/en/payments/plugins/woocommerce
  2. Go to Plugins → Add New → Upload Plugin
  3. Upload the ZIP file
  4. Click “Activate”

Step 2: Configure API Keys

  1. Go to WooCommerce → Settings → Payments
  2. Find 4Geeks Payments and click “Manage”
  3. Enter your API credentials:
  4. Public Key: From your 4Geeks console
  5. Secret Key: From your 4Geeks console
  6. Toggle “Enable/Disable” to Enable

Tip: Start with sandbox keys to test before going live.

Step 3: Configure Payment Settings

General Settings

Setting Description Recommended
Title Payment method name shown at checkout “Credit/Debit Card”
Description Description shown to customers “Pay securely with your card”
Test Mode Enable sandbox testing Yes (initially)
3D Secure Enable 3DS authentication Yes

Transaction Settings

Setting Description Recommended
Capture Auto-capture or authorize only Auto-capture
Statement Descriptor Text on customer’s bank statement Your business name
Accepted Cards Which card brands to accept All enabled

Step 4: Test in Sandbox Mode

  1. Ensure Test Mode is enabled
  2. Add a product to your cart and proceed to checkout
  3. Use a test card number:
Card Number Result
Visa (Success) 4242 4242 4242 4242 Payment approved
Visa (Declined) 4000 0000 0000 9995 Payment declined
Requires 3DS 4000 0000 0000 0002 3D Secure challenge
  1. Use any future expiry date and any 3-digit CVC
  2. Complete the checkout and verify the order status

Step 5: Verify Webhook Configuration

Webhooks ensure your store receives real-time payment updates:

  1. In your 4Geeks console, go to Payments → Settings → Webhooks
  2. Add your webhook URL: https://yourstore.com/wc-api/4geeks_payments
  3. Select events to receive:
  4. charge.succeeded
  5. charge.failed
  6. refund.completed
  7. subscription.created
  8. Save and test the webhook

Step 6: Go Live

Once testing is complete:

  1. Switch from Test Mode to Live Mode in plugin settings
  2. Replace sandbox API keys with production keys
  3. Place a real test order with an actual card (small amount)
  4. Verify the payment appears in your 4Geeks console
  5. Confirm the payout is scheduled to your bank account

Supported Features

Feature Supported
One-time payments Yes
Recurring subscriptions (WooCommerce Subscriptions) Yes
Refunds from WooCommerce admin Yes
Partial refunds Yes
Multi-currency Yes
3D Secure (3DS) Yes
Saved cards Yes
Payment links Yes

Troubleshooting

Common Issues

Issue Solution
“Invalid API key” error Verify keys are correct and from the right environment (sandbox vs. production)
Payment fails silently Check webhook configuration and server logs
3D Secure not triggering Ensure 3DS is enabled in plugin settings
Refund not processing Verify the original charge is captured and refundable

Getting Help

  • Check the plugin logs: WooCommerce → Status → Logs
  • Review the Payments documentation
  • Contact support through the console dashboard

What’s Next?

Need Help?

Still questions? Ask the community.