WordPress Integration

​

Prerequisites

• WordPress 5.0 or higher
• WooCommerce 4.0 or higher
• PHP 7.4 or higher
• A Yabetoo merchant account with API keys
• SSL certificate installed (HTTPS required)

​

Installation

​

Method 1: WordPress Plugin Directory (Recommended)

1. Go to your WordPress admin dashboard
2. Navigate to Plugins > Add New
3. Search for “Yabetoo Payment Gateway”
4. Click Install Now, then Activate

​

Method 2: Manual Installation

1. Download the plugin
2. Go to Plugins > Add New > Upload Plugin
3. Select the downloaded yabetoopay-woocommerce.zip file
4. Click Install Now, then Activate

​

Configuration

​

Step 1: Access Plugin Settings

1. Go to WooCommerce > Settings
2. Click on the Payments tab
3. Find “Yabetoo” and click Manage

​

Step 2: Configure API Keys

Enable/Disable: ✓ Enable Yabetoo Payment Gateway
Title: Mobile Money Payment
Description: Pay securely with Mobile Money (MTN, Airtel)

API Settings:
- Secret Key: sk_test_XXXXXXXXXXXXXXXXXXXXXXXX
- Public Key: pk_test_XXXXXXXXXXXXXXXXXXXXXXXX
- Environment: Sandbox (for testing) / Production (for live)

​

Step 3: Configure Webhook

1. In your Yabetoo Dashboard, go to Developers > Webhooks
2. Add a new webhook with URL: https://yourstore.com/?wc-api=yabetoo_webhook
3. Select events: intent.completed, disbursement.completed
4. Copy the webhook secret and paste it in the plugin settings

​

Step 4: Test the Integration

1. Keep the environment set to Sandbox
2. Create a test order on your store
3. Complete payment using test phone numbers
4. Verify the order status updates correctly

​

Test Phone Numbers

​

Going Live

1. Log into your Yabetoo Dashboard
2. Complete the account verification process
3. Get your production API keys
4. Update the plugin settings:
   • Replace test keys with production keys
   • Change environment to Production
5. Update webhook URL to use production endpoint

​

Features

​

Supported Payment Methods

• MTN Mobile Money - Congo, Cameroon, Ivory Coast
• Airtel Money - Congo, Gabon
• Orange Money - Cameroon, Ivory Coast

​

Order Management

• Updates order status when payment is confirmed
• Sends order confirmation emails
• Records payment details in order notes
• Handles webhook notifications

​

Customization Options

​

Troubleshooting

​

Payment Not Processing

1. Verify API keys are correct
2. Check SSL certificate is valid
3. Ensure webhook URL is accessible
4. Review WooCommerce logs at WooCommerce > Status > Logs

​

Webhook Not Receiving Events

1. Verify webhook URL is correct in Yabetoo Dashboard
2. Check your server allows POST requests
3. Ensure webhook secret matches in both places
4. Test webhook connectivity from Dashboard

​

Order Status Not Updating

1. Check webhook is configured correctly
2. Verify webhook secret matches
3. Review PHP error logs
4. Ensure WooCommerce is up to date

​

Hooks and Filters

// Modify payment description
add_filter('yabetoo_payment_description', function($description, $order) {
    return 'Pay for Order #' . $order->get_id();
}, 10, 2);

// Custom action after successful payment
add_action('yabetoo_payment_complete', function($order_id, $transaction_id) {
    // Your custom logic here
}, 10, 2);

// Modify supported countries
add_filter('yabetoo_supported_countries', function($countries) {
    return ['CG', 'CM', 'CI', 'GA'];
});

​

Frequently Asked Questions

​

Support

• Email: support@yabetoopay.com
• Plugin documentation: Developer Tools
• API documentation: API Reference