WordPress对接跨境支付接口：从插件安装到交易测试教程
外贸网站离不开安全、稳定的收款能力。
如果你的WordPress站点需要支持海外用户付款，对接跨境支付接口是必经之路。
这篇文章会从零开始，帮你理清准备条件、操作步骤、常见陷阱和验证方法，让你能够独立完成支付网关的接入。
开始前需要准备好这些
在动手之前，请确认你已经具备以下条件：
- 一个已绑定的域名并开启HTTPS：跨境支付平台要求站点必须通过SSL加密通信，否则API无法正常工作。如果你的域名还没有证书，可以在宝塔面板或服务器上申请Let‘s Encrypt免费证书。
- WordPress站点运行正常：推荐使用WooCommerce插件作为商城框架，因为它内置了对大部分支付插件的支持。
- 注册好跨境支付账户：常见的如Stripe、PayPal Business、2Checkout等。本文以Stripe和PayPal为例。注册时通常需要提供企业信息或个人身份验证，做好准备。
安装支付插件并配置核心参数
登录WordPress后台，依次执行以下操作：
- 安装WooCommerce（如果还未安装）：在插件市场搜索WooCommerce，安装并激活。根据向导完成基本设置，包括店铺地址、货币单位（建议选择美元或欧元）等。
- 安装支付网关插件：
- 对接Stripe：搜索“WooCommerce Stripe Payment Gateway”，安装由WooCommerce官方出品的插件。
- 对接PayPal：搜索“WooCommerce PayPal Payments”，安装并激活。
- 配置Stripe：进入WooCommerce > 设置 > 支付，找到Stripe，点击管理。你需要从Stripe Dashboard复制两样东西：
- 可发布密钥（Publishable Key）
- 密钥（Secret Key）
将这两个密钥填入对应字段，并开启“测试模式”（Test Mode）。
测试模式可以让你用虚假卡号模拟交易，避免产生真实费用。
- 配置PayPal：在PayPal插件设置页面，点击“连接”按钮，系统会跳转到PayPal登录并授权。授权完成后，同样建议先开启沙盒模式（Sandbox）。
- 设置默认货币：如果你的主营市场在海外，在WooCommerce > 设置 > 货币选项中，选择目标货币（如USD），并设置汇率（如果插件支持自动获取）。
高频踩坑点和正确做法
即使按步骤操作，新手也容易遇到以下问题：
- 无法显示支付按钮：检查前端页面是否强制使用HTTPS。Google Chrome等浏览器会拦截非安全页面上的支付脚本。
- 测试支付报错“invalid API keys”：先确认复制时没有前后空格，再检查是不是把测试模式和正式模式混合了。测试密钥只能配合测试模式使用。
- 货币显示异常：如果插件选择的是固定汇率，要定期手动更新。建议开启“自动获取每日汇率”功能（Stripe插件自带该选项）。
- 退款流程不熟悉：在正式上线前，建议在测试环境发起一单退款，确认退款状态能同步到WordPress订单备注。Stripe和PayPal后台都可以直接操作退款。
如何验证支付接口已正常工作
完成配置后，务必做一次完整的沙盒测试。
- Stripe测试：在Stripe后台获取测试卡号（如4242424242424242），在前台下单，填写测试卡号、任意未来有效期和任意CVV（如123）。提交支付，观察是否跳转至订单确认页面。
- PayPal测试：使用沙盒买家账号登录，完成支付流程。查看WordPress后台订单详情，状态应变为“处理中”或“已完成”。
- 检查订单记录：在WooCommerce > 订单中，查看新创建的订单，支付方式列应显示对应的支付网关名称，支付状态列应显示“已付款”。
- 关闭测试模式：确认一切正常后，回到插件设置关闭测试模式，开启正式模式。记得将API密钥切换为生产环境密钥。
如果你是第一次操作，建议先在测试模式下完整跑一遍。
遇到异常时，重点检查API密钥是否匹配、HTTPS是否生效、插件版本是否与WooCommerce兼容。
完成这些步骤后，你的WordPress站点就能安全地对接跨境支付接口了。
