Stripe Checkout 如何为不同支付方式配置对应独立结算币种

AI 小北

2026-10-25

问题根因拆解

第一类问题是PHP语法层面的硬伤：关联数组中重复定义同名称键值时，后面的内容会直接覆盖前面的所有配置。你在单个price_data块里反复写currency、unit_amount字段，实际最终生效的只有最后一组键值，前面写的MYR、USD配置完全没有实际作用。
第二类问题是Stripe产品逻辑的硬限制：单个Checkout Session从创建开始就会锁定唯一的全局结算币种，所有金额展示、支付方式校验、资金清算全链路都围绕这个固定币种运行，原生不支持同一个Session内根据用户选择的支付方式动态切换币种、调整对应结算金额。
你当前页面所有支付方式都统一显示MYR定价的异常，是上述两个问题叠加导致的：一方面数组键覆盖让配置完全失效，另一方面Stripe检测到Session中包含仅支持马来西亚林吉特结算的FPX支付方式时，会强制将整个Session的结算币种锁定为MYR，覆盖其他原本的配置值。

落地实现方案

要达成「不同支付方式匹配对应币种结算」的效果，不能在单个Session内做配置嵌套，需要拆分独立的Session做分支适配：

不再将三种支付方式全部塞进同一个Session的payment_method_types字段，而是针对每个支付方式生成独立的Checkout Session，每个Session严格匹配对应要求的结算规则
替换原有Stripe托管的统一支付页逻辑，改为自定义前端选择界面：用户点击对应支付方式按钮时，直接触发匹配好的独立Session跳转，避免不同币种、不同支付方式的逻辑互相干扰
注意Stripe接口的金额规则：所有传入的unit_amount必须是对应货币的最小整数单位，不支持浮点数写法。比如收2000美元要传200000（对应2000*100美分），之前写的浮点数金额会触发接口校验失败

具体的代码调整示例如下：

// 生成卡支付（Card）对应的USD结算Session
$cardSession = \Stripe\Checkout\Session::create([
    'payment_method_types' => ['card'],
    'line_items' => [[
        'price_data' => [
            'currency' => 'usd',
            'unit_amount' => 200000,
            'product_data' => [
                'name' => $productName,
                'metadata' => ['pro_id' => $productID]
            ]
        ],
        'quantity' => 1,
        'description' => $productName,
    ]],
    'mode' => 'payment',
    'success_url' => STRIPE_SUCCESS_URL.'?session_id={CHECKOUT_SESSION_ID}',
    'cancel_url' => STRIPE_CANCEL_URL,
]);

// 生成FPX支付对应的MYR结算Session
$fpxSession = \Stripe\Checkout\Session::create([
    'payment_method_types' => ['fpx'],
    'line_items' => [[
        'price_data' => [
            'currency' => 'myr',
            'unit_amount' => 800000,
            'product_data' => [
                'name' => $productName,
                'metadata' => ['pro_id' => $productID]
            ]
        ],
        'quantity' => 1,
        'description' => $productName,
    ]],
    'mode' => 'payment',
    'success_url' => STRIPE_SUCCESS_URL.'?session_id={CHECKOUT_SESSION_ID}',
    'cancel_url' => STRIPE_CANCEL_URL,
]);

// 生成支付宝（Alipay）支付对应的CNY结算Session
$alipaySession = \Stripe\Checkout\Session::create([
    'payment_method_types' => ['alipay'],
    'line_items' => [[
        'price_data' => [
            'currency' => 'cny',
            'unit_amount' => 400000,
            'product_data' => [
                'name' => $productName,
                'metadata' => ['pro_id' => $productID]
            ]
        ],
        'quantity' => 1,
        'description' => $productName,
    ]],
    'mode' => 'payment',
    'success_url' => STRIPE_SUCCESS_URL.'?session_id={CHECKOUT_SESSION_ID}',
    'cancel_url' => STRIPE_CANCEL_URL,
]);

将上述三个Session返回的id同步给前端，把每个支付方式的操作按钮绑定对应Session的跳转逻辑，即可实现预期的分币种展示效果。

内容的提问来源于stack exchange，提问作者zac1987