OpenCart

​

Requirements

• OpenCart 3.x or 4.x
• PHP 7.4 or higher
• SSL certificate (HTTPS)

​

Installation

​

Via OpenCart Extension Installer

1. Download the .ocmod.zip file from GitHub
2. Go to Extensions > Installer in your OpenCart admin
3. Click Upload and select the extension file
4. Go to Extensions > Modifications and click Refresh
5. Go to Extensions > Payments and install “Fyatu”

​

Manual Installation

1. Download and extract the extension
2. Upload the contents to your OpenCart root directory:
   • admin/ → /admin/
   • catalog/ → /catalog/
3. Go to Extensions > Payments
4. Find “Fyatu” and click Install

​

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 Extension

1. Go to Extensions > Payments
2. Find “Fyatu” and click Edit
3. Configure the settings:

​

Step 3: Configure Webhooks

1. In your FYATU Dashboard, go to App Settings > Webhooks
2. Add webhook URL: https://yourstore.com/index.php?route=extension/payment/fyatu/webhook
3. Copy the webhook secret to your extension configuration

​

Features

• OpenCart 4.x Support - Compatible with latest OpenCart
• Multi-Store - Different settings per store
• Order Tracking - Automatic order status updates
• Refund Support - Process refunds from admin
• Multi-Language - English and French translations included
• Journal Theme - Compatible with Journal 3 theme

​

Checkout Flow

Customer adds items to cart
           ↓
Customer proceeds to checkout
           ↓
Customer selects "Fyatu" payment
           ↓
Customer confirms order
           ↓
Customer redirected to Fyatu checkout
           ↓
Customer completes payment
           ↓
Customer redirected to success page
           ↓
Order status updated automatically

​

Order Statuses

​

Multi-Store Setup

1. Go to System > Settings
2. Edit each store
3. Configure Fyatu credentials per store
4. Save changes

​

Refunds

1. Go to Sales > Orders
2. Open the order to refund
3. Click Fyatu Refund button
4. Enter refund amount and reason
5. Click Process Refund

​

Template Customization

/catalog/view/theme/YOUR_THEME/template/extension/payment/fyatu.twig

/catalog/view/theme/YOUR_THEME/template/extension/fyatu/payment/fyatu.twig

​

Events

​

Listen to Events

// In your extension's admin/controller
$this->load->model('setting/event');

$this->model_setting_event->addEvent(
    'my_module',
    'catalog/model/extension/payment/fyatu/success/after',
    'extension/module/my_module/onFyatuSuccess'
);

​

OCMOD Modifications

1. Go to Extensions > Modifications
2. Find “Fyatu Payment” entries
3. Click Refresh after any changes

​

Troubleshooting

​

Extension not appearing at checkout

1. Verify extension status is “Enabled”
2. Check Geo Zone restrictions
3. Clear OpenCart cache: Dashboard > Blue gear icon

​

Webhook not working

1. Verify webhook URL is correct
2. Check that .htaccess allows the webhook route
3. Test webhook URL directly in browser (should show error for GET)

​

Payment stuck on pending

1. Check webhook delivery in Fyatu Dashboard
2. Verify order status mappings are correct
3. Check extension logs if debug enabled

​

Debug Mode

1. Edit extension settings
2. Enable Debug Mode
3. Logs written to /system/storage/logs/fyatu.log

# View logs
tail -f /system/storage/logs/fyatu.log

​

vQmod Support

1. Download the vQmod version from GitHub
2. Upload fyatu.xml to /vqmod/xml/
3. Clear vQmod cache

​

Resources

• OpenCart Documentation
• Fyatu API Reference
• GitHub Repository (Coming soon)