首页 > 营销学院 > 技术知识

Stripe 支付初始化失败：403 错误与价格单位配置问题详解

本文解析 stripe 集成中 `payment_init.php` 返回 403 forbidden 的根本原因，指出实际问题并非权限或服务器配置，而是价格单位未按 stripe 要求转换为**最小货币单位（如 huf 分）**，并给出完整修复方案与最佳实践。

在 Stripe 支付集成中，payment_init.php 返回 403 Forbidden 错误常被误判为服务器权限或 .htaccess 限制问题，但结合日志和代码分析可确认：该错误实为 Stripe API 拒绝请求后触发的中间层响应异常，根源在于 Checkout Session 创建时关键参数校验失败——尤其是 line_items[0][price_data][unit_amount] 值不合法。

? 核心问题定位

价格单位未正确转换
Stripe 所有货币金额（包括 HUF）均需以最小货币单位（分/子单位） 提交。例如：
- 6900 HUF → 应传 690000（HUF 最小单位为 1 HUF = 100 fillér，但 Stripe 实际将 HUF 视为无小数货币，即 1 HUF = 1 unit；然而 Stripe 强制要求所有币种统一以整数“分”形式提交，因此 HUF 必须 ×100 → 6900 × 100 = 690000）
- 原代码中虽计算了 $stripeAmount = round($productPrice * 100, 2)，却未在 Session::create() 中使用，仍错误传入 $productPrice（如 6900），导致 Stripe 认为金额过小（远低于 $0.50 USD 等价阈值），直接拒绝。
$request->createCheckoutSession 为空 → JSON 解析失败
前端未正确发送 {"createCheckoutSession": true}，或 file_get_contents('php://input') 读取失败（常见于 Content-Type: application/json 缺失或表单直接 POST）。此时 $request 为 null，!empty($request->createCheckoutSession) 恒为 false，后续逻辑不执行，$productName 自然无法输出。
HUF 货币兼容性风险
Stripe 官方文档明确标注：HUF 尚未完全支持所有支付功能，且 unit_amount 对 HUF 的有效范围实际受限。强烈建议切换为 Stripe 全面支持的币种（如 EUR、USD）进行开发与测试，生产环境再按需适配。

✅ 正确修复方案

1. 修正价格单位与 Session 创建逻辑

// ✅ 正确：使用转换后的整数金额（HUF 需 ×100，且必须为整数）
$stripeAmount = (int) round($productPrice * 100); // 强制整型，避免浮点误差

try {
    $checkout_session = \Stripe\Checkout\Session::create([
        'line_items' => [[
            'price_data' => [
                'currency' => 'huf', // 注意：小写
                'unit_amount' => $stripeAmount, // ✅ 使用转换后金额
                'product_data' => [
                    'name' => $productName,
                    'description' => $description,
                ],
            ],
            'quantity' => 1,
        ]],
        'mode' => 'payment',
        'success_url' => STRIPE_SUCCESS_URL . '?session_id={CHECKOUT_SESSION_ID}',
        'cancel_url' => STRIPE_CANCEL_URL,
    ]);
} catch (\Stripe\Exception\ApiErrorException $e) {
    error_log("Stripe API Error: " . $e->getMessage());
    $api_error = $e->getMessage();
}

2. 增强请求体解析健壮性

// ✅ 替换原 JSON 解析逻辑，兼容表单提交与 JSON 提交
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (isset($_POST['submitService'])) {
        // 表单 POST 场景：直接使用 $_POST
        $request = (object)['createCheckoutSession' => true];
    } else {
        // JSON POST 场景：解析原始输入
        $input = file_get_contents('php://input');
        $request = json_decode($input);
        if (json_last_error() !== JSON_ERROR_NONE) {
            http_response_code(400);
            echo json_encode(['status' => 0, 'error' => ['message' => 'Invalid JSON']]);
            exit;
        }
    }
}

3. 添加必要验证与调试输出

// ✅ 关键字段验证（防止 Stripe 参数缺失错误）
if (empty($productName) || empty($stripeAmount)) {
    http_response_code(400);
    echo json_encode([
        'status' => 0,
        'error' => ['message' => 'Product name or price is missing']
    ]);
    exit;
}

⚠️ 注意事项与最佳实践

403 错误本质：此错误通常由 Web 服务器（如 Apache/Nginx）拦截触发，但根本原因是 Stripe API 返回 400 Bad Request 后，服务器尝试加载自定义 ErrorDocument 时失败。应优先检查 Stripe 日志中的真实错误码（如 parameter_missing），而非仅关注 HTTP 状态码。
HUF 使用警告：Stripe 对 HUF 的支持有限，部分功能（如 automatic tax、certain payment methods）可能不可用。开发阶段推荐使用 eur 并设置 unit_amount 为 6900（即 €69.00），上线前再按需调整。

库版本升级：确保使用最新版 stripe-php（≥12.x），并采用命名空间初始化：

require_once 'vendor/autoload.php'; // Composer 方式引入
\Stripe\Stripe::setApiKey(getenv('STRIPE_SECRET_KEY'));

前端调用示例（JavaScript）：

fetch('payment_init.php', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ 
        submitService: '1',
        createCheckoutSession: true 
    })
})

通过以上修正，payment_init.php 将正确创建 Checkout Session，彻底解决 403 错误及 Stripe 参数缺失问题。核心原则始终是：严格遵循 Stripe 的货币单位规范，并以服务端日志为唯一可信依据进行排错。