omise / omise-magento
omise/omise-magento
Accept payments on your Magento 2 website with Omise
Omise Magento is the official payment extension which provides support for Omise payment gateway for store builders working on the Magento platform.
Supported Versions
Our aim is to support as many versions of Magento as we can.
Here's the list of versions we tested on:
- Magento (CE) 2.2.4, tested on PHP 7.0.29.
To report problems for the version you're using, feel free to submit the issue through GitHub's issue channel by following the Reporting the issue Guideline.
Legacy Support
For merchants looking for support for Magento (CE) 1.x series, please check 1-stable branch.
Can't find the version you're looking for?
Submit your requirement as an issue to https://github.com/omise/omise-magento/issues
Getting Started
Installation Instructions
Via Composer
Installing the extension is done via composer. Simply run the following command in the Magento root folder:
composer require "omise/omise-magento:@stable"
Once this is done, run the following commands:
php bin/magento module:enable Omise_Payment --clear-static-content php bin/magento setup:upgrade php bin/magento setup:di:compile
First Time Setup
After installing, you can configure the module by:
- Log in to your Magento back-end with the administrator account.
- Go to
Stores>Configuration>Sales>Payment Methods.
Settings is displayed under the Omise section.
The table below is the settings for the module and the description for each setting.
| Setting | Description |
|---|---|
| Sandbox | If selected, all transactions will be performed in TEST mode and TEST keys will be used |
| Public key for test | Your TEST public key can be found in your Dashboard. |
| Secret key for test | Your TEST secret key can be found in your Dashboard. |
| Public key for live | Your LIVE public key can be found in your Dashboard. |
| Secret key for live | Your LIVE secret key can be found in your Dashboard. |
| Webhook for endpoint | Read-only url to enable post order payment notifications. See Webhooks article. |
- To enable
sandboxmode, select the setting forSandboxtoYes.
Note:
If the setting for Sandbox is set to Yes, the keys for TEST will be used. If the setting for Sandbox is set to No, the keys for LIVE will be used.
Credit Card Solution
Available options:
| Setting | Description |
|---|---|
| Enable/Disable | Enables or disables 'Credit Card Payment method' |
| Payment Action | Set Authorize Only to only authorize a payment or Authorize and Capture to automatically capture payment after authorising. |
| Title | Payment Title displayed during checkout |
| 3-D Secure Support | Enable or disable support for additional Credit Card payment authorization |
Internet Banking Solution
Available options:
| Setting | Description |
|---|---|
| Enable/Disable | Enables or disables 'Internet Banking Payment method' |
| Title | Payment Title displayed during checkout |
Alipay Payment Solution
Available options:
| Setting | Description |
|---|---|
| Enable/Disable | Enables or disables 'Alipay Payment method' |
| Title | Payment Title displayed during checkout |
Tesco Bill Payment Solution
Available options:
| Setting | Description |
|---|---|
| Enable/Disable | Enables or disables 'Tesco Bill Payment method' |
| Title | Payment Title displayed during checkout |
Installment Payment Solution
Available options:
| Setting | Description |
|---|---|
| Enable/Disable | Enables or disables 'Installment Payment method' |
| Title | Payment Title displayed during checkout |
Contributing
Thanks for your interest in contributing to Omise Magento. 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 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
Submit the issue
Submit the issue through GitHub's issue channel.
Learn more about submitting an issue here: https://guides.github.com/features/issues
License
Omise-Magento is open-sourced software released under the MIT License.
CHANGELOG
v2.6 (Jan 15, 2019)
πΎ Bug Fixes
- Model\Ui\CapabilitiesConfigProvider: returns an empty array instaed of null when Installment payment method is disabled. (PR #174)
v2.5 (Jan 14, 2019)
β¨ Highlights
- Introducing support Installment Payments (PR #148)
π Enhancements
- Enable Place Order button on Internet Banking checkout option only if bank is selected. (PR #166)
- Restrict Tesco Bill Payment to THB transactions only (PR #165)
- Tesco Bill Payment added PRINT button (PR #164)
- Restrict internet banking payment method to THB orders only(PR #161)
- Send Tesco barcode to customer's email. (PR #158)
- Make plugin compatible with PHP 7.2 (PR #168)
πΎ Bug Fixes
- Fix for showing Tesco Bill Payment related information on checkout success page when using other payment methods (PR #163)
- Fix for missing "Terms and Conditions" in Alipay and Tesco payment method. (PR #162)
- Fixed problem that translation to 'Select a card you want to proceed (PR #160)
- Fix compilation error in Capabilities API (PR #171)
v2.4 (Oct 2, 2018)
β¨ Highlights
π Enhancements
- Force plugin to use newest Omise Api v2017-11-02 (PR #133)
- Code Refactoring, prepare plugin for future payment methods (PR #130, PR #131, PR #134, PR #137, PR #138, PR #149, PR #153)
- Move plugin information in admin panel to 'recommended' section (PR #129)
- Restrict Alipay for THB transactions only (PR #127)
- Changed
composer.jsonto fulfil requirements from Magento Market Store (PR #132)
πΎ Bug Fixes
- Fix for not working webhooks due to script compilation error (PR #141).
- Fix typo on a classname and filename (PR #135)
- Fix for wrong spelling in Admin Panel (PR #136)
v2.3 (Jun 20, 2018)
β¨ Highlights
- Introducing support of Alipay payments (PR #113)
- Support for Multistore Magento 2 configuration (PR #117)
- Simplify plugin installation process by using composer (PR #112)
- Introduce Webhook feature (PR #107)
π Enhancements
- Removed IDR currency support (PR #122)
- Updates config to apply Magento docs recommendations (PR #120)
- Removes link/dependency with Authorize.net module (PR #118)
- Removes specific fee warnings for Internet Banking + improve i18n (PR #114)
- Introduce API Object model structure and refactoring code (PR #103)
πΎ Bug Fixes
- Internet Banking: Proper set the order status if the returned charge status is set to 'pending' (PR #105)
- Removed unused files (PR #106)
v2.2 (Nov 02, 2017)
π Enhancements
- Force plugin to use a specific API version (2015-11-17) when make a request to Omise API (PR #94)
v2.1 (April 12, 2017)
β¨ Highlights
- Introduce 3-D Secure feature (PR #75, #76, #77, #78, #80, #82)
- Introduce Internet Banking feature (PR #62, #63, #64, #65, #66, #70, #71, #80)
- Support IDR & SGD Currencies (PR #72)
π Enhancements
[2.0] 2016-12-26
FIRST RELEASE FOR MAGENTO COMMUNITY EDITION 2.1.2 & 2.1.3
The first release contains a feature to create charge with auto capture and manual capture.
The merchant can select a setting, sandbox, to switch between test mode and live mode.
The list of charge can be found at Omise dashboard.
[1.9.0.6] 2016-08-10
ImprovedRemove jQuery library and update code according to new JS checkout form function
[1.9.0.5] 2016-01-05
FixedCheck authorized and captured status before continue the charge action.FixedDisable submit button action when user clicks submit.UpdatedExtendsMage_Payment_Model_Method_Abstractclass instead ofMage_Payment_Model_Method_Ccin the payment method class.
[1.9.0.4] 2015-11-16
AddedAddedOmiseMagento/[OmiseMagentoVersion],Magento/[MagentoVersion]intoOMISE_USER_AGENT_SUFFIX.UpdatedUpdated omise-php library from 2.3.1 to 2.4.0.FixedSupported php version 5.2 - 5.3.FixedAdded autocomplete attribute into card number and security code fields of the checkout form.
[1.9.0.3] 2015-08-09
UpdatedUpdated omise-php library from 2.2.0 to 2.3.1.FixedFix 'CamelCase' class name issue (CamelCaseName of class was not load in some host environment).
[1.9.0.2] 2015-07-07
Versioning & Document
UpdatedUpdated README.md fileUpdatedChanged version number in module's xml files from0.0.0.1to1.9.0.2to match Magento releases
Dashboard Page
ImprovedjQuery from http to https
[1.0.1] 2015-06-23
Dashboard Page
AddedAdded link to Omise Dashboard https://dashboard.omise.co into Magento Omise Dashboard Page.FixedOmise Email Account was not shown in dashboard page.
Dashboard Page: Transfer section
FixedTransfer box was not shown when that account doesn't have any transfer history.
[1.0.0] 2015-06-15
AddedImplemented Omise Dashboard into Magento's admin page. The features are as follows:- Show current account status (live or test) depends on that you configured in Omise Keys Setting page.
- Show total account balance, transferable balance.
- Show history of transfers.
- Admin was able to transfer their Omise Balance to their Bank account.
AddedImplemented Omise Keys Setting page into Magento's admin page.AddedAdded Omise menu into top bar menu of Magento's admin page.AddedAdded Omise Payment Gateway Module Configuration into Margento's admin page in payment method section.AddedImplemented Omise Charge API withAuthorizewith/withoutCaptureoptions.AddedAdded Omise Checkout Form into Magento's checkout page.AddedAdded omise-php library (v2.2.0) into this extension.UpdatedUpdated README.md.
[0.0.1] 2015-06-15
- Initial version.
| Version | Stability | QA Status | Released |
|---|---|---|---|
| 3.11.0 | stable | Fail | 2026-04-21 04:38:56 |
| 3.10.0 | stable | Not tested | 2026-03-10 09:14:49 |
| 3.9.0 | stable | Fail | 2025-03-19 04:19:33 |
| 3.8.0 | stable | Not tested | 2024-07-24 09:49:54 |
| 3.7.1 | stable | Not tested | 2024-05-08 08:06:32 |
| 3.7.0 | stable | Not tested | 2024-04-10 05:56:24 |
| 3.6.1 | stable | Not tested | 2024-02-12 07:51:14 |
| 3.6.0 | stable | Not tested | 2024-01-23 06:18:32 |
| 3.5.2 | stable | Not tested | 2023-12-07 08:47:31 |
| 3.5.1 | stable | Not tested | 2023-11-24 11:55:43 |
| 3.5.0 | stable | Not tested | 2023-10-24 07:33:39 |
| 3.4.0 | stable | Not tested | 2023-10-11 08:23:52 |
| 3.3.1 | stable | Not tested | 2023-10-03 07:16:21 |
| 3.3.0 | stable | Not tested | 2023-09-21 06:01:55 |
| 3.2.0 | stable | Not tested | 2023-08-22 06:14:18 |
| 3.1.2 | stable | Not tested | 2023-06-23 08:45:53 |
| 3.1.1 | stable | Not tested | 2023-06-12 07:57:05 |
| 3.1.0 | stable | Not tested | 2023-05-15 03:59:39 |
| 3.0.0 | stable | Not tested | 2023-04-03 07:38:12 |
| 2.32.0 | stable | Not tested | 2023-03-09 02:03:29 |
| 2.31.0 | stable | Not tested | 2023-01-23 10:05:41 |
| 2.30.0 | stable | Not tested | 2022-12-14 08:39:47 |
| 2.29.2 | stable | Not tested | 2022-10-25 07:20:13 |
| 2.29.1 | stable | Not tested | 2022-10-03 07:40:55 |
| 2.29.0 | stable | Not tested | 2022-09-19 08:42:35 |
| 2.28.0 | stable | Not tested | 2022-08-30 06:33:27 |
| 2.27.0 | stable | Not tested | 2022-06-30 06:53:18 |
| 2.26.0 | stable | Not tested | 2022-06-06 07:13:48 |
| 2.25.0 | stable | Not tested | 2022-05-25 09:45:46 |
| 2.24.0 | stable | Not tested | 2022-05-17 03:54:27 |
| 2.23.3 | stable | Not tested | 2022-05-12 08:14:19 |
| 2.23.2 | stable | Not tested | 2022-04-21 09:33:41 |
| 2.23.1 | stable | Not tested | 2022-04-08 02:53:22 |
| 2.23.0 | stable | Not tested | 2022-04-01 07:16:21 |
| 2.22.0 | stable | Not tested | 2022-03-24 03:23:42 |
| 2.21.0 | stable | Not tested | 2022-03-09 05:59:50 |
| 2.20.4 | stable | Not tested | 2022-02-15 03:28:02 |
| 2.20.3 | stable | Not tested | 2022-01-19 08:45:56 |
| 2.20.2 | stable | Not tested | 2021-12-03 07:09:08 |
| 2.20.1 | stable | Not tested | 2021-11-30 04:48:33 |
| 2.20.0 | stable | Not tested | 2021-11-09 04:11:00 |
| 2.19.0 | stable | Not tested | 2021-09-21 04:13:40 |
| 2.18.6 | stable | Not tested | 2021-09-16 07:25:50 |
| 2.18.5 | stable | Not tested | 2021-07-29 09:34:57 |
| 2.18.4 | stable | Not tested | 2021-07-29 07:42:36 |
| 2.18.3 | stable | Not tested | 2021-07-15 10:34:24 |
| 2.18.2 | stable | Not tested | 2021-07-07 02:42:00 |
| 2.18.1 | stable | Not tested | 2021-06-15 11:32:24 |
| 2.18 | stable | Not tested | 2021-06-10 04:51:56 |
| 2.17 | stable | Not tested | 2021-06-08 07:58:33 |
| 2.16 | stable | Not tested | 2020-12-24 07:14:32 |
| 2.15 | stable | Not tested | 2020-12-03 10:13:43 |
| 2.14 | stable | Not tested | 2020-11-16 13:00:07 |
| 2.13 | stable | Not tested | 2020-09-17 03:27:43 |
| 2.12 | stable | Not tested | 2020-08-25 13:49:53 |
| 2.11 | stable | Not tested | 2020-05-11 04:49:40 |
| 2.10 | stable | Not tested | 2020-03-20 04:49:28 |
| 2.9 | stable | Not tested | 2019-09-06 06:10:54 |
| 2.8 | stable | Not tested | 2019-07-17 10:08:04 |
| 2.7 | stable | Not tested | 2019-01-21 08:59:57 |
| 2.6 | stable | Not tested | 2019-01-15 10:07:54 |
| 2.5 | stable | Not tested | 2019-01-14 08:13:54 |
| 2.4 | stable | Not tested | 2018-10-02 08:36:46 |
| 2.3 | stable | Not tested | 2018-06-20 10:00:31 |
| 2.2 | stable | Not tested | 2017-11-01 19:14:19 |
| 2.1 | stable | Not tested | 2017-04-11 21:53:30 |
| 2.0 | stable | Not tested | 2016-12-26 17:44:15 |
Requires 3
| Package | Constraint |
|---|---|
| php | >=5.6 |
| magento/magento-composer-installer | >=0.3.0 |
| omise/omise-php | 2.18.0 |
Requires-dev 3
| Package | Constraint |
|---|---|
| phpunit/phpunit | ^5.7 || ^9.5 |
| mockery/mockery | ^1.0 || ^1.6.2 |
| magento/community-edition | 2.4.4-p13 |
No QA results yet
QA pipelines haven't run for this version. Status appears here once the vendor publishes a tagged release that gets ingested.
Turn an existing module into recurring revenue.
If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.

