Plugins - Install and Manage Platform Extensions

The Plugins manager allows administrators to extend OwnPay’s core capabilities. Extensions are packaged as plugins and are grouped into three categories: Gateways (API connectors), Addons (additional platform features), and Themes (layout designs).

Getting here

Log in to the OwnPay admin dashboard as the super-administrator
Under the SYSTEM section in the left sidebar, click Plugins

Page sections

1. Plugin category tabs

All: Shows all plugins on the server
Gateways: Lists only payment processor connectors
Addons: Displays helper integrations (mail-gateway, sms-gateway, telegram-bot)
Themes: Shows visual templates
Trash: Displays uninstalled plugins queued for deletion

2. Search and filter bar

Search Textbox: Locate plugins by name or slug
Status Dropdown: Filter by Active, Inactive, or Not Installed status states

3. Plugin profile cards

Each card displays:

Branding Icon: Visual logo of the extension
Details: Extension name, type tag, version, and description
Controls: Click Install & Activate (or Deactivate if active) to modify execution states

4. Upload plugin wizard

Located by clicking the Upload Plugin link in the header. Allows developers to upload a custom packaged .zip plugin file directly to the server.

Step-by-step: installing and activating a plugin

Navigate to the Plugins manager
Search or browse to locate the extension (e.g., Telegram Bot)
Click the Install & Activate button
The system will extract the package, run configuration migrations, and change the status

Best practices

Deactivate plugins you are not using to improve system performance
Check for version compatibility in the manifest description before uploading manual updates
Do not upload zip archives from untrusted sources, as plugins run with administrative permissions
Do not rename plugin folder directories directly via FTP/file manager

Common mistakes and troubleshooting

Symptom	Cause	Fix
Plugin fails to activate	Manifest validation or footgun scan failed	Check the plugin’s `manifest.json` for syntax errors and remove blocked PHP functions
Plugin not appearing in admin	Plugin folder not in `modules/` directory	Ensure the plugin is placed in `modules/gateways/`, `modules/addons/`, or `modules/themes/`
Checkout page broken after plugin install	Plugin conflicts with theme or another plugin	Deactivate the last installed plugin and report the issue

Payment Gateways - Configure credentials for activated gateways
Themes - Manage active visual styles
System Update - Upload master platform core updates

​Getting here

​Page sections

​1. Plugin category tabs

​2. Search and filter bar

​3. Plugin profile cards

​4. Upload plugin wizard

​Step-by-step: installing and activating a plugin

​Best practices

​Common mistakes and troubleshooting

​Related pages