{"id":18707269,"url":"https://github.com/phazerooman/thawani-for-woocommerce","last_synced_at":"2025-06-15T05:32:41.743Z","repository":{"id":39921439,"uuid":"317724720","full_name":"PhazeRoOman/thawani-for-woocommerce","owner":"PhazeRoOman","description":"WooCommerce Thawani gateway integraration","archived":false,"fork":false,"pushed_at":"2025-01-18T18:38:07.000Z","size":12118,"stargazers_count":34,"open_issues_count":0,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-13T02:50:34.259Z","etag":null,"topics":["payment-gateway","php","woocommerce","woocommerce-payment","woocommerce-plugin","wordpress"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PhazeRoOman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-12-02T02:18:33.000Z","updated_at":"2025-03-28T17:24:20.000Z","dependencies_parsed_at":"2025-04-12T10:32:00.687Z","dependency_job_id":"e6efc9d7-f0e2-42c1-8ae8-ce23ca59e853","html_url":"https://github.com/PhazeRoOman/thawani-for-woocommerce","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/PhazeRoOman/thawani-for-woocommerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhazeRoOman%2Fthawani-for-woocommerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhazeRoOman%2Fthawani-for-woocommerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhazeRoOman%2Fthawani-for-woocommerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhazeRoOman%2Fthawani-for-woocommerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PhazeRoOman","download_url":"https://codeload.github.com/PhazeRoOman/thawani-for-woocommerce/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PhazeRoOman%2Fthawani-for-woocommerce/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259926928,"owners_count":22933131,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["payment-gateway","php","woocommerce","woocommerce-payment","woocommerce-plugin","wordpress"],"created_at":"2024-11-07T12:17:19.918Z","updated_at":"2025-06-15T05:32:41.708Z","avatar_url":"https://github.com/PhazeRoOman.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"link to the projects website\"\u003e\n    \u003cimg src=\"./asset/thawani.svg\" alt=\"Logo\" width=\"150\" style=\"background-color: white\"\u003e\n  \u003c/a\u003e\n\n  \u003ch1 align=\"center\"\u003eThawani For WooCommerce\u003c/h1\u003e\n\n  \u003cp align=\"center\"\u003e\n    Enables Credit/Debit card payments through Thawani on your WooCommerce shop.\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/PhazeRoOman/thawani-for-woocommerce/issues\"\u003eReport a bug\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n  \u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/PhazeRoOman/thawani-for-woocommerce/releases/latest/download/thawani-for-woocommerce.zip\"\u003eDownload latest release\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr /\u003e\n\n\u003e \u003cbr\u003e\n\u003e\n\u003e **⚠ INFORMATION \u0026 REQUIREMENTS**\n\u003e\n\u003e - Thawani For WooCommerce is currently only available in Oman.\n\u003e - Only OMR is currently supported.\n\u003e   \u003cbr\u003e \u003cbr\u003e\n\n\u003cbr /\u003e\n\nThe Thawani Plugin for WooCommerce allows merchants to accept Credit \u0026 Debit card transactions.\n\nThis plugin will only work with WooCommerce and is built to extend it.\n\n## Motivation\n\nThe 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.\n\n[Thawani Pay](https://thawani.om/about/) is a Payment Gateway that solves this problem. The [Thawani Checkout](https://thawani.om/checkout/) API, allows for transactions to be made using OMR.\n\nThis project makes Thawani's API accessible to the public. Making it easy for anyone to setup Credit \u0026 Debit Payment on their online store.\n\n## Contribution\n\nThe Thawani for Woocommerce plugin is a community project launched by [PhazeRo](https://phaze.ro/) 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](./CONTRIBUTING.md) file.\n\n## Features\n\n- Credit \u0026 Debit card payment.\n- Payments are in OMR no conversion currency needed.\n- Easy to switch from sandbox and live environment.\n- Checks for payment confirmation.\n- Track Session History\n- Logging to make debugging easy.\n- Sharable payment link\n\n## Requirements\n\n- WooCommerce 5.6+\n\nFor live account, please create a [merchant account](https://thawani.om/merchants/) with Thawani then follow the instructions on their [documentation](https://developer.thawani.om/).\n\n## Installation\n\n1. **Download** the .zip file from this repository.\n\n![download zip file](./static/download_zip.PNG)\n\n2. **Go to: WordPress Admin \u003e Plugins \u003e Add New** to upload the .zip file you downloaded with Choose File.\n\n![install the plugin](./static/thawani_install.gif)\n\n3. **Activate** the extension. (If you haven't already in the previous step)\n\n![activate the plugin](./static/activate_plugin_blur.PNG)\n\nMore information at: [Managing Plugins](https://wordpress.org/support/article/managing-plugins/).\n\nFor the plugin to work properly, please make sure that your permalink settings are set to _post name_. To do that **Go to: Settings \u003e Permalinks \u003e Common Settings** and make sure that _post name_ is selected.\n\n![permalink settings](./static/permalink.png)\n\n## Thawani For WooCommerce Set up\n\n1. **Go to: WooCommerce \u003e Settings \u003e Payments**.\n\n![payment settings](./static/woocommerce_setting.PNG)\n\n2. Select **Thawani Gateway**. You are taken to the configuration screen.\n\n![Thawani Payment Gateway](./static/thawani_payment_gateway_setting.PNG)\n\n3. **Enable/Disable** – Enabled by default. Disable to turn off Thawani Pay.\n\n![enable/disable plugin](./static/enable_disable.gif)\n\n## Configuration\n\n1. Select the Environment:\n\n- Development Environment\n\nIn development environment you will be able to make mock payments to simulate the payment processing flow of a live account.\n\nWhen 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](https://developer.thawani.om/).\n\n- Production Environment\n\nProduction environment is to be used when the website is live\n\nTo setup a live account you need the following:\n\n- An SSL certificate.\n- A Thawani merchant account. You can apply by visiting [Thawani's website](https://thawani.om/merchants/).\n- 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](https://developer.thawani.om/).\n- Add the following URL: `https//\u003cYOUR-SITE-URL\u003e/wc-api/thawani-payment-status` to the webhook URL section on the Thawani dashboard. Learn more by reading [Thawani's documentation](https://developer.thawani.om/).\n- Set the secret and publishable keys in the payment settings page to the secret and publishable keys provided by Thawani\n\n![live keys](./static/keys.png)\n\n2. Enable logging\n\nThawani 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.\n\nTo enable logging make sure that the _Enable Logging_ checkbox is checked.\n\n![enable logging](./static/logging_enable.png)\n\nTo view the logs **Go to: WooCommerce \u003e Status \u003e Logs**\n\n![thawani logs](./static/logs.png)\n\nThe logs messages for this plugin follow the following format `thawani-\u003cDATE-OF-ORDER-PLACEMENT\u003e`.\n\n## View Session History\n\nThe Thawani Gateway plugin keeps a record of all the sessions created to process payments and displays them for the admin.\n\nThe plugin keeps a record of:\n\n- Timestamp of when the session was created\n- Client refrence / Order ID\n- Customer Information\n- Payment Status\n- Total Amount\n\nTo access the session history:\n**Go to: WordPress Admin \u003e Thawani Gateway**\n\n![session history](./static/session_history.png)\n\n## Customer Checkout Flow\n\n![customer workflow](./static/customer_workflow.gif)\n\nNothing 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:\n\n![checkout with thawani](./static/checkout_page.png)\n\n## Admin Order Fulfillment Flow\n\nTo view all orders **Go to: WooCommerce \u003e Orders**\n\n![go to order page](./static/order_page.png)\n\nNote that this plugin automatically updates the order status as follows:\n\n- **Processing:** Payment received (paid); order is awaiting fulfillment from merchant.\n- **On hold:** Awaiting payment\n- **Failed:** Payment failed or was declined (unpaid)\n- **Canceled:** Canceled by an admin or the customer\n\nFor more information about WooCommerce Orders, Go to: [Managing Orders](https://docs.woocommerce.com/document/managing-orders/).\n\n## Frequently Asked Questions\n\nWe 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](https://github.com/PhazeRoOman/thawani_gw/issues) page.\n\n## License\n\nDistributed under the MIT License. See [License] (https://github.com/PhazeRoOman/thawani-for-woocommerce/blob/changes/LICENSE.md) for more information.\n\n## Maintained By:\n\n- [PhazeRo](https://phaze.ro/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphazerooman%2Fthawani-for-woocommerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphazerooman%2Fthawani-for-woocommerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphazerooman%2Fthawani-for-woocommerce/lists"}