Gomeisa Payments self-updates

Custom WordPress plugin containing payment-specific logic for Gomeisa: payment cancellation pages, manual payment instructions (Zelle/Cash App), shortcodes, and endpoints related to PayRam and WooCommerce.

Why this plugin exists

Instead of adding code to the theme's functions.php (lost on updates) or a child theme (mixes logic with presentation), all custom payment code lives here in its own plugin. This ensures:

• Survives Flatsome and WordPress updates.
• Survives future theme changes.
• Can be activated/deactivated from the admin without touching files.
• Single location for all custom payment logic.

Structure

gomeisa-payments/
├── gomeisa-payments.php    Main file. Loads all modules.
├── README.md               This file.
└── includes/
    └── shortcodes.php      Shortcodes for payment pages.

Requirements

• WordPress 6.0 or higher
• PHP 7.4 or higher
• WooCommerce active

If WooCommerce is not active, the plugin loads nothing and shows an admin notice. It does not cause fatal errors.

Available shortcodes

[gomeisa_cancelled_order]

Injects cancelled order data into an Elementor page. Expects ?order_id=XXXX (and optionally &key=wc_order_XXXXX for guest users) in the URL — sent by PayRam on payment cancellation.

How to use in Elementor:

1. Create a page with slug payment-cancelled.
2. Edit with Elementor.
3. Add a Shortcode widget anywhere on the page with: [gomeisa_cancelled_order]
4. Freely design the page and assign these CSS classes to widgets that should display dynamic data:

CSS classes are assigned on each widget under: Advanced → CSS Classes.

The shortcode automatically replaces the content of elements with those classes with real order data when the page loads.

Adding more functionality

To add new shortcodes, AJAX endpoints, n8n integrations, etc:

1. Create a new file in includes/ (e.g. includes/ajax-endpoints.php).
2. Add it in gomeisa-payments.php inside gomeisa_payments_load() with a require_once.
3. Done — the module loads automatically.

Version

1.0.0 — Initial release with [gomeisa_cancelled_order] shortcode.