Skip to main content
This plugin is coming soon. Join our waitlist to be notified when it’s released.
Accept payments from customers across Africa on your WooCommerce store with the official Fyatu payment gateway.

​
Requirements

  • WordPress 6.0 or higher
  • WooCommerce 8.0 or higher
  • PHP 7.4 or higher
  • SSL certificate (HTTPS)

​
Installation

​
From WordPress Plugin Directory

  1. Go to Plugins > Add New in your WordPress admin
  2. Search for “Fyatu Payment Gateway”
  3. Click Install Now and then Activate

​
Manual Installation

  1. Download the plugin ZIP file from GitHub
  2. Go to Plugins > Add New > Upload Plugin
  3. Upload the ZIP file and click Install Now
  4. Activate the plugin

​
Configuration

​
Step 1: Get API Credentials

  1. Login to FYATU Dashboard
  2. Go to Business Console > Select Your App > Settings
  3. Copy your App ID and Secret Key

​
Step 2: Configure the Plugin

  1. Go to WooCommerce > Settings > Payments
  2. Click on Fyatu to configure
  3. Enable the payment method
  4. Enter your credentials:
FieldDescription
Enable/DisableToggle Fyatu payments on/off
TitlePayment method name shown at checkout
DescriptionDescription shown to customers
App IDYour Fyatu App ID
Secret KeyYour Fyatu Secret Key
Webhook SecretSecret for verifying webhooks
Test ModeEnable for testing without real payments

​
Step 3: Configure Webhooks

  1. In your FYATU Dashboard, go to App Settings > Webhooks
  2. Add your webhook URL: https://yourstore.com/wc-api/fyatu-webhook
  3. Copy the webhook secret and paste it in the plugin settings

​
Features

  • Seamless Checkout - Customers redirected to secure Fyatu checkout
  • Order Status Updates - Automatic order completion on payment
  • Refund Support - Process refunds from WooCommerce order page
  • Test Mode - Test integration without real transactions
  • Multi-Currency - Accept USD, EUR, and local currencies
  • Detailed Logs - Debug logs for troubleshooting

​
Checkout Flow

Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer selects "Pay with Fyatu"
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected back to order confirmation
           ↓
Order marked as "Processing" or "Completed"

​
Shortcodes

Display payment methods or buttons anywhere on your site: 
// Display Fyatu payment button
[fyatu_pay_button amount="50" currency="USD" description="Donation"]

// Display accepted payment methods
[fyatu_payment_methods]

​
Hooks & Filters

Customize the plugin behavior with WordPress hooks: 
// Modify payment description
add_filter('fyatu_payment_description', function($description, $order) {
    return "Order #{$order->get_order_number()} from My Store";
}, 10, 2);

// Custom action after successful payment
add_action('fyatu_payment_complete', function($order_id, $transaction) {
    // Send custom notification, update inventory, etc.
}, 10, 2);

// Modify checkout redirect URL
add_filter('fyatu_checkout_redirect_url', function($url, $order) {
    return add_query_arg('custom_param', 'value', $url);
}, 10, 2);

​
Refunds

To process a refund:
  1. Go to WooCommerce > Orders
  2. Open the order you want to refund
  3. Click Refund
  4. Enter the refund amount and reason
  5. Click Refund via Fyatu
Refunds are processed back to the original payment method and may take 1-5 business days depending on the payment type.

​
Troubleshooting

​
Payment not completing

  1. Check that webhooks are configured correctly
  2. Verify your webhook URL is accessible (not blocked by firewall)
  3. Enable WooCommerce logging and check for errors

​
Test mode not working

  1. Ensure “Test Mode” is enabled in plugin settings
  2. Use test credentials from your FYATU sandbox app

​
Order stuck on “Pending”

  1. Webhooks may not be reaching your server
  2. Check your server error logs
  3. Verify SSL certificate is valid

​
Debug Mode

Enable debug logging to troubleshoot issues:
  1. Go to WooCommerce > Settings > Payments > Fyatu
  2. Enable Debug Log
  3. View logs at WooCommerce > Status > Logs

​
Resources