您现在的位置是：首页 > WordPress教程WordPress教程

WordPress支付网关连接

WP集市 2025-09-09 【WordPress教程】 247人已围观

好了咱今天唠唠WordPress咋整支付网关，这玩意儿说白了就是让你网站能收钱。比如你搞了个电商站，客户点付款总不能让人家线下给你塞现金吧？得接个线上支付通道。WordPress本身不带这功能，得靠插件或者自己写代码钩进去。
先说最简单的路子——用现成插件。WooCommerce是首选，装好后在后台「WooCommerce → Settings → Payments」里就能看到一堆默认网关，比如PayPal、Stripe。直接点启用，填上商户ID、API密钥啥的就行。比方说Stripe的配置界面长这样：

// 这不是真代码，是WooCommerce里勾选Stripe后要填的字段示例
Stripe Settings:
- Enable/Disable: ☑ Check to enable
- Title: Credit Card (Stripe)
- Description: Pay via credit card with Stripe
- Test Mode: ☑ Enable for testing
- Test Publishable Key: pk_test_xxxxxxxx
- Test Secret Key: sk_test_xxxxxxxx

但有时候客户要求用特定支付渠道，比如国内的微信支付或者银联。这时候可能得找第三方插件，比如「Payment Gateway for WeChat on WooCommerce」。安装后往往得配置回调URL，这是支付平台成功收款后通知你网站的地址，一般插件会自动生成，你得复制到支付平台后台去。
要是插件不支持你的需求，就得自己写网关了。先挂个钩子注册自定义支付方式。在主题的functions.php里加这么一段：

add_filter('woocommerce_payment_gateways', 'add_custom_gateway');
function add_custom_gateway($gateways) {
    $gateways[] = 'WC_Custom_Gateway';
    return $gateways;
}

然后得创建这个WC_Custom_Gateway类，继承WooCommerce的基类。最少需要实现process_payment方法处理付款逻辑。比如模拟个结构：

class WC_Custom_Gateway extends WC_Payment_Gateway {
    public function __construct() {
        $this->id = 'custom_gateway';
        $this->has_fields = true;
        $this->method_title = 'Custom Payment';
    }

    public function process_payment($order_id) {
        $order = wc_get_order($order_id);
        // 这里写调用支付API的代码，比如发请求到第三方支付平台
        $api_response = $this->call_gateway_api($order);

        if($api_response['success']) {
            $order->update_status('processing', 'Payment successful via custom gateway');
            return array('result' => 'success', 'redirect' => $this->get_return_url($order));
        } else {
            wc_add_notice('Payment failed: '.$api_response['error'], 'error');
            return null;
        }
    }
}

注意安全！涉及钱的事情必须用SSL证书（HTTPS），尤其是传输卡号等敏感数据时。另外API密钥千万别硬编码在代码里，建议用WordPress的选项系统存储：

$key = get_option('my_gateway_api_key');

测试环节不能少。大部分支付平台提供沙盒模式（Sandbox），用假钱模拟交易。比如PayPal沙盒账号生成器能造虚拟买家和商家，避免真扣款。测试时候记得勾选沙盒模式，并打印日志记录流程：

function log_gateway_response($response) {
    if (WP_DEBUG === true) {
        error_log(print_r($response, true));
    }
}

遇到常见坑：回调验证失败。因为支付平台通知你服务器时可能因为防火墙或URL错误导致收不到通知。这时候得检查服务器IP是否加入支付平台白名单，或者用ngrok等工具把本地环境暴露给公网调试。
最后提一嘴性能。支付网关请求如果同步处理可能超时，尤其是网络慢的时候。可以考虑用队列异步处理，或者前端轮询查询支付状态。比如用Ajax在客户端每隔5秒查一次订单状态：

// 前端代码示例
let checkInterval = setInterval(() => {
    jQuery.get('/check-order-status?order_id=123', function(data) {
        if (data.paid) {
            clearInterval(checkInterval);
            alert('Payment completed!');
        }
    });
}, 5000);