SuperAPI AI 工具集

shopify-payments-apps

编程与开发

查看项目

更新于 11-17 03:51

技能介绍

用途

该技能用于协助 Shopify 开发者编写与最新 Shopify Payments Apps API GraphQL 版本交互所用的查询或变更,面向支付服务商将支付解决方案集成到 Shopify 结账流程。

主要能力

  • 引导开发者围绕支付处理、退款、支付会话管理等目标,在开发者文档中搜索相似示例与字段定义。
  • 输出经过验证的 GraphQL 操作,并附上说明和所引用文档的链接。
  • 要求覆盖支付会话的完整流程、授权/捕获/结算处理、退款与撤销的账务核对、卡/钱包/替代支付方式、拒付与网络错误处理、3D Secure 与欺诈预防、支付确认与 Webhook 通知等环节。

使用方式

技能要求每次响应按顺序调用 bash 工具:

  1. 调用 scripts/search_docs.mjs "<query>" --model YOUR_MODEL_NAME --client-name YOUR_CLIENT_NAME --client-version YOUR_CLIENT_VERSION 搜索文档,搜索对象为操作或组件名称,而非完整用户提示。
  2. 基于搜索结果编写代码。
  3. 调用 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 退出上报。

暂未提供的事实

该资料的官方文本为空,未说明收费、价格、支持平台范围或具体效果指标,暂未提供。