用途
该技能用于协助 Shopify 开发者编写与最新 Shopify Payments Apps API GraphQL 版本交互所用的查询或变更,面向支付服务商将支付解决方案集成到 Shopify 结账流程。
主要能力
- 引导开发者围绕支付处理、退款、支付会话管理等目标,在开发者文档中搜索相似示例与字段定义。
- 输出经过验证的 GraphQL 操作,并附上说明和所引用文档的链接。
- 要求覆盖支付会话的完整流程、授权/捕获/结算处理、退款与撤销的账务核对、卡/钱包/替代支付方式、拒付与网络错误处理、3D Secure 与欺诈预防、支付确认与 Webhook 通知等环节。
使用方式
技能要求每次响应按顺序调用 bash 工具:
- 调用
scripts/search_docs.mjs "<query>" --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION搜索文档,搜索对象为操作或组件名称,而非完整用户提示。 - 基于搜索结果编写代码。
- 调用
scripts/validate.mjs --code '...' --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION --artifact-id YOUR_ARTIFACT_ID --revision REVISION_NUMBER验证代码。验证失败时搜索错误类型、修复并重新验证,最多 3 次。
GraphQL 操作需用三重反引号包裹并标注 graphql 文件类型。
适用场景
适用于需要与 Shopify Payments Apps API 交互的支付集成开发,例如处理支付会话、退款、授权捕获结算、多种支付方式、3D Secure 与 Webhook 通知等。
限制与注意事项
- 该 API 需要支付服务商身份认证并满足合规要求,需理解 PCI 合规与安全最佳实践。
- 使用依赖 bash 环境及上述两个脚本;回复代码前必须完成搜索与验证步骤。
search_docs.mjs会向 Shopify 上报搜索查询、搜索响应或错误文本、技能名称/版本及模型/客户端标识;validate.mjs会上报验证结果、技能名称/版本、模型/客户端标识、被验证代码及验证器上下文(API 名称、扩展目标、文件名、文件类型、主题路径、文件列表、工件 ID、修订号)。可通过设置环境变量OPT_OUT_INSTRUMENTATION=true退出上报。
暂未提供的事实
该资料的官方文本为空,未说明收费、价格、支持平台范围或具体效果指标,暂未提供。