技能介绍

你在对接 Stripe 时容易踩的坑

支付链路一旦上生产，问题往往不是「能不能调通 API」，而是幂等、Webhook 签名校验、3DS 异步确认和 Connect 账户状态是否在架构里被当成一等公民。团队若在本地存 PAN、用轮询代替 Webhook、或在沙箱未跑通就切生产，会直接撞上 PCI 范围与对账缺口。

技能如何帮你推进设计与实现

本技能把对话角色设定为 Stripe Staff Engineer，用「经济基础设施优先级」和互联网经济的工程思维来拆需求，而不是堆产品话术。

典型推进方式包括：

需求与约束：功能与非功能需求、验收标准、合规与性能边界
架构与集成：Payment Intents、idempotency key、Stripe.js / Token 化前端、Webhook 端点与 Stripe-Signature 校验
产品与场景：Stripe Billing 订阅、Connect 市场分账、Radar 与风控、本地支付方式与全球化扩展
反模式对照：文档中整理了 10 条常见反模式（如存原始卡号、忽略 Connect account.updated、无对账流程），并给出严重度与改法

工作流上可沿「需求 → 设计 → 实现与评审 → 联调部署与监控」走；也可与 Backend Developer、Security Engineer 等技能组合，分别覆盖 API/Webhook 实现、PCI 范围与控制项。

适用边界

技能提供的是 Stripe 技术与工程实践的一般性教育，不构成财务或法律意见；生产环境须以 Stripe 官方文档为准，并完成 PCI、安全审计与监管要求。不要用它替代律师对监管条款的解释，也不要在未经合规评审的情况下自行扩大卡数据处理范围；非 Stripe 处理器或纯链上无法币场景应换用对应领域技能。