E-Commerce Plugins Overview

Integrate Omise payments into your e-commerce store without writing code. Official plugins for popular platforms make it easy to start accepting payments in minutes.

Supported Platforms

Shopify

Full-featured payment integration for Shopify stores:

• Quick setup through Shopify admin
• All payment methods supported
• Automatic order synchronization
• Built-in fraud protection
• Multi-currency support

View Shopify Guide →

Magento

Comprehensive plugin for Magento 2.x:

• One-click installation via Composer
• Supports all Omise payment methods
• Order management integration
• Multi-store configuration
• Advanced security features

View Magento Guide →

PrestaShop

Native integration for PrestaShop stores:

• Install from PrestaShop marketplace
• Card and alternative payment methods
• Automated refund handling
• Multi-language support
• Responsive checkout

View PrestaShop Guide →

OpenCart

Easy integration for OpenCart stores:

• Simple installation process
• Full payment method support
• Order status synchronization
• Test and live mode switching
• Mobile-optimized checkout

View OpenCart Guide →

EC-CUBE

Japanese e-commerce platform support:

• Compatible with EC-CUBE 4.x
• Local payment methods (Konbini, Pay-easy)
• Japanese language interface
• JCB card support
• Local settlement times

View EC-CUBE Guide →

Wix

Seamless payment integration for Wix websites:

• No-code setup through Wix dashboard
• Card payments and wallets
• Automatic payment page creation
• Mobile-responsive
• Wix store synchronization

View Wix Guide →

Platform Comparison

Feature	Shopify	Magento	PrestaShop	OpenCart	EC-CUBE	Wix
Installation	App Store	Composer	Marketplace	Upload	Composer	Native
Setup Time	10 min	15 min	15 min	20 min	15 min	10 min
Card Payments	✓	✓	✓	✓	✓	✓
Bank Transfer	✓	✓	✓	✓	✓	✓
E-Wallets	✓	✓	✓	✓	✓	✓
Installments	✓	✓	✓	✓	✓	✓
Auto Refunds	✓	✓	✓	✓	✓	Manual
Multi-Currency	✓	✓	✓	✓	✓	✓
Webhooks	✓	✓	✓	✓	✓	✓
Test Mode	✓	✓	✓	✓	✓	✓
3D Secure	✓	✓	✓	✓	✓	✓
Mobile Checkout	✓	✓	✓	✓	✓	✓
Updates	Auto	Manual	Manual	Manual	Manual	Auto

Minimum Plugin Versions

Security Update Required

Due to security updates and certificate changes, you must use at least these plugin versions. Older versions may fail to process payments.

Plugin	Minimum Version	Release Date
WooCommerce	4.8	19 Apr 2021
Magento	2.18.6	16 Sep 2021
PrestaShop	1.7.10	5 Sep 2023
OpenCart	2.5	5 Sep 2023
EC-CUBE	2.2	5 Sep 2023

Always update to the latest version for best security and compatibility. Check the plugin's GitHub repository for the latest releases.

How Plugins Work

General Flow

Key Components

1. Plugin Module

• Integrates with e-commerce platform
• Handles payment flow
• Manages configuration
• Processes webhooks

2. Payment Gateway

• Connects to Omise API
• Securely transmits payment data
• Receives payment confirmation
• Handles errors and retries

3. Order Management

• Updates order status
• Processes refunds
• Syncs with Omise dashboard
• Manages payment records

4. Customer Experience

• Seamless checkout flow
• Multiple payment options
• Mobile-responsive interface
• Real-time confirmation

Benefits of Using Plugins

No Coding Required

• Install through admin panel
• Configure with simple forms
• No technical knowledge needed
• Visual setup wizard

Quick Setup

• Average setup time: 10-20 minutes
• Step-by-step documentation
• Pre-configured defaults
• Test mode for safe testing

Full Feature Access

• All payment methods supported
• Card payments
• Bank transfers
• E-wallets
• Installment plans

Automatic Updates

• Security patches
• New payment methods
• Bug fixes
• Feature enhancements

Reliable Support

• Platform-specific documentation
• Troubleshooting guides
• Email support
• Community forums

PCI Compliance

• Secure payment processing
• No card data on your server
• SSL encryption
• Omise handles security

Common Features

Payment Methods

All plugins support:

• Credit/Debit Cards: Visa, Mastercard, Amex, JCB
• Internet Banking: All major Thai banks
• Mobile Banking: QR code payments
• E-Wallets: TrueMoney, LINE Pay, ShopeePay
• Installments: 0% installment plans

Order Management

• Automatic order status updates
• Payment confirmation sync
• Failed payment handling
• Partial and full refunds
• Order notes and history

Security Features

• 3D Secure authentication
• Fraud detection
• SSL/TLS encryption
• PCI-DSS compliance
• Secure tokenization

Multi-Currency

• Accept multiple currencies
• Automatic conversion
• Display in local currency
• Settlement in THB or USD

Testing

• Test mode for development
• Test payment methods
• Sandbox environment
• Production switcher

Installation Overview

Typical Installation Steps

1. Download/Install Plugin

   • From platform marketplace
   • Via composer/package manager
   • Or manual upload

2. Activate Plugin

   • Enable in admin panel
   • Accept permissions
   • Verify installation

3. Configure Credentials

   • Add public key
   • Add secret key
   • Set environment (test/live)
   • Configure webhook URL

4. Select Payment Methods

   • Enable desired methods
   • Configure method settings
   • Set payment preferences
   • Customize display options

5. Test Integration

   • Run test transactions
   • Verify order updates
   • Test refund process
   • Check webhook delivery

6. Go Live

   • Switch to live keys
   • Enable live mode
   • Monitor first transactions
   • Verify settlements

Payment Method Configuration

Standard Configuration

Card Payments:

✓ Enable credit/debit cards
✓ Enable 3D Secure
✓ Set capture mode (auto/manual)
✓ Configure declined card handling

Internet Banking:

✓ Enable internet banking
✓ Select banks to support
✓ Set callback URLs
✓ Configure timeout settings

E-Wallets:

✓ Enable TrueMoney Wallet
✓ Enable Rabbit LINE Pay
✓ Enable ShopeePay
✓ Configure redirect URLs

Installments:

✓ Enable installment plans
✓ Set minimum amount
✓ Configure term lengths (3/6/10 months)
✓ Set merchant absorbs interest

Advanced Options

Payment Capture:
- Automatic (recommended)
- Manual (for pre-orders/custom flow)

Failed Payments:
- Retry automatically
- Show error message
- Allow method change
- Send notification

Order Status Mapping:
- Pending → Processing
- Authorized → On Hold
- Captured → Processing
- Failed → Failed

Webhook Configuration

Webhooks ensure order status stays synchronized:

Webhook URL Format

Platform-specific examples:

Shopify:
https://yourstore.myshopify.com/webhooks/omise

Magento:
https://yourstore.com/omise/webhook/callback

PrestaShop:
https://yourstore.com/module/omise/webhook

OpenCart:
https://yourstore.com/index.php?route=extension/payment/omise/callback

EC-CUBE:
https://yourstore.com/shopping/omise_webhook

Wix:
Configured automatically

Webhook Events

Important events to handle:

• charge.complete - Payment successful
• charge.failed - Payment failed
• refund.create - Refund processed
• transfer.create - Settlement created

Testing Webhooks

# Test webhook with curl
curl -X POST https://yourstore.com/webhook-url \
  -H "Content-Type: application/json" \
  -d '{
    "key": "charge.complete",
    "data": {
      "object": "charge",
      "id": "chrg_test_xxx",
      "status": "successful"
    }
  }'

Refund Processing

Automatic Refunds

Most plugins support refunds through admin panel:

1. Navigate to order
2. Click "Refund" button
3. Enter refund amount
4. Add refund reason
5. Submit refund
6. Automatic processing via Omise

Refund Types:

• Full Refund: Entire order amount
• Partial Refund: Specific amount
• Item Refund: Specific line items

Refund Limitations

Card Payments:
- Available within 120 days
- Processed within 7-14 days
- Full or partial amounts

Internet Banking:
- Not refundable
- Issue manual refund if needed

E-Wallets:
- Varies by provider
- Check specific limitations
- Usually within 30 days

Multi-Store Setup

For merchants with multiple stores:

Configuration Strategies

Separate API Keys:

Store 1 (Thailand):
- Public Key: pkey_live_xxx1
- Secret Key: skey_live_xxx1
- Currency: THB

Store 2 (Singapore):
- Public Key: pkey_live_xxx2
- Secret Key: skey_live_xxx2
- Currency: SGD

Shared Configuration:

Both stores share:
✓ Omise account
✓ Payment methods
✓ Dashboard access
✓ Settlement account

Different per store:
✓ Currency
✓ Language
✓ Local payment methods
✓ Tax handling

Testing Best Practices

Test Checklist

Before Going Live:

Payment Testing:
□ Test successful card payment
□ Test failed card payment
□ Test 3D Secure flow
□ Test internet banking
□ Test e-wallet payment
□ Test installment payment

Order Flow:
□ Verify order status updates
□ Check email notifications
□ Test inventory deduction
□ Verify customer account updates

Refunds:
□ Test full refund
□ Test partial refund
□ Verify refund notification
□ Check order status after refund

Edge Cases:
□ Test payment timeout
□ Test network failure
□ Test webhook retry
□ Test duplicate payments

Test Cards

Successful Payment:
Card: 4242 4242 4242 4242
Expiry: Any future date
CVV: Any 3 digits
Name: Any name

Failed Payment:
Card: 4000 0000 0000 0002

3D Secure Enrollment Failure:
Card: 4111 1111 1115 0002 (Visa)

3D Secure Authentication Failure:
Card: 4111 1111 1114 0003 (Visa)

Troubleshooting Common Issues

Issue: Payment not processing

Possible Causes:

• Invalid API keys
• Incorrect environment (test vs live)
• Payment method not enabled
• Currency mismatch

Solutions:

1. Verify API keys are correct
2. Check test/live mode setting
3. Confirm payment methods enabled in Omise account
4. Ensure currency supported

Issue: Order status not updating

Possible Causes:

• Webhook not configured
• Firewall blocking webhooks
• Incorrect webhook URL
• SSL certificate issues

Solutions:

1. Check webhook URL in dashboard
2. Verify server accepts POST requests
3. Test webhook manually
4. Check server logs

Issue: Refunds failing

Possible Causes:

• Payment method doesn't support refunds
• Refund window expired
• Insufficient settlement balance
• Invalid refund amount

Solutions:

1. Check payment method refund support
2. Verify refund timeline
3. Contact support for balance issues
4. Ensure amount is valid

Issue: 3D Secure not working

Possible Causes:

• 3D Secure disabled
• Browser blocking popup
• Incorrect redirect URLs
• Card doesn't support 3D Secure

Solutions:

1. Enable 3D Secure in settings
2. Allow popups from payment domain
3. Configure return URLs
4. Test with 3D Secure card

Performance Optimization

Checkout Speed

Optimize Plugin:

✓ Enable page caching
✓ Minimize JavaScript
✓ Optimize images
✓ Use CDN for assets
✓ Enable compression

Reduce Redirects:

✓ Use embedded forms when possible
✓ Minimize external redirects
✓ Optimize webhook processing
✓ Cache configuration settings

Payment Success Rate

Increase Success:

✓ Enable multiple payment methods
✓ Support all major cards
✓ Enable 3D Secure
✓ Provide clear error messages
✓ Allow easy retry
✓ Optimize mobile experience

Security Best Practices

API Key Management

✓ Never commit keys to source control
✓ Use environment variables
✓ Rotate keys periodically
✓ Different keys for test/live
✓ Limit key access
✓ Monitor key usage

Server Security

✓ Use HTTPS only
✓ Keep platform updated
✓ Use latest plugin version
✓ Enable firewall
✓ Regular security audits
✓ Monitor for suspicious activity

PCI Compliance

✓ Never store card data
✓ Use Omise.js for card collection
✓ Implement CSP headers
✓ Regular vulnerability scans
✓ Maintain security logs
✓ Follow platform security guidelines

Migration from Other Gateways

Migration Steps

1. Install Omise Plugin

   • Keep existing gateway active
   • Install Omise in test mode
   • Configure settings

2. Test Thoroughly

   • Run test transactions
   • Verify order flow
   • Test refunds
   • Check reporting

3. Prepare Customers

   • Announce new payment options
   • Update help documentation
   • Prepare support team
   • Create FAQs

4. Switch Over

   • Enable Omise in live mode
   • Disable old gateway
   • Monitor first transactions
   • Be ready to rollback

5. Clean Up

   • Remove old gateway after grace period
   • Update documentation
   • Archive old transaction data
   • Review and optimize

Support and Resources

Getting Help

Plugin-Specific:

• Platform-specific documentation
• GitHub repositories
• Issue trackers
• Community forums

General Support:

• Email: support@omise.co
• Dashboard: In-app support chat
• Documentation: docs.omise.co
• Status page: status.omise.co

Useful Resources

Documentation:

• Plugin GitHub Repos
• API Documentation
• Testing Guide
• Security Guide

Platform Guides:

• Shopify Documentation
• Magento Documentation
• PrestaShop Documentation
• OpenCart Documentation
• EC-CUBE Documentation
• Wix Documentation

FAQ

Do I need coding knowledge to use these plugins?

No, all plugins are designed for non-technical users. Installation and configuration are done through your platform's admin panel.

Can I use one Omise account for multiple stores?

Yes, you can use the same Omise account across multiple stores. Each store can have its own configuration.

How long does setup take?

Most plugins can be set up in 10-20 minutes, including testing. Going live takes just a few more minutes.

What if my platform isn't listed?

For platforms not listed, you can use Payment Links or implement using the Omise API.

Are plugins free?

Yes, all Omise plugins are free. You only pay standard Omise transaction fees.

Can I accept international cards?

Yes, all plugins support international credit and debit cards.

Do plugins support refunds?

Yes, most plugins support full and partial refunds through your platform's admin panel.

How do I switch from test to live mode?

Simply replace test API keys with live API keys in the plugin settings and toggle the environment setting.

Will the plugin slow down my store?

No, plugins are optimized for performance and don't impact store speed significantly.

Can I customize the checkout page?

Customization options vary by platform. Some allow styling through CSS, others through platform themes.

What happens if a payment fails?

The customer sees an error message and can retry. The order remains in pending status. You're notified of failed payments.

Do I need a special hosting plan?

No, plugins work with standard hosting plans. You only need HTTPS (SSL certificate) which most hosts provide free.

Next Steps

Choose your platform and get started:

1. Shopify Plugin →
2. Magento Plugin →
3. PrestaShop Plugin →
4. OpenCart Plugin →
5. EC-CUBE Plugin →
6. Wix Integration →

---

Need help? Contact our support team at support@omise.co or visit the Help Center.