Setting Up Payment Gateways on WooCommerce for Thai Online Stores

When running an online store in Thailand, choosing the right payment gateway is one of the most critical decisions you'll make. Your customers need to be able to pay conveniently — whether by credit card, QR Promptpay, or bank transfer — and your store must be secure enough to protect cardholder data. This guide walks you through every payment option available for WooCommerce in Thailand, with step-by-step setup instructions for each.

What Is a Payment Gateway?

A payment gateway is a service that securely transmits payment information between your WooCommerce store, the customer's bank, and your merchant account. It encrypts sensitive card data so that neither you nor WooCommerce ever stores raw card numbers — a key PCI DSS compliance requirement.

The payment flow works like this:

1. Customer clicks "Place Order" on your WooCommerce checkout page
2. WooCommerce sends transaction data to the payment gateway (e.g., Omise or Stripe)
3. The gateway verifies with the card network (Visa/Mastercard) and the issuing bank
4. Approval or decline is returned to WooCommerce in real time
5. WooCommerce updates the order status (Processing or Failed)

Payment Gateways Available for Thai WooCommerce Stores

Option 1: Omise — Recommended for Thai Stores

Omise (now part of SYNQA) is the most developer-friendly payment gateway in Thailand with full Thai card support, QR Promptpay integration, and excellent WooCommerce compatibility. It is the go-to choice for most Thai online stores.

Step 1: Create an Omise Account

1. Go to dashboard.omise.co and sign up for a free account
2. Verify your email address and complete the KYC (Know Your Customer) process
3. Provide your Thai bank account details for payouts
4. Wait for account activation (typically 1–3 business days)

Step 2: Install the Omise WooCommerce Plugin

1. Go to WordPress Dashboard → Plugins → Add New
2. Search for "Omise" and click Install Now on the official "Omise for WooCommerce" plugin
3. Click Activate

Step 3: Enter Your API Keys

1. Go to WooCommerce → Settings → Payments
2. Click "Manage" next to Omise
3. Log in to your Omise Dashboard and navigate to Settings → API Keys
4. Copy your Public Key and Secret Key — both Test and Live versions
5. Paste the keys into the corresponding fields in the WooCommerce plugin settings
6. For initial setup, enable Test Mode (uses test keys so no real charges occur)
7. Click Save Changes

Step 4: Enable Specific Payment Methods

Within Omise settings, you can enable or disable individual payment methods:

• Credit/Debit Card — Visa, Mastercard, JCB
• PromptPay (QR Code) — customer scans QR in their banking app
• TrueMoney Wallet — popular digital wallet in Thailand
• Installment Plans — 3–36 month installments via KBank, SCB, etc.

Enable each method you want, configure display names and descriptions, then save.

Step 5: Switch to Live Mode

Once you have completed sandbox testing and confirmed orders flow correctly:

1. Return to WooCommerce → Settings → Payments → Omise → Manage
2. Uncheck Test Mode
3. Confirm your Live Public Key and Live Secret Key are correctly entered
4. Click Save Changes

Option 2: Stripe — Best for International Sales

Stripe supports over 135 currencies and payment methods including Apple Pay and Google Pay, making it the best choice if you sell to customers outside Thailand.

Setting Up Stripe on WooCommerce

1. Go to Plugins → Add New and search for "WooCommerce Stripe Payment Gateway" (by WooCommerce)
2. Install and activate the plugin
3. Go to WooCommerce → Settings → Payments → Stripe → Manage
4. Click "Connect with Stripe" and sign in or create a Stripe account
5. Authorize WooCommerce to access your Stripe account
6. Enable Test Mode and run test payments using Stripe's test card 4242 4242 4242 4242
7. Once testing is complete, disable Test Mode to go live

Option 3: QR Promptpay — Zero Cost for Thai Customers

QR Promptpay is the most popular payment method among Thai consumers because it is free, instant, and works with every major Thai banking app (KBank, SCB, Bangkok Bank, Krungsri, TTB, etc.).

There are two ways to add QR Promptpay to WooCommerce:

Method A: Via Omise Plugin

If you already have Omise set up, simply enable "PromptPay" within the Omise plugin settings. Omise handles the QR generation and payment confirmation automatically. The fee is approximately 0.5% per transaction via Omise.

Method B: Via Bank APIs (Free)

Both KBank (KAPI) and SCB (SCB Easy API) offer free Promptpay QR APIs for businesses with business accounts at those banks. A developer would integrate the API into your WooCommerce checkout using a custom plugin or existing community-built plugins. This method has zero transaction fees but requires technical setup.

Option 4: COD and Bank Transfer (Built-in WooCommerce)

WooCommerce includes two offline payment methods out of the box — no extra plugin needed.

Cash on Delivery (COD)

1. Go to WooCommerce → Settings → Payments
2. Find Cash on Delivery and click Manage
3. Enable it, set the title (e.g., "Pay on Delivery"), and write instructions for customers
4. Optionally restrict COD to specific shipping methods only
5. Click Save Changes

Bank Transfer (BACS)

1. Go to WooCommerce → Settings → Payments → Direct Bank Transfer → Manage
2. Enable the method and enter your bank account details:

Account Name:    [Your Business Name]
Bank Name:       [e.g., Kasikorn Bank (KBank)]
Account Number:  [Your account number]
Sort Code:       [Branch code — leave blank if not applicable]
IBAN:            [Leave blank for Thai accounts]
BIC/Swift:       [e.g., KASITHBK for KBank]

Add payment instructions telling customers to include the order number in the transfer reference and to upload proof of payment.

Webhook Configuration for Payment Gateways

A webhook is a real-time HTTP notification that your payment gateway sends to your WooCommerce store when an event occurs — such as a successful payment, failed transaction, or refund. Without properly configured webhooks, WooCommerce will not automatically update the order status after a payment is confirmed by the gateway.

Setting Up Omise Webhooks

1. Log in to your Omise Dashboard and go to Settings → Webhooks
2. Click Add Webhook Endpoint
3. Enter your endpoint URL: https://yourdomain.com/?wc-api=omise
4. Select the events to listen for: charge.complete, charge.failed, refund.create
5. Save and use the Send Test Event button to verify your endpoint receives the notification

Setting Up Stripe Webhooks

1. Log in to the Stripe Dashboard and navigate to Developers → Webhooks
2. Click Add Endpoint
3. Enter the endpoint URL: https://yourdomain.com/?wc-api=stripe
4. Select events: payment_intent.succeeded, payment_intent.payment_failed, charge.refunded
5. Copy the Webhook Signing Secret and paste it into WooCommerce Stripe Settings under the Webhook Secret field

Comparing Payment Gateway Fees for Thai Stores

Transaction fees directly affect your profit margin. Understanding the true cost per payment method helps you choose the right gateway mix for your customer base and order volume.

For most Thai small-to-medium stores, starting with Omise + Bank Transfer + COD covers nearly all Thai customers at low cost. Add Stripe once you see international sales growing.

Troubleshooting Common WooCommerce Payment Issues

Most payment issues in WooCommerce fall into three root causes: incorrect API keys, webhook misconfiguration, or SSL problems. Here is a systematic approach to diagnosing each.

Order Stuck in Pending Payment

This is almost always a webhook problem. The customer's card was charged but WooCommerce never received the confirmation event. Check:

• Webhook URL is correctly entered in your gateway dashboard — it must be the exact URL WooCommerce expects
• No firewall or security plugin is blocking POST requests from the gateway's IP range
• Check WooCommerce → Status → Logs for gateway-related error messages

Payment Declined in Live Mode

Verify you have entered your Live API Keys (not Test Keys) in the payment plugin settings. Test keys only accept test card numbers — they will decline any real card. Also confirm your merchant account has been fully activated by the gateway provider.

Checkout Page Loads Slowly

WooCommerce checkout loads JavaScript for every active payment method. If you have many payment plugins installed but some are disabled, deactivate the plugins entirely (not just in WooCommerce settings) so they don't enqueue unnecessary scripts. Use a WooCommerce-compatible cache plugin such as LiteSpeed Cache or WP Rocket with cart and checkout page exclusions correctly configured.

# Common wp-config.php performance constants for WooCommerce:
define('WP_CACHE', true);
define('WOOCOMMERCE_CHECKOUT', true);

# Ensure checkout and cart pages are excluded from full-page caching.
# This prevents stale session data from breaking the checkout flow.

Mixed Content Warnings on Checkout

If some resources (images, CSS, or scripts) still load over HTTP after enabling SSL, install the Really Simple SSL plugin. It automatically rewrites all HTTP references in your database and post content to HTTPS. After activation, run WooCommerce → Status → Tools → Update Database to update stored URLs.

Sandbox Testing Checklist

SSL and PCI DSS — Non-Negotiable Requirements

PCI DSS (Payment Card Industry Data Security Standard) compliance is required by Visa and Mastercard for any business that processes card payments. For WooCommerce stores using a hosted gateway like Omise or Stripe (where card data goes directly to the gateway's servers, never yours), you qualify for the simplest compliance level: SAQ-A (Self-Assessment Questionnaire A).

SSL Checklist for WooCommerce

• Your domain must have an active SSL certificate (shown as padlock in browser)
• WordPress Site Address must start with https:// — set in Settings → General
• WooCommerce Forces Secure Checkout must be enabled — set in WooCommerce → Settings → Advanced → Force secure checkout
• No mixed content — all images, CSS, and JS loaded over HTTPS, not HTTP
• Use the Really Simple SSL plugin to fix mixed content issues automatically

Choosing the Right Payment Gateway

Troubleshooting Common Payment Issues

• Payments not processing in Live Mode — Double-check that you switched from Test API keys to Live API keys
• Webhook errors in Omise dashboard — Verify your webhook URL is set to https://yourdomain.com/?wc-api=omise
• WooCommerce not receiving payment confirmation — Ensure the webhook endpoint is not blocked by your firewall or security plugin (add Omise/Stripe IPs to the whitelist in your hosting firewall)
• Mixed content warning on checkout — Install Really Simple SSL and check all resources load over HTTPS
• 3DS authentication loop — Upgrade to the latest version of your payment gateway plugin