ShegerPay for WooCommerce

Quick Answer: WordPress store owners install the official ShegerPay WooCommerce plugin in five minutes and immediately accept CBE Birr, Telebirr, Visa, PayPal, and USDT at checkout. Non-custodial means funds land directly in your accounts with no settlement delay, no merchant license needed, no percentage take on top of your pricing tier.

The problem WordPress store owners face today

WooCommerce ships with PayPal and Stripe gateways out of the box — neither of which serves Ethiopian merchants natively. So WordPress store owners in Ethiopia end up cobbling together: a Chapa plugin (custodial, percentage fee, no PayPal support), a manual bank transfer flow (where the customer uploads a screenshot and you reconcile by hand), and maybe a separate USDT widget for crypto-savvy buyers. Three checkouts in one store. Cart abandonment goes through the roof because customers can't find the rail they actually use.

The plugins that do exist either lock you into custodial settlement (your money held for days), charge a percentage on every transaction (eating WordPress sellers' already-thin margins), or fail to support PayPal and crypto entirely (cutting off diaspora and international buyers).

And the install experience for most Ethiopian payment plugins is rough — outdated documentation, broken WordPress compatibility, no proper sandbox for testing. You install, test, debug for a weekend, and then discover the plugin doesn't support variable products or subscriptions.

How ShegerPay solves it

The official ShegerPay WooCommerce plugin is published on GitHub at github.com/shegerpay/sdk-wordpress and listed in the WordPress plugin directory. Install activates one unified gateway that surfaces every rail at checkout — customer picks CBE, Telebirr, Visa, PayPal, or USDT. ShegerPay verifies the payment server-side and flips the WooCommerce order to "Processing" automatically via webhook. No screenshots, no manual reconciliation, no separate gateways per rail.

The plugin supports variable products, subscriptions (via WooCommerce Subscriptions), promo codes (via WooCommerce coupons), bundled products, and partial refunds — all wired to ShegerPay's verification API.

Step-by-step install (5 minutes)

  1. In WordPress admin, go to Plugins → Add New → Upload Plugin.
  2. Upload the shegerpay-woocommerce.zip file from github.com/shegerpay/sdk-wordpress/releases (or search "ShegerPay" in the plugin directory and click Install).
  3. Activate the plugin.
  4. Go to WooCommerce → Settings → Payments → ShegerPay.
  5. Paste your API key (use sk_test_demo to try without signup, or your real sk_live_… key).
  6. Tick the rails you want to enable (CBE, Telebirr, Visa, PayPal, USDT).
  7. Save. The webhook URL is auto-configured. Done — checkout now offers ShegerPay.

Code example (custom hook in functions.php)

For stores that want to extend the plugin — e.g., to log every verified order to a custom CRM:

<?php
// Listen for ShegerPay verified payments inside WooCommerce
add_action( 'shegerpay_payment_verified', function( $order_id, $payment_data ) {

    $order = wc_get_order( $order_id );
    $order->update_meta_data( '_sp_rail',  $payment_data['rail'] );
    $order->update_meta_data( '_sp_tx_id', $payment_data['tx_id'] );
    $order->save();

    // Push to your CRM
    wp_remote_post( 'https://crm.example.et/api/orders', [
        'headers' => [ 'Authorization' => 'Bearer ' . CRM_TOKEN ],
        'body'    => wp_json_encode([
            'order_id'  => $order_id,
            'customer'  => $order->get_billing_email(),
            'amount'    => $order->get_total(),
            'currency'  => $order->get_currency(),
            'rail'      => $payment_data['rail'],
            'tx_id'     => $payment_data['tx_id'],
            'paid_at'   => $payment_data['settled_at'],
        ]),
    ]);

}, 10, 2 );

The plugin also exposes JS hooks on the checkout page (shegerpay:rail_selected, shegerpay:payment_initiated) for analytics integrations.

Why non-custodial matters for WooCommerce stores

Most WooCommerce payment plugins for Ethiopia are custodial — they hold your customer's payment in a processor balance for 2-7 days, then transfer to your bank minus a percentage. For a WordPress small business, that settlement delay is cashflow you cannot use to restock inventory, and that percentage fee is profit you cannot recover.

ShegerPay's non-custodial plugin moves money customer-to-merchant directly through the rail. The CBE Birr lands in your CBE account in real time. The PayPal payment lands in your PayPal in real time. No reserve, no rolling balance, no percentage cut beyond your flat monthly plan. For a WordPress merchant, the difference is meaningful — both in cashflow and in margin.

Workflow features used

  • Official WooCommerce plugin (5-minute install)
  • Unified checkout with rail picker (CBE, Telebirr, Visa, PayPal, USDT)
  • WooCommerce coupons / promo code support
  • Variable products and subscriptions support
  • Action hooks for custom integrations
  • Auto-configured webhooks

Pricing fit

Small WordPress stores doing under 100 orders/month fit Free. Growing WP stores at 100-1,000 orders/month sit on Starter $9. High-volume WooCommerce shops with subscriptions fit Growth $29. No transaction percentage on any tier.

FAQ

Does the plugin support WooCommerce Subscriptions? Yes — recurring renewals run through ShegerPay's subscription engine with multi-rail dunning.

Will it work with my existing theme? Yes — the gateway uses standard WooCommerce checkout hooks and inherits your theme's styling.

Can I offer promo codes / coupons? Yes — WooCommerce's native coupon system works as normal; ShegerPay sees the discounted total.

Is there a transaction fee on top of the monthly plan? No ShegerPay percentage fee. You pay only what your bank, Telebirr, PayPal, or chain charges.

Can I test without signing up? Yes — use the demo API key sk_test_demo in the plugin settings; checkout fully simulates without real money.

Where do I get support? GitHub issues at github.com/shegerpay/sdk-wordpress or via the support contact in your ShegerPay dashboard.

Related: Pricing · API Docs · ShegerPay vs Chapa · Verify CBE · Non-custodial payments explained