Enables Credit/Debit card payments through Thawani on your WooCommerce shop.
Report a bug
⚠ INFORMATION & REQUIREMENTS
- Thawani For WooCommerce is currently only available in Oman.
- Only OMR is currently supported.
The Thawani Plugin for WooCommerce allows merchants to accept Credit & Debit card transactions.
This plugin will only work with WooCommerce and is built to extend it.
The need for this project came from the shortage in the Omani market when it comes to payment gateways that allows online transactions to be in OMR. Most payment gateways do not support this and require some kind of currency conversion as part of the transaction process.
Thawani Pay is a Payment Gateway that solves this problem. The Thawani Checkout API, allows for transactions to be made using OMR.
This project makes Thawani's API accessible to the public. Making it easy for anyone to setup Credit & Debit Payment on their online store.
The Thawani for Woocommerce plugin is a community project launched by PhazeRo where we would like to give everyone the opportunity to take part in its development. If you wish to contribute and be part of this project look at the Contribution file.
- Credit & Debit card payment.
- Payments are in OMR no conversion currency needed.
- Easy to switch from sandbox and live environment.
- Checks for payment confirmation.
- Track Session History
- Logging to make debugging easy.
- Sharable payment link
- WooCommerce 5.6+
For live account, please create a merchant account with Thawani then follow the instructions on their documentation.
- Download the .zip file from this repository.
- Go to: WordPress Admin > Plugins > Add New to upload the .zip file you downloaded with Choose File.
- Activate the extension. (If you haven't already in the previous step)
More information at: Managing Plugins.
For the plugin to work properly, please make sure that your permalink settings are set to post name. To do that Go to: Settings > Permalinks > Common Settings and make sure that post name is selected.
- Go to: WooCommerce > Settings > Payments.
- Select Thawani Gateway. You are taken to the configuration screen.
- Enable/Disable – Enabled by default. Disable to turn off Thawani Pay.
- Select the Environment:
- Development Environment
In development environment you will be able to make mock payments to simulate the payment processing flow of a live account.
When you are in development mode you will need to use the User Acceptable Test ("UAT") secret and publishable keys and not your own secret and publishable keys. These two keys can be found on the Thawani documentation.
- Production Environment
Production environment is to be used when the website is live
To setup a live account you need the following:
- An SSL certificate.
- A Thawani merchant account. You can apply by visiting Thawani's website.
- Access to the Thawani merchant dashboard. This is where you can get your live secret and publishable keys. Learn more by reading Thawani's documentation.
- Add the following URL:
https//<YOUR-SITE-URL>/wc-api/thawani-payment-statusto the webhook URL section on the Thawani dashboard. Learn more by reading Thawani's documentation. - Set the secret and publishable keys in the payment settings page to the secret and publishable keys provided by Thawani
- Enable logging
Thawani For WooCommerce comes with a troubleshooting tool. This is in the form of logs. The logs are added each time a user orders an item, even if the payment fails.
To enable logging make sure that the Enable Logging checkbox is checked.
To view the logs Go to: WooCommerce > Status > Logs
The logs messages for this plugin follow the following format thawani-<DATE-OF-ORDER-PLACEMENT>.
The Thawani Gateway plugin keeps a record of all the sessions created to process payments and displays them for the admin.
The plugin keeps a record of:
- Timestamp of when the session was created
- Client refrence / Order ID
- Customer Information
- Payment Status
- Total Amount
To access the session history: Go to: WordPress Admin > Thawani Gateway
Nothing will be change from WooCommerce's default customer checkout flow. Customers will see an option on their checkout page to select payment via Thawani as shown in the image below:
To view all orders Go to: WooCommerce > Orders
Note that this plugin automatically updates the order status as follows:
- Processing: Payment received (paid); order is awaiting fulfillment from merchant.
- On hold: Awaiting payment
- Failed: Payment failed or was declined (unpaid)
- Canceled: Canceled by an admin or the customer
For more information about WooCommerce Orders, Go to: Managing Orders.
We welcome input from the community please let us know how we can improve this plugin. Do not hesitate to ask us questions on the issues page.
Distributed under the MIT License. See [License] (https://github.com/PhazeRoOman/thawani-for-woocommerce/blob/changes/LICENSE.md) for more information.