Sudan Online Payments for WooCommerce

Description

๐Ÿšฉ Important Notice: This is an unofficial, independently developed plugin. It is not affiliated with, endorsed by, or connected to any specific Sudanese bank, payment service (like Bankak or O-Cash), or financial company.

Sudan Online Payments for WooCommerce is an unofficial gateway that facilitates manual bank transfers for the Sudanese market.

It allows store owners to display their local bank or mobile money details (e.g., Bankak, O-Cash) at checkout. Customers complete their order by uploading a screenshot of their payment receipt for validation.

Important: This plugin does not process payments automatically. It streamlines the manual transfer process, but all transactions require merchant verification of the uploaded receipt.

๐Ÿš€ Key Features:

  • Support for Popular Sudanese Services: Pre-configured options for major banks and mobile money services:
    • ๐Ÿฆ Bankak (Bank of Khartoum)
    • ๐Ÿฆ O-Cash
    • ๐Ÿฆ Fawry (Faisal Islamic Bank)
    • ๐Ÿฆ SyberPay
    • ๐Ÿฆ MyCashi
    • ๐Ÿฆ Bravo
    • ๐Ÿฆ Custom Bank/Service
  • Integrated Receipt Upload:
    • AJAX-powered upload without page reload.
    • Client-side Validation: Accepts common image formats (JPG, PNG) with configurable size limits.
    • Upload Preview: Customers see a thumbnail of their uploaded receipt.
  • User-Friendly Checkout Interface: Modern grid layout for payment options with a โ€œCopy Account Numberโ€ button for convenience.
  • Complete Admin Management: Dynamically add, edit, or remove account details from the WooCommerce settings. View uploaded receipts directly in the order details.
  • Localization Ready: Includes translation files and is fully translated into Arabic and English.

Screenshots

  • WooCommerce Settings โ€“ The configuration tab for adding and managing bank accounts.
  • Checkout Page โ€“ Displaying bank account cards and the receipt upload field.
  • Order Details โ€“ Viewing the uploaded customer receipt in the admin backend.

Installation

  1. Upload the sudan-online-payments-for-woocommerce folder to your /wp-content/plugins/ directory, or install the plugin directly via the WordPress admin panel.
  2. Activate the plugin through the โ€˜Pluginsโ€™ menu in WordPress.
  3. Navigate to WooCommerce > Settings > Payments.
  4. Find โ€œSudan Online Paymentsโ€ in the list and click โ€œEnableโ€.
  5. Click the โ€œManageโ€ button to configure your bank account details and settings.

FAQ

Is this plugin officially made by Bankak, O-Cash, or any bank?

No. This is an unofficial, independently developed plugin created by a freelance developer to serve the Sudanese e-commerce community. It supports interoperability with these services but is not a product of those companies.

Does the plugin automate the payment confirmation?

No. This gateway facilitates a manual bank transfer process. The customer makes the transfer via their banking app, uploads proof, and the store admin must manually verify the receipt and update the order status (e.g., to โ€œProcessingโ€ or โ€œCompletedโ€).

Is it compatible with the WooCommerce Blocks (the new checkout)?

The plugin is primarily built and tested for the classic WooCommerce checkout shortcode ([woocommerce_checkout]). For full functionality, including the receipt upload field, using the classic checkout is recommended.

Can I add a bank or service that is not in the list?

Yes. The settings include a โ€œCustom Bank/Serviceโ€ option where you can specify any other transfer method.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Sudan Online Payments for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial public release.
  • Complete rename to โ€œSudan Online Payments for WooCommerceโ€ to clarify unofficial, independent status.