How to Integrate 4Geeks Payments with WooCommerce for WordPress
4Geeks Payments is a robust, AI-powered platform designed to streamline revenue growth for businesses of all sizes. By integrating 4Geeks Payments with your WooCommerce store, you can accept online payments securely, manage subscriptions effortlessly, and automate billing processes without needing extensive technical knowledge. This guide will walk you through the steps to connect 4Geeks Payments to your WordPress site using the dedicated WooCommerce plugin.
Prerequisites
Before you begin, ensure you have the following:
- A 4Geeks Account: You must have an active account. If you haven't, you can create one at the 4Geeks Console.
- Verified Legal Entity: To process live payments, your business details must be verified. Log in to the Console and navigate to Settings > Production to complete this verification.
- WordPress & WooCommerce: A functioning WordPress website with the WooCommerce plugin installed and activated.
- Administrator Access: You need admin-level access to your WordPress dashboard to install plugins and modify settings.
- SSL Certificate: Your website must use HTTPS to ensure secure transaction processing.
Start Accepting Online Payments in 5 Minutes
Get paid faster on your website, your platform or social media via our payment link. Multiple currencies. 100% secure. 5-min activation process.
How to Integrate 4Geeks Payments
Follow these steps to seamlessly connect your payment gateway.
Step 1: Obtain Your API Keys
To connect your store, you need unique credentials that identify your business.
- Log in to the 4Geeks Console.
- Navigate to Settings > API Keys.
- You will see two types of keys:
- Test Key (starts with
sk_test_): Use this for initial setup and testing. - Live Key (starts with
sk_live_): Use this when you are ready to accept real money.
- Test Key (starts with
- Keep this tab open or copy these keys; you will need to paste them into your WordPress settings shortly.
Step 2: Install the 4Geeks Payments Plugin
- Log in to your WordPress Admin Dashboard.
- Go to Plugins > Add New.
- In the search bar, type "4Geeks Payments".
- Locate the official plugin (typically titled "4Geeks Payments for WooCommerce") and click Install Now.
- Once installation is complete, click Activate.
Step 3: Configure the Payment Gateway
- Navigate to WooCommerce > Settings in your WordPress dashboard.
- Click on the Payments tab.
- Find 4Geeks Payments in the list of available gateways and toggle the switch to Enable it.
- Click the Manage (or "Set up") button next to 4Geeks Payments.
- Fill in the configuration fields:
- Enable/Disable: Ensure this box is checked.
- Title: Enter the text customers will see at checkout (e.g., "Pay with Credit Card").
- Description: Add a short description (e.g., "Secure payment processing via 4Geeks").
- API Keys: Paste the Test Key and Live Key you retrieved in Step 1 into their respective fields.
- Environment/Mode: Select Test (or Sandbox) to verify functionality first. Switch to Live (or Production) only when you are ready to go public.
- Click Save Changes.
Step 4: Test the Integration
- Ensure your plugin environment is set to Test.
- Open your WooCommerce store in a new browser window (or Incognito mode).
- Add a product to your cart and proceed to the checkout page.
- Select the 4Geeks Payments option.
- Complete the purchase using dummy card data (refer to the 4Geeks Console or documentation for valid test card numbers).
- If the order is successful, you will see a confirmation page, and the order status in WooCommerce will update to "Processing" or "Completed".
Common Use Cases
- Scenario 1: Launching a Subscription Box ServiceYou can use 4Geeks Payments to handle recurring billing for a monthly subscription box. The integration automates the monthly charge, ensuring you receive revenue on time while customers enjoy a seamless renewal experience without manual invoicing.
- Scenario 2: Selling Digital Products GloballyIf you sell e-books or software, this integration allows you to accept payments from customers worldwide. The system handles currency processing securely, allowing you to focus on product creation rather than financial logistics.
Troubleshooting
- Issue 1: Payment option not showing at checkout
- Solution: Go to WooCommerce > Settings > Payments and ensure the "Enabled" toggle is switched on for 4Geeks Payments. Additionally, verify that your store's currency settings match a currency supported by your 4Geeks account.
- Issue 2: "Unauthorized" or "Invalid API Key" error
- Solution: Double-check that you copied the API keys exactly as they appear in the 4Geeks Console, without any extra spaces. Ensure you are using the
sk_test_key when the plugin is in Test Mode and thesk_live_key for Live Mode.
- Solution: Double-check that you copied the API keys exactly as they appear in the 4Geeks Console, without any extra spaces. Ensure you are using the
- Issue 3: Orders remain "Pending Payment"
- Solution: This typically indicates a communication issue between the server and the payment gateway. Check your plugin settings to ensure any required Webhooks are configured, or review your 4Geeks Console logs for specific transaction decline reasons.
FAQs
Do I need an SSL certificate?
Yes. To ensure the security of your customers' data and to comply with PCI standards, your website must use HTTPS (SSL) to process payments.
Can I customize the payment form?
Yes, the plugin typically allows basic customization of the title and description shown at checkout. For more advanced branding needs, checking out 4Geeks Perks may offer additional white-labeling options for self-serve portals.
Start Accepting Online Payments in 5 Minutes
Get paid faster on your website, your platform or social media via our payment link. Multiple currencies. 100% secure. 5-min activation process.