WooCommerce Plugin

Accept Vaendora bank transfer payments on your WordPress/WooCommerce store. This guide covers installation, configuration, testing, and going live.

Easy Setup

Install and configure in under 5 minutes

Instant Verification

Payments verified automatically via bank transfer

Test Mode

Test payments without real money

Low Fees

1.5% total fee, capped at ₦2,000

Installation

Download and install the Vaendora WooCommerce plugin on your WordPress site:

Downloading the Plugin

Get the Plugin File

Download the Vaendora WooCommerce plugin from your Vaendora dashboard:

Log in to app.vaendora.com
Go to Settings → API Keys
Click Download WooCommerce Plugin

Upload to WordPress

In your WordPress admin dashboard:

Go to Plugins → Add New
Click Upload Plugin
Choose the downloaded ZIP file
Click Install Now

Activate the Plugin

After installation, click Activate Plugin.

Requirements

The plugin requires WooCommerce 5.0 or higher and WordPress 5.6 or higher. Make sure your site meets these requirements before installing.

Configuration

Configure the plugin to connect with your Vaendora account:

Navigate to Payment Settings

Go to WooCommerce → Settings → Payments in your WordPress admin.

Enable Vaendora

Find Vaendora Bank Transfer in the payment methods list and click Manage or toggle it on.

Enter API Credentials

Get your API keys from your Vaendora dashboard and enter them:

Merchant ID - Your unique merchant identifier
Live API Key - For production payments
Test API Key - For test mode payments

Configure Display Settings

Customize how the payment method appears to customers:

Title - e.g., "Pay with Bank Transfer"
Description - e.g., "Pay instantly using bank transfer"
Order Button Text - e.g., "Pay Now"

Save Settings

Click Save changes to apply your configuration.

Finding Your API Keys

To get your API credentials:

Log in to your Vaendora dashboard at app.vaendora.com
Navigate to Settings → API Keys
Copy your Merchant ID
Copy your Live API Key and Test API Key

Keep Keys Secure

Never share your API keys publicly. They provide access to your Vaendora account and payment processing capabilities.

Test Mode

Before accepting real payments, test your integration using test mode:

Enabling Test Mode

Toggle Test Mode

In the Vaendora payment settings, check the box labeledEnable Test Mode.

Save Settings

Click Save changes.

Making a Test Payment

Add Products to Cart

Visit your store and add items to your cart as a customer would.

Proceed to Checkout

Go to the checkout page and fill in customer details.

Select Vaendora

Choose Pay with Bank Transfer as the payment method.

Place Order

Click Place Order to be redirected to the payment page.

Simulate Payment

On the payment page, you'll see a Simulate Payment button (only visible in test mode). Click it to simulate a successful payment.

Verify Order

Check that the order status updates to Processing orCompleted in WooCommerce.

Test Mode Indicators

In test mode, payment references start with VPY-TEST prefix. The payment page also displays a "TEST MODE" badge.

Going Live

Once you've tested successfully, switch to live mode to accept real payments:

Disable Test Mode

In WooCommerce payment settings, uncheck Enable Test Mode.

Verify Live API Key

Ensure your Live API Key is correctly entered in the settings.

Complete KYC

Make sure your Vaendora account has completed KYC verification. Live payments require verified accounts.

Save and Test

Save your settings and make a small real purchase to confirm everything works.

Ready for Payments

Once live mode is enabled and your account is verified, customers can pay using real bank transfers that are automatically verified and settled to your account.

Payment Flow

Understanding the customer payment journey:

Customer Selects Vaendora

At checkout, the customer chooses "Pay with Bank Transfer" and clicks Place Order.

Redirect to Payment Page

The customer is redirected to the Vaendora payment page showing virtual account details and order information.

Customer Makes Transfer

The customer opens their bank app and transfers the exact amount to the provided virtual account within the time limit (30 minutes).

Automatic Verification

Vaendora automatically detects the payment and verifies the amount. The page updates in real-time to show success.

Order Updated

WooCommerce is notified and the order status is automatically updated to Processing. The customer can return to your store.

Fee Structure

Vaendora charges a simple, transparent fee on each transaction:

Fee Type	Rate	Cap
Banking Partner Fee	1.0%	₦1,500
Vaendora Fee	0.5%	₦500
Total	1.5%	₦2,000

Example: For a ₦50,000 order, the fee would be ₦750 (1.5%), leaving you with ₦49,250. For larger amounts like ₦200,000, the fee is capped at ₦2,000 (not ₦3,000).

Troubleshooting

Common issues and how to resolve them:

Payment Not Appearing

Payment Not Found Error

Cause: The payment page cannot connect to the Vaendora API.

Solution:

Check that your API keys are correctly entered
Ensure your Vaendora account is active
Verify the Merchant ID matches your account

Order Status Not Updating

Order Stuck on Pending

Cause: Webhook notification not received by WooCommerce.

Solution:

Ensure your site is publicly accessible (not localhost)
Check that SSL is properly configured
Verify no security plugins are blocking webhooks
Check server error logs for any issues

Test Mode Not Working

No Simulate Button

Cause: Plugin not in test mode or incorrect configuration.

Solution:

Confirm test mode is enabled in plugin settings
Check that the Test API Key is entered
Clear your browser cache and try again

Need More Help?

If you're still experiencing issues:

Contact support at support@vaendora.com
Include your Merchant ID and order reference in your message
Describe the issue with screenshots if possible