MCPInstall

alipay-payment-integration

支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App 支付、JSAPI 支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。 当用户提到"接入支付宝"、"集成支付宝支付"、"对接支付"、"支付宝收款"、"加个支付功能"、"支付宝下单"、"H5 支付"、"小程序支付"、"预授权"、"付款码"、"扫码支付"、"网页支付"、"PC 支付"、"周期扣款"、"自动续费"、"会员订阅"、"连续包月"、"代扣"时,或咨询支付产品相关报错、排查问题时使用此 Skill。

Installs
241
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://modelscope.cn --skill alipay-payment-integration
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads alipay-payment-integration automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

支付宝支付集成 Skill

前置说明

  1. 本 Skill 主要提供支付宝支付产品集成指引和集成问题排查指引。
  2. 请开发人员审查 AI 生成的接入代码,自行确认代码逻辑,上线前充分测试确保其适用性与准确性。

文档访问规范

所有支付宝支付产品的文档地址均为在线动态链接,务必使用 curl 获取在线文档内容:

# 示例:获取当面付文档
curl -sL "https://ideservice.alipay.com/cms/site/0izcu3"

递归访问

文档页面内包含的链接需要递归访问以获取完整内容。访问流程:

  1. 首先访问主文档 URL。
  2. 解析文档中的链接(产品介绍、接入准备、接口文档等)。
  3. 递归访问这些链接获取详细内容。
# 访问当面付子链接示例
curl -sL "https://ideservice.alipay.com/cms/site/0izal0"   # 产品介绍
curl -sL "https://ideservice.alipay.com/cms/site/0izal1"   # 接入准备

功能一:支付产品集成指引

触发条件:用户需要集成支付宝支付产品。

步骤 1.1 产品决策

阅读 产品决策,根据用户输入匹配关键词,决策支付产品。当用户描述模糊时,使用 澄清话术模板 进行产品确认。

步骤 1.2 获取集成文档

接入前必须阅读下列文档:

  • SDK 选择:为了帮助开发者调用开放接口,支付宝提供了开放平台服务端 SDK,包含 Java、PHP、Node.js、Python 和 .NET 五种语言,封装了签名与验签、HTTP 接口请求等基础功能。请先下载对应语言版本的最新版服务端 SDK 并引入开发工程。下载地址
  • 加签方式:签名请使用 RSA2。加签说明
  • 接入规范与常见陷阱:接入规范
  • 产品文档:根据用户的产品集成诉求,访问 产品文档路由 中对应的产品文档。阅读产品文档中的快速接入、接口列表、异步通知说明、注意事项等部分,根据用户集成诉求尽可能多地收集信息。

⛔ 阻塞检查点:步骤 1.2 完成标准(下列事项必须全部满足才能继续执行后续步骤)

  • 已读取 SDK 选择
  • 已读取 加签方式
  • 已读取 接入规范与常见陷阱
  • 已读取 产品文档(必须递归阅读项:快速接入、接口列表、异步通知说明)

集成环境说明

  • 建议开发者在测试阶段优先使用沙箱环境。
  • 沙箱环境:地址:https://openapi-sandbox.dl.alipaydev.com/gateway.do 详见:沙箱环境说明
  • 正式环境:地址:https://openapi.alipay.com/gateway.do

步骤 1.3 集成校验

  • 在集成过程中及发布上线前按照 集成校验清单 进行校验,确保签名验签、异步通知、异常处理等符合规范。校验结果供参考,开发者务必按照支付宝最新开放平台文档进行检查。

安全红线

⛔ 以下规则为支付宝支付接入的安全红线,违反可能导致资金损失或安全事故,必须严格遵守,产品集成过程中务必提醒开发者注意以下安全事项。

  • 私钥禁止存客户端:构造交易数据并签名必须在商家服务端完成,私钥严禁保存在商家 APP 客户端中。
  • 私钥禁止记日志:私钥不得出现在任何日志中。
  • 私钥禁止传公共仓库:私钥不得上传到 GitHub、GitLab 等公共代码仓库。
  • 前台支付结果不可信:前台同步跳转结果不可信,必须以支付宝异步通知或调用交易查询接口获取结果为准。
  • 未确认不重付:在未确认支付结果前,不得要求用户再次付款,必须先通过异步通知或查询接口确认支付结果。
  • 异步通知必须先验签:收到异步通知后必须先验签,确保通知来自支付宝。

功能二:集成问题排查指引

触发条件:用户在集成支付宝支付产品过程中遇到报错或其他问题。

⚠️ 支付产品信息确认(必须遵守):执行下述问题排查步骤之前,必须明确用户当前集成的支付产品,否则暂停输出并要求用户澄清,严禁在支付产品信息缺失时尝试查阅文档或猜测支付产品。

步骤 2.1 问题识别与分流

根据用户输入判断问题类型,分流到对应排查路径:

用户问题
    |
    +-- 有明确错误码(如 "ACQ.TRADE_HAS_SUCCESS"、"INVALID_PARAMETER")
    |       |
    |       └───> 步骤 2.2 错误码排查
    |
    +-- 无明确错误码(如流程疑问、功能异常等)
            |
            └───> 步骤 2.3 常见问题排查

步骤 2.2 错误码排查

适用:用户提供了明确的错误码。

⚠️ 报错接口信息确认(必须完成):错误码查询前,必须确认发生报错的接口信息,否则暂停输出并要求用户澄清,严禁在报错接口信息缺失时尝试查阅文档或猜测报错接口。

排查流程

  1. 查公共错误码:查阅 公共错误码说明,根据用户提供的错误码检索相关内容。如有匹配结果,输出排查结论;否则,查业务错误码。

  2. 查业务错误码:基于确定的支付产品和报错接口信息,查阅 产品文档路由 中对应的产品文档,进一步找到报错接口对应的接口文档,并在接口文档中根据用户提供的错误码检索相关内容。

  3. 输出排查结论:根据查询到的错误码关联内容,输出排查结论。

步骤 2.3 常见问题排查

适用:无明确错误码的其他类型问题。

排查流程

  1. 根据用户输入和确定的支付产品,查阅对应的产品常见问题文档,匹配问题解决方案,回答用户问题时,务必以支付宝文档为准。

  2. 若根据支付产品常见问题文档未找到解决方案,引导用户查阅 开放平台在线文档 或咨询 支付宝技术支持,严禁编造常见问题文档以外的解决方案。

常见问题文档索引

产品类别常见问题文档
当面付当面付常见问题
订单码支付订单码支付常见问题
APP 支付APP 支付常见问题
电脑网站支付电脑网站支付常见问题
手机网站支付手机网站支付常见问题
商家扣款商家扣款常见问题
预授权支付预授权支付常见问题
JSAPI 支付JSAPI 支付常见问题

产品文档路由

根据用户的业务场景,路由到对应的产品文档:

支付产品核心 API在线文档
当面付alipay.trade.pay当面付文档
订单码支付alipay.trade.precreate订单码支付文档
手机网站支付alipay.trade.wap.pay手机网站支付文档
电脑网站支付alipay.trade.page.pay电脑网站支付文档
JSAPI 支付alipay.trade.create + my.tradePayJSAPI 支付文档
App 支付alipay.trade.app.payApp 支付文档
预授权支付alipay.fund.auth.order.app.freeze预授权支付文档
商家扣款alipay.trade.app.pay(支付并签约)+ alipay.trade.pay(后续扣款)商家扣款文档

注意:回答任何接入问题或编写代码前,先通过 curl 阅读上表中对应的在线文档链接。文档内包含最新的接口参数、代码示例和注意事项。

FAQ

What does the alipay-payment-integration skill do?

支付宝开放平台支付产品接入最佳实践。涵盖当面付、订单码支付、App 支付、JSAPI 支付、手机网站支付、电脑网站支付、预授权支付、商家扣款等全场景产品选型与集成指导。 当用户提到"接入支付宝"、"集成支付宝支付"、"对接支付"、"支付宝收款"、"加个支付功能"、"支付宝下单"、"H5 支付"、"小程序支付"、"预授权"、"付款码"、"扫码支付"、"网页支付"、"PC 支付"、"周期扣款"、"自动续费"、"会员订阅"、"连续包月"、"代扣"时,或咨询支付产品相关报错、排查问题时使用此 Skill。

How do I install alipay-payment-integration?

Run npx skills add https://modelscope.cn --skill alipay-payment-integration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/alipay-payment-integration/ (personal) or .claude/skills/alipay-payment-integration/ (project).

Which AI agents can use alipay-payment-integration?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is alipay-payment-integration safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains alipay-payment-integration?

It is published by modelscope.cn in modelscope.cn. It has 241 recorded installs.

More from modelscope.cn

View all →

skill-creator

modelscope.cn

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

AI & Agents2.5K installs

frontend-design

modelscope.cn

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

pptx-generator

modelscope.cn

Generate, edit, and read PowerPoint presentations. Create from scratch with PptxGenJS (cover, TOC, content, section divider, summary slides), edit existing PPTX via XML workflows, or extract text with markitdown. Triggers: PPT, PPTX, PowerPoint, presentation, slide, deck, slides.

Docs & Writing1.6K installs

minimax-docx

modelscope.cn

Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET). Three pipelines: (A) create new documents from scratch, (B) fill/edit content in existing documents, (C) apply template formatting with XSD validation gate-check. MUST use this skill whenever the user wants to produce, modify, or format a Word document — including when they say "write a report", "draft a proposal", "make a contract", "fill in this form", "reformat to match this template", or any task whose final output is a .docx file. Even if the user doesn't mention "docx" explicitly, if the task implies a printable/formal document, use this skill.

Docs & Writing1.6K installs

minimax-pdf

modelscope.cn

Use this skill when visual quality and design identity matter for a PDF. CREATE (generate from scratch): "make a PDF", "generate a report", "write a proposal", "create a resume", "beautiful PDF", "professional document", "cover page", "polished PDF", "client-ready document". FILL (complete form fields): "fill in the form", "fill out this PDF", "complete the form fields", "write values into PDF", "what fields does this PDF have". REFORMAT (apply design to an existing doc): "reformat this document", "apply our style", "convert this Markdown/text to PDF", "make this doc look good", "re-style this PDF". This skill uses a token-based design system: color, typography, and spacing are derived from the document type and flow through every page. The output is print-ready. Prefer this skill when appearance matters, not just when any PDF output is needed.

Docs & Writing1.5K installs

minimax-xlsx

modelscope.cn

Open, create, read, analyze, edit, or validate Excel/spreadsheet files (.xlsx, .xlsm, .csv, .tsv). Use when the user asks to create, build, modify, analyze, read, validate, or format any Excel spreadsheet, financial model, pivot table, or tabular data file. Covers: creating new xlsx from scratch, reading and analyzing existing files, editing existing xlsx with zero format loss, formula recalculation and validation, and applying professional financial formatting standards. Triggers on 'spreadsheet', 'Excel', '.xlsx', '.csv', 'pivot table', 'financial model', 'formula', or any request to produce tabular data in Excel format.

Data & Databases1.5K installs

Popular backend & apis skills

View category →

find-skills

vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

OfficialBackend & APIs4.1M installs

entra-app-registration

microsoft/azure-skills

Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.

OfficialBackend & APIs566.7K installs

This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).

Backend & APIs514.8K installs

embedded-captions

heygen-com/hyperframes

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Backend & APIs453.3K installs

entra-agent-id

microsoft/azure-skills

Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).

OfficialBackend & APIs336.6K installs

neon

neondatabase/agent-skills

Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.

Backend & APIs237.1K installs