本文解析 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 的货币单位规范，并以服务端日志为唯一可信依据进行排错。
