Skip to main content

WooCommerce Plugin

Accept 40+ payment methods on your WooCommerce store with zero coding. Official Omise plugin with full payment method support.

Overviewโ€‹

The Omise Payment Gateway plugin enables WooCommerce stores to accept credit cards, mobile banking, e-wallets, QR payments, and buy-now-pay-later services across Southeast Asia.

Key Features:

  • โœ… 40+ payment methods - Cards, wallets, QR, mobile banking, BNPL
  • โœ… Zero coding required - Install and configure via WordPress admin
  • โœ… 3D Secure support - Enhanced security for card payments
  • โœ… Secure payment form - PCI-compliant tokenization
  • โœ… Multi-currency - THB, SGD, MYR, JPY support
  • โœ… Automatic updates - Via WordPress Plugin Directory

Supported Versionsโ€‹

SoftwareSupported Versions
WooCommerce3.3.4 - 7.0.0+
WordPress4.3.1+ (tested up to 6.8.1)
PHP7.2+ (PHP 8.2+ supported as of v5.9.0)
Security Alert

Do NOT use plugin versions below 4.8 - they have known security vulnerabilities. Always use the latest version.

Installationโ€‹

  1. Log in to WordPress admin
  2. Navigate to Plugins โ†’ Add New
  3. Search for "Omise"
  4. Click "Install Now" on "Omise Payment Gateway"

WordPress Plugin Directory - Install

  1. Click "Activate"

WordPress Plugin Directory - Activate

Method 2: Manual Installationโ€‹

  1. Download latest release from WordPress.org
  2. Go to Plugins โ†’ Add New โ†’ Upload Plugin
  3. Choose downloaded ZIP file
  4. Click "Install Now"
  5. Extract and rename the folder to "Omise"

Rename extracted folder to Omise

  1. Click "Activate Plugin"

Installed Plugins page with activation

Method 3: GitHub (Developers)โ€‹

cd /path/to/wordpress/wp-content/plugins/
git clone https://github.com/omise/omise-woocommerce.git
cd omise-woocommerce
composer install

Then activate via WordPress admin.

Configurationโ€‹

Step 1: Get Your API Keysโ€‹

  1. Log in to Omise Dashboard
  2. Navigate to Settings โ†’ API Keys
  3. Copy your Public Key and Secret Key
Test vs Live Mode
  • Test Mode: Use pkey_test_... and skey_test_... for testing
  • Live Mode: Use pkey_... and skey_... for real transactions

Step 2: Configure Pluginโ€‹

  1. Go to WooCommerce โ†’ Settings โ†’ Payments
  2. Click "Omise" or "Manage"
  3. Enter your API keys:
Public Key: pkey_test_YOUR_PUBLIC_KEY
Secret Key: skey_test_YOUR_SECRET_KEY

Omise settings page with API keys

  1. Check "Enable Test Mode" for testing
  2. Click "Save changes"

Step 3: Enable Payment Methodsโ€‹

The plugin automatically displays available payment methods based on your Omise account country.

  1. Go to WooCommerce โ†’ Settings โ†’ Payments
  2. You'll see all available payment methods:
    • Credit / Debit Card
    • PromptPay
    • TrueMoney
    • Mobile Banking (multiple banks)
    • Internet Banking
    • Installments
    • Alipay+ wallets
    • And more...

Available payment methods and card configuration

  1. Click "Config" on each method you want to enable
  2. Check "Enable/Disable" field
  3. Configure method-specific settings
  4. Click "Save changes"

Available Payment Methodsโ€‹

By Regionโ€‹

Thailand:

  • Credit/Debit Cards
  • PromptPay
  • TrueMoney Wallet
  • TrueMoney QR
  • Rabbit LINE Pay
  • ShopeePay
  • Mobile Banking (Bangkok Bank, KBank, SCB, KTB, Krungsri)
  • Internet Banking (deprecated)
  • Installments (8 banks)
  • Alipay, WeChat Pay, Boost, GrabPay

Singapore:

  • Credit/Debit Cards
  • PayNow
  • GrabPay
  • OCBC Digital
  • Alipay+ wallets
  • Apple Pay, Google Pay

Malaysia:

  • Credit/Debit Cards
  • FPX (19 banks)
  • DuitNow
  • GrabPay
  • Touch 'n Go
  • ShopeePay
  • Boost

Japan:

  • Credit/Debit Cards
  • Konbini (convenience store)
  • Pay-easy
  • PayPay
Payment Method Availability

Available methods depend on your Omise account's registered country. Contact support@omise.co to request additional payment methods.

Advanced Featuresโ€‹

3D Secure Configurationโ€‹

3D Secure adds extra authentication for card payments to reduce fraud.

To Enable:

  1. Contact Omise support: support@omise.co
  2. Request 3D Secure activation for your account
  3. Plugin automatically supports both 3DS and non-3DS charges

How It Works:

  • Customer enters card details
  • Redirected to bank for authentication
  • Returns to your site after verification
  • Order processed based on auth result

Secure Payment Formโ€‹

The secure form provides enhanced security with customizable themes.

To Enable:

  1. Go to WooCommerce โ†’ Settings โ†’ Payments
  2. Click "Config" on Credit/Debit Card
  3. Scroll to "Advanced Settings"
  4. Set "Secure form" to "Yes"
  5. Choose theme: Light or Dark
  6. Click "Save changes"

Form Customization:

You can customize the payment form appearance by clicking the customization link:

Customization link for payment form

This opens the form customization interface where you can adjust colors, styling, and appearance:

Form customization interface

Preview your customized payment form before going live:

Preview of customized payment form

Customization Note

Customizations made to the earlier card payment form are NOT retained when enabling the secure form. You must redo any customizations.

Manual vs Automatic Captureโ€‹

Automatic Capture (Default):

  • Charge processed immediately on order completion
  • Customer charged right away

Manual Capture:

  • Only authorizes payment (holds funds)
  • You manually capture later via dashboard
  • Useful for made-to-order items

To Enable Manual Capture:

  1. Edit payment method settings
  2. Check "Manual Capture"
  3. Save changes

Required for:

  • TrueMoney Wallet
  • Installment Payments

Webhook Configurationโ€‹

Webhooks provide real-time payment notifications.

  1. Go to Omise โ†’ Settings
  2. Copy the Webhook URL shown
  3. Log in to Omise Dashboard
  4. Go to Settings โ†’ Webhooks
  5. Add your site's webhook URL
  6. Select events or choose "All events"
  7. Save

Events to Enable:

  • charge.complete
  • charge.failed
  • refund.create

Testingโ€‹

Enable Test Modeโ€‹

  1. WooCommerce โ†’ Settings โ†’ Payments โ†’ Omise
  2. Check "Enable Test Mode"
  3. Enter test API keys
  4. Save changes

Test Cardsโ€‹

Card NumberResult
4242 4242 4242 4242Success
4000 0000 0000 0002Decline

Use any future expiration date and any CVV.

Test Alternative Payment Methodsโ€‹

For QR and e-wallet methods:

  1. Place test order
  2. Complete checkout
  3. Use Omise Dashboard "Actions" button
  4. Mark test charge as successful or failed

Testing Checklistโ€‹

  • Test card payment success
  • Test card payment decline
  • Test 3D Secure (if enabled)
  • Test alternative payment methods
  • Test refunds
  • Test manual capture (if enabled)
  • Verify order status updates
  • Test webhook notifications
  • Check email confirmations
  • Test mobile checkout

Refundsโ€‹

Process Refundsโ€‹

  1. Go to WooCommerce โ†’ Orders
  2. Open the order
  3. Click "Refund"
  4. Enter refund amount
  5. Check "Refund via Omise"
  6. Click "Refund"

Supported:

  • Full refunds
  • Partial refunds (for supported methods)
  • Automatic inventory restocking

Limitations:

  • Some payment methods don't support refunds (e.g., PromptPay)
  • Check individual method documentation

Learn more about refunds โ†’

Troubleshootingโ€‹

Issue: Payment Methods Not Showingโ€‹

Causes:

  • Omise plugin not activated
  • API keys not configured
  • Payment method not available for your country
  • WooCommerce not properly installed

Solution:

  1. Verify plugin is active
  2. Check API keys are entered correctly
  3. Ensure test mode setting matches your keys
  4. Contact support for method availability

Issue: 3D Secure Errorโ€‹

Error: "3d secure is requested, but return URI is not set"

Solution:

  1. Enable 3D Secure on the plugin FIRST
  2. Then contact support to enable on your account
  3. The plugin automatically handles return URIs

Issue: Payments Not Processingโ€‹

Checklist:

  • Correct API keys entered
  • Test/live mode matches keys
  • PHP version 7.2 or higher
  • WooCommerce 3.3.4 or higher
  • Plugin version 4.8 or higher
  • HTTPS enabled on checkout pages
  • No JavaScript errors in browser console

Issue: Webhook Not Workingโ€‹

Solution:

  1. Check webhook URL is correct in Omise dashboard
  2. Ensure site is publicly accessible (not localhost)
  3. Verify SSL certificate is valid
  4. Check webhook logs in Omise dashboard
  5. Test webhook delivery manually

Issue: Orders Stuck in "Pending"โ€‹

Causes:

  • Webhook not configured
  • Customer didn't complete payment
  • Payment gateway timeout

Solution:

  1. Configure webhooks properly
  2. Check Omise dashboard for charge status
  3. Manually update order status if needed

Best Practicesโ€‹

1. Always Use Latest Versionโ€‹

# Check for updates regularly
wp plugin update omise-woocommerce

2. Test Before Going Liveโ€‹

  • Complete full checkout in test mode
  • Test all enabled payment methods
  • Verify order status updates
  • Check email notifications

3. Monitor Failed Paymentsโ€‹

  1. WooCommerce โ†’ Orders
  2. Filter by "Failed" status
  3. Contact customers if needed
  4. Analyze failure patterns

4. Configure Proper Email Notificationsโ€‹

  1. WooCommerce โ†’ Settings โ†’ Emails
  2. Customize email templates
  3. Test email delivery
  4. Set up proper SMTP (not PHP mail)

5. Enable Logging for Debuggingโ€‹

  1. WooCommerce โ†’ Status โ†’ Logs
  2. Select "omise" log file
  3. Review for errors during troubleshooting

6. Keep Backupsโ€‹

# Backup before updates
wp db export
wp plugin list --format=json > plugins-backup.json

7. Use Staging Environmentโ€‹

Test updates on staging before production:

  1. Clone site to staging
  2. Update plugin
  3. Test thoroughly
  4. Deploy to production

FAQโ€‹

Is the plugin free?

Yes, the Omise WooCommerce plugin is completely free. You only pay transaction fees on processed payments.

Can I accept international cards?

Yes, Omise supports international credit and debit cards (Visa, Mastercard, JCB, Amex). Enable multi-currency if available for your account.

Do I need PCI compliance?

The plugin handles card data securely via tokenization. You typically only need SAQ A compliance (simplest form). Consult your security team for specifics.

Can I use multiple payment methods?

Yes! Enable as many payment methods as you want. Customers choose at checkout.

How do transaction fees work?

Omise charges per-transaction fees:

  • Cards & Installments: 3.65%
  • PromptPay: 1.65%
  • Other methods: Varies

Check your Omise dashboard for specific rates.

Can I customize the payment form?

The secure form has limited customization (light/dark theme). For full control, use the standard integration (allows CSS customization).

Support & Resourcesโ€‹

Getting Helpโ€‹

Plugin Support:

  • Email: support@omise.co
  • Subject line: "Support Request: WooCommerce"
  • Include: Plugin version, WooCommerce version, error messages

Community:

Documentationโ€‹

System Requirementsโ€‹

WordPress: 5.0 or higher
WooCommerce: 3.3.4 - 7.0.0+
PHP: 7.2 or higher
SSL: HTTPS required for checkout

Next Stepsโ€‹

  1. Install plugin
  2. Configure API keys
  3. Enable payment methods
  4. Test in test mode
  5. Configure webhooks
  6. Go live