用途:该技能用于在 Rails 应用中借助 Pay gem 集成 Stripe 支付,覆盖从安装配置到订阅、收款、Webhook 与测试的完整流程。
主要能力:按主题提供工作流,包括新项目安装配置、创建订阅(含试用)、管理订阅(取消、暂停、恢复、切换)、一次性收款与退款、Stripe Checkout、Billing Portal、Webhook 配置、按量计费、Stripe Connect 市场支付、支付问题调试以及测试编写。
核心原则:任何支付操作前需先设置支付处理器,例如 @user.set_payment_processor :stripe,或在模型中使用 pay_customer default_payment_processor: :stripe;金额以最小货币单位(分)表示,如 charge(15_00) 表示 15.00;Pay 依赖 Stripe Webhook 同步订阅状态与支付确认,开发时可用 stripe listen --forward-to localhost:3000/pay/webhooks/stripe;SCA/3D Secure 通过 Pay::ActionRequired 异常与 /pay/payments/:id 确认路由处理;测试可使用 fake 处理器,如 @user.set_payment_processor :fake_processor, allow_fake: true。
使用方式:先说明目标(如创建订阅、配置 Webhook),再按对应工作流文件执行;每次改动后可用 bin/rails runner "Pay::Subscription" 验证加载、bin/rails test test/models/ 运行测试,并检查 Webhook 转发。
适用场景:Rails 项目需要接入 Stripe 支付、订阅计费、按量计费或市场分账时。
限制:资料未提供具体版本要求、价格、平台支持范围及完整代码示例;实际使用需参考官方文档与项目环境。