为泰国网络商店设置 WooCommerce 支付网关

在泰国经营网络商店时，选择正确的支付网关是您最关键的决策之一。您的客户需要能够方便地付款 — 无论是通过信用卡、QR Promptpay 还是银行转账 — 同时您的商店必须足够安全以保护持卡人数据。本指南将带您了解泰国 WooCommerce 的所有支付选项，并提供每种方式的逐步设置说明。

什么是支付网关？

支付网关是一项服务，用于在您的 WooCommerce 商店、客户银行和商户账户之间安全传输支付信息。它对敏感的卡片数据进行加密，确保您和 WooCommerce 都不会存储原始卡号 — 这是 PCI DSS 合规性的关键要求。

支付流程如下：

1. 客户在您的 WooCommerce 结账页面点击"下单"
2. WooCommerce 将交易数据发送给支付网关（例如 Omise 或 Stripe）
3. 网关向卡组织（Visa/Mastercard）和发卡行进行验证
4. 批准或拒绝结果实时返回给 WooCommerce
5. WooCommerce 更新订单状态（处理中或失败）

泰国 WooCommerce 商店可用的支付网关

选项一：Omise — 泰国商店首选

Omise（现为 SYNQA 旗下）是泰国最具开发者友好性的支付网关，完整支持泰国银行卡、QR Promptpay 集成，并与 WooCommerce 高度兼容。它是大多数泰国网络商店的首选。

第一步：创建 Omise 账户

1. 访问 dashboard.omise.co 并注册免费账户
2. 验证您的电子邮件地址并完成 KYC（了解您的客户）流程
3. 提供您的泰国银行账户信息用于收款
4. 等待账户激活（通常需要 1–3 个工作日）

第二步：安装 Omise WooCommerce 插件

1. 进入 WordPress 后台 → 插件 → 安装插件
2. 搜索 "Omise"，并在官方"Omise for WooCommerce"插件上点击 立即安装
3. 点击 启用

第三步：输入您的 API 密钥

1. 进入 WooCommerce → 设置 → 支付
2. 点击 Omise 旁边的 "管理"
3. 登录您的 Omise 后台，导航到 设置 → API 密钥
4. 复制您的 公钥 和 私钥 — 包括测试版和正式版
5. 将密钥粘贴到 WooCommerce 插件设置中的对应字段
6. 初始设置时，启用 测试模式（使用测试密钥，不会产生真实扣款）
7. 点击 保存更改

第四步：启用特定支付方式

在 Omise 设置中，您可以启用或禁用各个支付方式：

• 信用卡/借记卡 — Visa、Mastercard、JCB
• PromptPay（QR 码） — 客户在银行 App 中扫码
• TrueMoney 钱包 — 泰国流行数字钱包
• 分期付款 — 通过 KBank、SCB 等提供 3–36 个月分期

启用您想要的每种方式，配置显示名称和说明，然后保存。

第五步：切换到正式模式

完成沙盒测试并确认订单流程正常后：

1. 返回 WooCommerce → 设置 → 支付 → Omise → 管理
2. 取消勾选 测试模式
3. 确认您的正式公钥和正式私钥已正确输入
4. 点击 保存更改

选项二：Stripe — 最适合国际销售

Stripe 支持超过 135 种货币和支付方式，包括 Apple Pay 和 Google Pay，是向泰国以外客户销售的最佳选择。

在 WooCommerce 上设置 Stripe

1. 进入 插件 → 安装插件，搜索 "WooCommerce Stripe Payment Gateway"（由 WooCommerce 提供）
2. 安装并启用插件
3. 进入 WooCommerce → 设置 → 支付 → Stripe → 管理
4. 点击 "连接 Stripe"，登录或创建 Stripe 账户
5. 授权 WooCommerce 访问您的 Stripe 账户
6. 启用 测试模式，使用 Stripe 测试卡 4242 4242 4242 4242 进行测试支付
7. 测试完成后，禁用测试模式即可上线

选项三：QR Promptpay — 泰国客户零成本

QR Promptpay 是泰国消费者最受欢迎的支付方式，因为它免费、即时，并兼容所有主要泰国银行 App（KBank、SCB、曼谷银行、Krungsri、TTB 等）。

将 QR Promptpay 添加到 WooCommerce 有两种方式：

方法 A：通过 Omise 插件

如果您已经设置了 Omise，只需在 Omise 插件设置中启用"PromptPay"即可。Omise 会自动处理 QR 码生成和支付确认。通过 Omise 的手续费约为每笔交易 0.5%。

方法 B：通过银行 API（免费）

KBank（KAPI）和 SCB（SCB Easy API）都为在这些银行开设企业账户的商家提供免费的 Promptpay QR API。开发人员可以使用自定义插件或现有社区插件将 API 集成到您的 WooCommerce 结账中。此方法无交易手续费，但需要技术设置。

选项四：货到付款和银行转账（WooCommerce 内置）

WooCommerce 内置了两种离线支付方式 — 无需额外插件。

货到付款（COD）

1. 进入 WooCommerce → 设置 → 支付
2. 找到 货到付款，点击 管理
3. 启用它，设置标题（例如"送货时付款"），并为客户编写说明
4. 可选择仅限特定配送方式使用货到付款
5. 点击 保存更改

银行转账（BACS）

1. 进入 WooCommerce → 设置 → 支付 → 直接银行转账 → 管理
2. 启用该方式并输入您的银行账户信息：

Account Name:    [您的企业名称]
Bank Name:       [例如 Kasikorn Bank (KBank)]
Account Number:  [您的账户号码]
Sort Code:       [分行代码 — 如不适用则留空]
IBAN:            [泰国账户留空]
BIC/Swift:       [例如 KBank 的 KASITHBK]

添加付款说明，告知客户在转账备注中注明订单号，并上传付款凭证。

为支付网关配置 Webhook

Webhook 是支付网关在事件发生时（例如支付成功、交易失败或退款）向您的 WooCommerce 商店发送的实时 HTTP 通知。如果没有正确配置 Webhook，WooCommerce 将无法在网关确认付款后自动更新订单状态。

设置 Omise Webhook

1. 登录您的 Omise 后台，进入 设置 → Webhooks
2. 点击 添加 Webhook 端点
3. 输入您的端点 URL：https://yourdomain.com/?wc-api=omise
4. 选择要监听的事件：charge.complete、charge.failed、refund.create
5. 保存后使用 发送测试事件 按钮验证您的端点是否收到通知

设置 Stripe Webhook

1. 登录 Stripe 后台，导航到 开发者 → Webhooks
2. 点击 添加端点
3. 输入端点 URL：https://yourdomain.com/?wc-api=stripe
4. 选择事件：payment_intent.succeeded、payment_intent.payment_failed、charge.refunded
5. 复制 Webhook 签名密钥，并将其粘贴到 WooCommerce Stripe 设置的 Webhook 密钥字段中

泰国商店支付网关费用对比

交易手续费直接影响您的利润率。了解每种支付方式的真实成本，有助于您根据客户群和订单量选择最合适的网关组合。

对于大多数泰国中小型商店，从 Omise + 银行转账 + 货到付款 开始，即可以低成本覆盖几乎所有泰国客户。待国际销售增长后再添加 Stripe。

排查常见 WooCommerce 支付问题

WooCommerce 中大多数支付问题可归结为三个根本原因：API 密钥错误、Webhook 配置不当或 SSL 问题。以下是诊断每种情况的系统方法。

订单停留在待付款状态

这几乎总是 Webhook 问题。客户的银行卡已被扣款，但 WooCommerce 从未收到确认事件。检查以下内容：

• Webhook URL 是否已在网关后台正确输入 — 必须是 WooCommerce 期望的确切 URL
• 没有防火墙或安全插件在阻止来自网关 IP 段的 POST 请求
• 查看 WooCommerce → 状态 → 日志 中与网关相关的错误信息

正式模式下支付被拒绝

请确认您在支付插件设置中已输入 正式 API 密钥（而非测试密钥）。测试密钥只接受测试卡号 — 任何真实卡片都会被拒绝。还需确认您的商户账户已被网关提供商完全激活。

结账页面加载缓慢

WooCommerce 结账会为每种激活的支付方式加载 JavaScript。如果您安装了许多支付插件但部分已禁用，请完全停用这些插件（不仅仅是在 WooCommerce 设置中），以避免加载不必要的脚本。使用与 WooCommerce 兼容的缓存插件，如 LiteSpeed Cache 或 WP Rocket，并正确配置购物车和结账页面的排除规则。

# WooCommerce 常用 wp-config.php 性能常量：
define('WP_CACHE', true);
define('WOOCOMMERCE_CHECKOUT', true);

# 确保结账和购物车页面被排除在整页缓存之外。
# 这可防止过时的会话数据破坏结账流程。

结账时出现混合内容警告

如果启用 SSL 后仍有资源（图片、CSS 或脚本）通过 HTTP 加载，请安装 Really Simple SSL 插件。它会自动将数据库和文章内容中的所有 HTTP 引用重写为 HTTPS。激活后，运行 WooCommerce → 状态 → 工具 → 更新数据库 以更新已存储的 URL。

沙盒测试清单

SSL 和 PCI DSS — 不可妥协的要求

PCI DSS（支付卡行业数据安全标准）是 Visa 和 Mastercard 对任何处理银行卡支付的商家的要求。对于使用 Omise 或 Stripe 等托管网关的 WooCommerce 商店（银行卡数据直接发送到网关服务器，永远不经过您的服务器），您可以达到最简单的合规级别：SAQ-A（自我评估问卷 A）。

WooCommerce SSL 检查清单

• 您的域名必须有有效的 SSL 证书（浏览器中显示锁标）
• WordPress 网站地址必须以 https:// 开头 — 在 设置 → 常规 中设置
• 必须启用 WooCommerce 强制安全结账 — 在 WooCommerce → 设置 → 高级 → 强制安全结账 中设置
• 无混合内容 — 所有图片、CSS 和 JS 通过 HTTPS 加载，而非 HTTP
• 使用 Really Simple SSL 插件自动修复混合内容问题

选择合适的支付网关

常见支付问题排查

• 正式模式下支付无法处理 — 仔细检查是否已将测试 API 密钥切换为正式 API 密钥
• Omise 后台出现 Webhook 错误 — 确认您的 Webhook URL 设置为 https://yourdomain.com/?wc-api=omise
• WooCommerce 未收到支付确认 — 确保 Webhook 端点未被防火墙或安全插件拦截（在主机防火墙白名单中添加 Omise/Stripe IP）
• 结账时出现混合内容警告 — 安装 Really Simple SSL 并确认所有资源通过 HTTPS 加载
• 3DS 身份验证循环 — 升级到最新版本的支付网关插件