• 信用卡/借记卡 - 支持 3D Secure 验证
• Alipay - 支付宝国际版
• WeChat Pay - 微信支付国际版
• Stripe Link - Stripe 快速支付方式

• ✅ 完整的支付流程处理
• ✅ 3D Secure 验证支持
• ✅ 退款功能（全额和部分退款）
• ✅ Webhook 事件监听（5 个关键事件）
• ✅ 支付记录管理
• ✅ 多货币支持
• ✅ 灵活的手续费配置
• ✅ 后台管理界面
• ✅ 安全的密钥管理

1. charge.succeeded - 费用成功
2. charge.refunded - 费用已退款
3. checkout.session.completed - 结账会话完成
4. payment_intent.payment_failed - 支付意图失败
5. payment_intent.succeeded - 支付意图成功

# 将插件文件夹上传到 WordPress 插件目录
/wp-content/plugins/stripe-wp-gateway/

• 进入 WordPress 后台 → 插件
• 找到 "Stripe WordPress Payment Gateway"
• 点击 "激活"

• 进入 WooCommerce → 设置 → 支付
• 找到 "Stripe Payment Gateway"
• 点击 "管理" 进行配置

1. 登录 Stripe Dashboard
   • 访问 https://dashboard.stripe.com
   • 使用您的 Stripe 账户登录
2. 获取 API 密钥
   • 进入 Developers → API Keys
   • 复制 Secret Key (sk_live_... )
   • 复制 Publishable Key (pk_live_...)
3. 配置 Webhook
   • 进入 Developers → Webhooks
   • 点击 "Add endpoint"
   • 输入 Webhook URL：https://yoursite.com/wp-json/stripe-wp-gateway/v1/webhook
   • 选择事件：
     • charge.succeeded
     • charge.refunded
     • checkout.session.completed
     • payment_intent.payment_failed
     • payment_intent.succeeded
   • 复制 Signing Secret (whsec_... )

CREATE TABLE stripe_payments (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    order_id BIGINT NOT NULL,
    stripe_charge_id VARCHAR(255) UNIQUE NOT NULL,
    stripe_payment_intent_id VARCHAR(255),
    amount DECIMAL(10, 2) NOT NULL,
    currency VARCHAR(3) NOT NULL,
    payment_method VARCHAR(50),
    status VARCHAR(50),
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

CREATE TABLE stripe_refunds (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    payment_id BIGINT NOT NULL,
    order_id BIGINT NOT NULL,
    stripe_refund_id VARCHAR(255) UNIQUE NOT NULL,
    amount DECIMAL(10, 2) NOT NULL,
    reason VARCHAR(255),
    status VARCHAR(50),
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE stripe_webhook_logs (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    event_id VARCHAR(255) UNIQUE NOT NULL,
    event_type VARCHAR(100),
    payload LONGTEXT,
    status VARCHAR(50),
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

1. 用户选择支付方式（卡片、Alipay、WeChat Pay 或 Stripe Link）
2. 用户填写必要信息
3. 点击 "下单" 按钮
4. 前端创建 Payment Intent
5. 根据支付方式确认支付
6. 支付成功后提交订单

1. 接收支付数据
2. 验证 Payment Intent 状态
3. 标记订单为已支付
4. 保存支付记录
5. 清空购物车
6. 返回成功页面

1. Stripe 发送 Webhook 事件
2. 验证 Webhook 签名
3. 记录 Webhook 日志
4. 根据事件类型处理
5. 更新订单和支付记录状态
6. 发送通知

1. 进入 WooCommerce 订单详情
2. 在订单项目中点击 "退款"
3. 系统自动处理 Stripe 退款
4. 订单状态更新为已退款

1. 进入 WooCommerce 订单详情
2. 输入退款金额
3. 点击 "退款"
4. 系统处理部分退款
5. 订单状态相应更新

• 所有 API 密钥存储在 WordPress 选项表中
• 密钥字段使用密码输入类型
• 建议使用环境变量存储敏感信息

• 所有 Webhook 请求都经过签名验证
• 使用 Stripe 提供的签名验证方法
• 防止伪造的 Webhook 请求

• 支付数据不存储在本地
• 所有交易通过 Stripe 加密传输
• 遵守 PCI DSS 合规性要求

• 检查 Stripe 密钥是否正确
• 确保使用的是 Live 密钥（sk_live_ 和 pk_live_）
• 验证密钥是否有效期内

• 检查 Webhook 端点 URL 是否正确
• 验证 Webhook 签名密钥是否正确
• 检查防火墙是否允许 Stripe IP 地址
• 查看 Stripe Dashboard 中的 Webhook 日志

• 检查订单金额是否正确
• 验证货币设置是否与 Stripe 账户一致
• 查看 Stripe Dashboard 中的交易日志
• 检查 3D Secure 验证是否启用

• 确保订单已支付
• 检查退款金额是否不超过原交易金额
• 验证 Stripe 账户是否有退款权限
• 查看 Stripe Dashboard 中的退款日志

• 表名：wp_stripe_payments
• 查询：SELECT * FROM wp_stripe_payments WHERE order_id = {order_id}

• 表名：wp_stripe_refunds
• 查询：SELECT * FROM wp_stripe_refunds WHERE order_id = {order_id}

• 表名：wp_stripe_webhook_logs
• 查询：SELECT * FROM wp_stripe_webhook_logs ORDER BY created_at DESC LIMIT 100

do_action('stripe_wp_gateway_charge_succeeded', $order, $charge);
do_action('stripe_wp_gateway_payment_intent_succeeded', $order, $intent);

do_action('stripe_wp_gateway_payment_intent_failed', $order, $intent);

do_action('stripe_wp_gateway_charge_refunded', $order, $charge);

do_action('stripe_wp_gateway_checkout_completed', $order, $session);

// 在 initPaymentMethods() 函数中添加
html += '<label class="payment-method-option">';
html += '<input type="radio" name="stripe_payment_method" value="new_method" />';
html += '<span class="method-label">New Payment Method</span>';
html += '</label>';

// 在 handleCheckoutSubmit() 函数中添加处理逻辑
} else if (selectedPaymentMethod === 'new_method') {
    result = await handleNewMethod(paymentIntentData.client_secret);
}

1. 查看本文档的故障排除部分
2. 检查 Stripe 官方文档：https://stripe.com/docs
3. 查看 WooCommerce 官方文档：https://woocommerce.com/documentation/
4. 联系插件开发者

• 初始版本发布
• 支持 Alipay、WeChat Pay、Stripe Link
• 3D Secure 验证
• 退款功能
• Webhook 事件监听
• 后台管理界面

VmShell支付插件地址:https://linuxword.com/wp-content/uploads/2026/03/vmshell-stripe-payment-v1.0.0-complete.zip