PHP中Stripe订阅手动设置ID报错，求有效解决方案

问题场景 #

在PHP环境下创建Stripe订阅时，传入id参数会触发「无效参数」错误，移除该参数则可正常创建订阅，但我需要手动指定订阅ID，求可行的解决方法。

尝试的代码 #

$stripe->subscriptions->create([
    'id' => $id,
    'customer' => $id,
    'items' => [
        ['price' => 'price_'],
    ],
]);

收到的错误信息 #

Fatal error: Uncaught Error sending request to Stripe: (Status 400)
(Request req_no) Received unknown parameter: id
Stripe\Exception\InvalidRequestException: Received unknown parameter:
id in
public_html/stripe-php-13.0.0/lib/Exception/ApiErrorException.php:38

解决方法 #

Stripe的订阅创建API不支持直接通过id参数指定自定义订阅ID，订阅ID是由Stripe系统自动生成的资源标识符，这就是触发错误的原因。

要实现关联自定义ID的需求，最佳方案是利用metadata字段存储你的自定义标识，具体代码如下：

// 注意：customer参数需传入正确的客户ID，不要和自定义订阅ID混用
$stripe->subscriptions->create([
    'customer' => $customer_id,
    'items' => [
        ['price' => 'price_xxxxxx'],
    ],
    'metadata' => [
        'custom_subscription_id' => $your_desired_id
    ]
]);

后续如果需要通过自定义ID查询对应订阅，可以使用列表接口并过滤metadata：

$subscriptions = $stripe->subscriptions->all([
    'customer' => $customer_id,
    'metadata[custom_subscription_id]' => $your_desired_id
]);

另外提醒：你之前的代码中customer和id使用了同一个变量$id，这大概率是笔误，会导致错误地将自定义ID传入客户参数，建议修正这个问题避免其他异常。

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