接收 Stripe 回调

TIP

Stripe 的实现由 GitHub Copilot 生成

方法名	参数	返回值
callback	无/array/ServerRequestInterface	Collection

WARNING

Stripe 回调处理会自动通过 Webhook 签名验证，以确保回调数据的真实性和完整性。

请务必在配置中填写 webhook_secret（在 Stripe Dashboard 配置 Webhook 后获取）。签名信息通过 HTTP Header Stripe-Signature 传递。

例子

php

Pay::config($config);

// 是的，你没有看错，就是这么简单！
$result = Pay::stripe()->callback();

如果您没有传参，或传 null 则 yansongda/pay 会自动识别 Stripe 的回调请求并处理，通过 Collection 实例返回 Stripe 的处理参数。

WARNING

建议仅在 php-fpm 下使用，swoole 方式请使用 ServerRequestInterface 参数传递方式。

推荐在 swoole 环境下传递此参数，传递此参数后，yansongda/pay 会自动进行后续处理。

也可以自行解析请求参数，传递一个 array 会自动进行后续处理。

如果需要传递包含 headers 的请求信息（推荐，因为签名验证需要 Stripe-Signature header），可以使用以下格式：

php

$result = Pay::stripe()->callback([
    'headers' => $request->getHeaders(),
    'body' => (string) $request->getBody(),
]);

第二个参数主要是传递相关自定义变量的，类似于 web() 中的 _config / _method 等参数。

例如，如果你想在回调的时候使用非默认配置，则可以 Pay::stripe()->callback(null, ['_config' => 'yansongda']) 切换为 yansongda 这个租户的配置信息。