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

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

Frequently Asked Questions

Q: Do I need coding knowledge to use these plugins?
A: No, all plugins are designed for non-technical users. Installation and configuration are done through your platform's admin panel.

Q: Can I use one Omise account for multiple stores?
A: Yes, you can use the same Omise account across multiple stores. Each store can have its own configuration.

Q: How long does setup take?
A: Most plugins can be set up in 10-20 minutes, including testing. Going live takes just a few more minutes.

Q: What if my platform isn't listed?
A: For platforms not listed, you can use Payment Links or implement using the Omise API.

Q: Are plugins free?
A: Yes, all Omise plugins are free. You only pay standard Omise transaction fees.

Q: Can I accept international cards?
A: Yes, all plugins support international credit and debit cards.

Q: Do plugins support refunds?
A: Yes, most plugins support full and partial refunds through your platform's admin panel.

Q: How do I switch from test to live mode?
A: Simply replace test API keys with live API keys in the plugin settings and toggle the environment setting.

Q: Will the plugin slow down my store?
A: No, plugins are optimized for performance and don't impact store speed significantly.

Q: Can I customize the checkout page?
A: Customization options vary by platform. Some allow styling through CSS, others through platform themes.

Q: What happens if a payment fails?
A: The customer sees an error message and can retry. The order remains in pending status. You're notified of failed payments.

Q: Do I need a special hosting plan?
A: 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.