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

本文解析 stripe 集成中 `payment_init.php` 返回 403 forbidden 的根本原因，重点指出因未正确转换金额单位（huf）导致的 api 校验失败，并提供符合 stripe 最新 php sdk 规范的安全、可运行解决方案。

在使用 Stripe 实现支付流程时，payment_init.php 返回 403 Forbidden 错误，表面看似权限或服务器配置问题，但结合 Stripe 日志中关键提示：

parameter_missing - line_items[0][price_data][product_data][name]

以及你代码中实际已正确赋值 $productName 的事实，说明该错误是误导性提示——真正触发 403 的前置条件，是 Stripe API 在解析请求体时因金额格式非法而拒绝整个请求，进而导致后续字段校验未执行，返回了不准确的错误信息。

? 核心问题：金额单位未按 Stripe 要求转换为「最小货币单位」

Stripe 所有货币金额（如 unit_amount）必须以「最小货币单位」传入：

• USD：以美分为单位（$10.99 → 1099）
• HUF（匈牙利福林）：以福林为单位（无需转为“分”，因 HUF 无辅币），但仍需满足最低金额限制

⚠️ 关键误区：你代码中计算了 $stripeAmount = round($productPrice * 100, 2)，但并未在创建 session 时使用它，而是错误地直接传入原始 6900（即 6900 HUF）：

'unit_amount' => $productPrice, // ❌ 错误！应为整数，且需确认是否满足最低限额

而 Stripe 对 HUF 的最低支付金额要求为 50 HUF（约 $0.14），你传入 6900 本身数值合法，但问题在于：

• round($productPrice * 100, 2) 得到的是 690000.00，若误用于 HUF 将远超上限；
• 更严重的是：$productPrice 是 Float 类型（如 6900.0），而 Stripe PHP SDK 严格要求 unit_amount 为整数（int），传入浮点数会触发静默失败或 400/403 响应。

✅ 正确做法（适配 HUF）：

• HUF 无“分”概念，直接使用整数福林值（如 6900）；
• 确保 $productPrice 是整数类型；
• 移除不必要的 * 100 转换（仅适用于 USD/EUR 等有辅币的货币）。

✅ 修复后的完整 payment_init.php（精简 + 安全增强）

 0, 'error' => ['message' => 'Method not allowed']]);     exit; }  // 4. 解析 JSON 请求体（前端应发送 application/json） $input = file_get_contents('php://input'); $request = json_decode($input, true);  if (json_last_error() !== JSON_ERROR_NONE) {     http_response_code(400);     echo json_encode(['status' => 0, 'error' => ['message' => 'Invalid JSON']]);     exit; }  // 5. 获取服务选择（防御性校验） $chosenService = $request['submitService'] ?? null; if (!in_array($chosenService, ['1', '2'], true)) {     http_response_code(400);     echo json_encode(['status' => 0, 'error' => ['message' => 'Invalid service']]);     exit; }  // 6. 定义产品（HUF 单位：直接使用整数福林） $products = [     '1' => ['name' => 'Hajvágás (6900 HUF)', 'id' => 'hc001', 'price' => 6900],     '2' => ['name' => 'Hajvágás + Szakáll (9900 HUF)', 'id' => 'hc002', 'price' => 9900], ]; $product = $products[$chosenService];  // 7. 初始化 Stripe（使用最新 SDK 推荐方式） StripeStripe::setApiKey(STRIPE_API_KEY); StripeStripe::setApiVersion('2024-06-20'); // 显式指定 API 版本  // 8. 创建 Checkout Session try {     $session = StripeCheckoutSession::create([         'line_items' => [[             'price_data' => [                 'currency' => 'huf',                 'unit_amount' => (int)$product['price'], // ✅ 强制转为整数                 'product_data' => [                     'name' => $product['name'],                     'description' => '20% előleg Mobil Barber',                 ],             ],             'quantity' => 1,         ]],         'mode' => 'payment',         'success_url' => STRIPE_SUCCESS_URL . '?session_id={CHECKOUT_SESSION_ID}',         'cancel_url' => STRIPE_CANCEL_URL,     ]);      echo json_encode([         'status' => 1,         'message' => 'Session created',         'sessionId' => $session->id     ]);  } catch (StripeExceptionApiErrorException $e) {     http_response_code(400);     echo json_encode([         'status' => 0,         'error' => ['message' => 'Stripe API error: ' . $e->getMessage()]     ]); } catch (Exception $e) {     http_response_code(500);     echo json_encode([         'status' => 0,         'error' => ['message' => 'Server error: ' . $e->getMessage()]     ]); }

? 关键注意事项

• 前端调用方式必须为 fetch() 发送 jsON：

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

  不要使用表单 POST 直接提交（会导致 $_POST 可用但 php://input 为空）。

• HUF 金额无需 ×100：仅 USD/EUR 等需转换为分/欧分；HUF 直接传整数福林值（6900），并确保是 int 类型。

• 启用 composer 自动加载：弃用手动 require ‘stripe-php/init.php’，改用 composer require stripe/stripe-php，更安全且兼容新版 SDK。

• 403 的真实诱因：常见于 Web 服务器（如 apache/nginx）拦截含敏感参数的 POST 请求，或 .htaccess 规则误判。但本例中，因金额类型错误导致 Stripe 拒绝请求后，服务器可能返回通用 403，务必结合 Stripe Dashboard 的 Logs 和浏览器 Network 面板中的 Response Headers 综合判断。

遵循以上修正，即可彻底解决 403 Forbidden 问题，并构建健壮、符合 Stripe 最佳实践的支付初始化流程。