**Omise WooCommerce** is the official payment extension which provides support for Omise payment gateway for store builders working on the WooCommerce platform. ## Supported Versions WooCommerce version 3.3.4 and above (tested to version 3.9.2). **The extension doesn't work on your version?** Our aim is to support as many versions of WooCommerce as we can. If the version you are currently using has not been listed, you can try installing it and report any issues to us at [GitHub's issue channel](https://github.com/omise/omise-woocommerce/issues) by following the [Reporting the issue Guideline](https://guides.github.com/activities/contributing-to-open-source/#contributing). ## Getting Started - [Installation Instructions](#installation-instructions) - [WordPress Plugin Directory (recommended)](#wordpress-plugin-directory-recommended) - [Manually](#manually) - [First Time Setup](#first-time-setup) - [Connect your store with your Omise account](#connect-your-store-with-your-omise-account) - [Enable payment methods](#enable-payment-methods) ... ### Installation Instructions In order to install Omise WooCommerce plugin, you can either download it via WordPress Plugin Directory or manually download the plugin from this repository. #### WordPress Plugin Directory (recommended) Install Omise WooCommerce plugin via WordPress Plugin Directory by following these steps: 1. From the left sidebar at your WordPress Admin page, under **"Plugin"** section. Click **"Add New"**. 2. At the **"Add Plugins"** page, search for Omise WooCommerce plugin using keyword: `Omise`. 3. Click **"Install Now"** to download and install Omise WooCommerce plugin into your WordPress website.  4. After the plugin has been downloaded and installed. The **"Install Now"** button will now be changed to **"Activate"**. Make sure to click **"Activate"**  #### Manually 1. Download and extract the zip file from [Omise-WooCommerce](https://github.com/omise/omise-woocommerce/archive/v3.11.zip) to your local machine.  2. Copy all files from the step 1 to WordPress plugin folder, `your-wordpress-dir/wp-content/plugins/omise-woocommerce-3.11`. 3. Rename `omise-woocommerce-3.11` folder to `omise`  4. Once done, `Omise Payment Gateway` plugin will be shown at the **Installed Plugins** page. Click **"Activate"** to activate the plugin.  Now you've done installing Omise-WooCommerce plugin. Next, check **[First Time Setup](#first-time-setup)** to continue setting up your Omise account with your WooCommerce store. ### First Time Setup #### Connect your store with your Omise account  Once the installation is done, the next thing that you are going to do is to connect your store with your Omise account and enable payment methods so your customers can make a purchase with an online payment. 1. Log in to WordPress admin page. 2. From the sidebar, go to `Omise > Settings`. 3. At the Omise Settings page, you are going to set your `Public key` and `Secret key` (these keys can be found at [Omise Dashboard](https://dashboard.omise.co/test/keys)). 4. Make sure that the option `Test mode` is checked and set your Omise keys at `Public key for test` and `Secret key for test` fields if you would like to test Omise service integration. 5. Click **"Save Settings"**. #### Enable payment methods > Note that Alipay, Bill Payment: Tesco, Installment, Internet Banking, and TrueMoney Wallet payment methods are only available for merchants that are registered in Thailand. The payment methods available for you to enable on your store are: **Alipay**, **Bill Payment: Tesco**, **Credit / Debit Card**, **Installment**, **Internet Banking**, and **TrueMoney Wallet**. 1. At the Omise Settings page, Payment Methods section, there will be a number of available payment methods shown on the list. 2. Click **"config"** in the table for the payment method you'd like to accept payment with. 3. You will see a configuration page differently depends on which payment method you are choosing. The screenshot below shows Credit / Debit Card payment method's configuration page.  4. At the configuration page, mark **"Enable/Disable"** as checked. 5. You may change or update other options in this configuration page (optional). 5. Click **"Save changes"**. Once done, those payment methods will be shown at the store's checkout page.  ## Contributing Thanks for your interest in contributing to Omise WooCommerce. We're looking forward to hearing your thoughts and willing to review your changes. The following subjects are instructions for contributors who consider to submit changes and/or issues. ### Submit the changes You're all welcome to submit a pull request. Please consider the [pull request template](https://github.com/omise/omise-woocommerce/blob/master/.github/PULL_REQUEST_TEMPLATE.md) and fill the form when you submit a new pull request. Learn more about submitting pull request here: [https://help.github.com/articles/about-pull-requests](https://help.github.com/articles/about-pull-requests) ### Submit the issue Submit the issue through [GitHub's issue channel](https://github.com/omise/omise-woocommerce/issues). Learn more about submitting an issue here: [https://guides.github.com/features/issues](https://guides.github.com/features/issues) ## License Omise-WooCommerce is open-sourced software released under the [MIT License](https://opensource.org/licenses/MIT).