用途:该技能面向 commercetools Checkout 集成,帮助开发者通过 Browser SDK 接入托管支付与结账体验,并按需选择集成模式。
主要能力:提供三种集成模式。paymentFlow(仅支付)保留现有地址与配送界面,仅用 Checkout 组件替换支付步骤,侵入性最小;checkoutFlow(全托管)用单个 commercetools 托管页面替换整个多步结账流程,覆盖地址、配送与支付;expressPayment 在购物车或商品详情页添加 Apple Pay / Google Pay 快捷按钮,可与上述任一模式共存。
使用方式:技能被调用时先执行文档检索脚本,获取最新已验证文档作为主要依据,并与 ./references/ 下的本地参考交叉比对,再结合用户目标模式给出实现指导。文档检索命令:node "<this skill's directory>/scripts/docs-search.mjs" --query "<关键词>" --app-name "<宿主应用>" --model "<当前模型>" --commercetools-project-key "<已知时>" --commercetools-region "<已知时>" --limit 20。项目键与区域仅在上下文中已有时传入,否则省略,不要搜索文件或询问用户。
可选脚本:需要了解 GraphQL 查询或变更时,运行 node scripts/graphql-schemata.mjs --resource-name "<资源名>" --app-name "<宿主应用>" --model "<当前模型>",获取单个资源的 GraphQL SDL;资源名无法识别时会列出有效名称。需要了解 REST 端点、请求/响应载荷或更新操作时,运行 node scripts/openApi-schemata.mjs --resource-name "<资源名>" --app-name "<宿主应用>" --model "<当前模型>",获取单个资源的 OpenAPI YAML;REST 资源采用读写拆分命名(如 api-Cart-read、api-Cart-write)。SDL 可能含桩类型,需按注释中的真实类型名单独再取;OpenAPI 不含引用展开架构,需单独获取。
适用场景:在现有结账流程中替换支付步骤、整体替换为托管结账页,或为购物车/商品页增加快捷支付。
限制:具体架构图、会话创建、PSP 连接器配置与 Webhook 处理等细节见 payment-only-mode.md;资料未提供价格、平台支持范围与效果数据。