支付宝技能：为应用集成支付能力

扣子编程技能中上架了支付宝提供的支付宝支付集成、支付商家入驻技能，用于为网页应用快速集成支付宝支付能力。

支付宝技能介绍

你是否正在使用扣子编程开发商城类网页应用，并希望用户能在应用内直接下单付款？现在通过支付宝官方编程技能包（支付宝支付集成、支付商家入驻）和扣子编程的支付宝支付密钥托管技能，就能为你的应用快速搭建完整的支付能力。

你只需在开发过程中调用对应技能，扣子 AI 便会根据技能指引，自动完成流程化的支付功能开发。

技能说明

支付相关的技能功能与使用场景说明如下表所示：

集成后的效果

你的应用集成支付能力且你具备收款资质后，用户可直接在应用内下单购买商品。支付完成后，交易金额将直接进入你签约的支付宝账户。

体验地址：https://y39hjgm54d.coze.site/

使用须知

开发流程

1. 开发应用：完成应用的基础功能开发。
2. 集成支付能力：使用支付宝支付集成技能，由扣子 AI 生成代码，为应用集成支付能力。
3. 完成商家入驻：使用支付商家入驻技能，由扣子 AI 生成代码，完成商家入驻。
4. 配置密钥：使用支付宝支付密钥托管技能托管密钥，并完成密钥配置。
5. 部署应用：正式上线应用，供用户使用。

步骤一：开发应用

在集成支付能力前，建议先完成应用的基础开发。以下以壁纸售卖网页为例说明。

1. 在扣子编程首页，单击网页应用选项卡。
2. 在文本框输入你的提示词，明确应用需求。

   开发一款支持壁纸展示与购买功能的网页应用。
   1. 提供壁纸缩略图展示功能，包括多张不同风格的壁纸预览。
   2. 针对每张壁纸提供购买按钮，点击后可进入购买流程。
   3. 支持壁纸的分类筛选功能，用户可按风格、分辨率等条件筛选壁纸。
   4. 提供壁纸详情页，展示壁纸规格、价格及相关介绍。
   5. 购买后可以下载壁纸。
   

3. 在键盘中敲击回车，开发你的项目。
   扣子 AI 会根据提示词自动设计并开发应用。
4. 确认开发结果。
   建议在应用基础功能开发完成并验证通过后，再集成支付能力，避免后期返工。
   

步骤二：集成支付能力

使用支付宝支付集成技能，为应用集成支付能力。开发完成后，你可以使用测试账号完成调试，不会产生真实的交易资金。

1. 在对话区，单击技能，添加支付宝支付集成技能。
   
2. 输入加载技能的提示词。

   为当前应用集成支付宝支付功能
   

3. 扣子 AI 加载支付宝支付集成技能，逐步完成操作。
   扣子 AI 会根据技能指引，完成如下 6 步操作。
   1. 产品决策。
      扣子 AI 会展示产品决策供你确认，包括：
      • 接入的支付方式（电脑网站支付、手机网站支付）
      • 协议内容：使用本服务需遵守法律法规、自行审核测试并承担使用责任，我方不对使用效果、正确性担保；禁止在代码、大模型对话等公网透露敏感信息（密码、API Keys、私钥等）。
        确认无误后，输入同意。如果不符合预期，可以通过自然语言调整。
        
   2. 沙箱初始化。
      无需准备真实的支付宝账号，系统会自动创建沙箱及测试账号。支付功能开发完成后，你可以直接使用这个测试账号登录支付宝，完成下单支付。

      创建沙箱环境

      

      提供测试账号

      

4. 集成前置步骤。
   
5. 集成代码。
   阅读支付接入文档，生成支付集成代码。
   
6. 输出集成后说明。
   完成代码开发后，系统会自动生成集成安全红线说明，请务必仔细阅读。
   
7. 集成校验。
   你确认同意开启集成校验后，扣子 AI 会自动逐项检测代码是否符合校验清单要求。
   
8. 验证支付能力。
   完成以上开发步骤后，单击网站中的购买，并使用【沙箱初始化】环节获取的测试账号登录支付宝，即可完成测试支付，无需额外下载沙箱 App。
   沙箱环境仅适用于开发调试，如需正式收款，请完成商家入驻流程。若测试支付遇到流程卡住、流程报错等问题，可直接将问题截图或报错信息粘贴到对话中，让大模型修复，直至测试支付完成为止。

   

   

步骤三：完成商家入驻

沙箱测试通过后，调用支付商家入驻技能，启动正式商家入驻流程。

1. 在对话区域，单击技能，添加支付商家入驻技能。
   
2. 输入加载技能的提示词。

   为当前应用集成商家入驻技能
   

   
3. 启动支付宝商家入驻流程。
   1. 检测支付宝凭证。
      当扣子 AI 未检测到支付宝凭证时，你可以根据提示，输入我要入驻。
   2. 方案规划与确认。
      扣子 AI 将自动完成前置检查，然后生成入驻方案，包括：
      • 产品类型
      • 经营类目
      • 适用场景
      • 所需资料清单
        其中，经营类目的具体说明如下：

      场景	处理方式
      可唯一确认类目	扣子 AI 直接输出方案。
      候选类目 ≤ 3 个	扣子 AI 展示候选类目供你选择。
      候选类目过多	扣子 AI 将引导澄清类目，缩小范围后再选择。例如输入我的业务是线上零售电商、我是做餐饮外卖的等。

      确认方案符合需求后，输入符合，确认使用。如不符合，输入不符合，重新选择。
      未及时确认时，系统将默认使用当前方案。如需修改，可在后续步骤中重新发起。
      
   3. 授权与协议签署。
      1. 单击授权链接，页面会展示授权二维码，使用支付宝 App 扫描。
      2. 在授权页面，请仔细阅读支付宝平台的收费信息和相关协议，然后确认授权。

         注意

         • 如果没有生成授权链接或单击授权链接报错，你可以在对话框中输入重新生成链接、没有看到链接、报错信息为xxx等提示词，让扣子 AI自行修复。
         • 授权有效期为 12 小时。

         

         

      3. 返回到扣子编程项目的会话页面，输入已授权，流程将自动继续。
   4. 采集资料。
      根据界面提示，截取并上传应用的首页、商品页以及支付页的图片。
      
   5. 自动完成产品签约和应用上架。

      产品签约

      在产品签约阶段，系统会自动检查签约状态。

      • 已有合约且已开通：跳过签约，直接进入下一步。
      • 已有合约审核中：提示等待审核结果。
      • 已有合约被驳回：展示驳回原因，引导修改后重新提交。
      • 无合约：发起产品签约开通。

      

      上架应用

      在创建与上架应用阶段，系统会检查你的支付宝账号中是否已有网页应用。

      • 已有，推荐复用现有应用。需要注意的是，确认当前支付宝网页应用未绑定其他业务应用。
      • 没有，创建开放平台应用。

      

步骤四：配置密钥

发布应用前，需先完成支付宝公钥与应用私钥配置，保障支付数据安全与接口通信可信。本步骤涉及三个平台的操作（支付宝密钥工具、支付宝开放平台、扣子编程），请仔细阅读，按顺序执行。

1. 生成应用公钥、应用私钥。
   参考支付宝文档密钥工具下载，下载并安装支付宝开放平台密钥工具，然后生成并妥善记录应用公钥、应用私钥。
   
2. 生成支付宝公钥。
   方式一：通过对话形式生成 方式二：通过支付宝开放平台生成

   1. 返回扣子编程项目的对话区域，输入继续设置应用公钥，公钥为：xxxx指令。
      
   2. 单击确认连接，然后使用支付宝 App 扫描二维码，确认并复制支付宝公钥。
      
      
   3. 返回扣子编程项目的对话区域，输入已确认。

   1. 登录支付宝开放平台，在网页/移动应用页签中，单击目标应用。
      该应用为你在【完成商家入驻】中，生成的应用。你可以输入应用 ID， 搜索该应用。
      
   2. 在开发设置页面，单击接口加签方式（密钥/证书）​对应的设置，然后单击确认。
      
   3. 设置加签方式为密钥，单击下一步。
   4. 在生成密钥文件中，单击下一步。
   5. 在上传中输入你的应用公钥，然后单击确认上传。
      系统将根据你的应用公钥，生成支付宝公钥。
      
   6. 复制支付宝公钥。
3. 返回扣子编程项目的对话区域，单击技能，添加支付宝支付密钥托管技能。
   
4. 输入加载技能的提示词。

   使用支付宝专属密钥托管技能
   

5. 扣子 AI 加载支付宝支付密钥托管技能，完成密钥配置。
   • 如果尚未在当前工作空间的支付宝支付密钥托管集成服务中输入支付宝公钥和应用私钥，系统会弹出配置界面，引导你完成密钥录入。
   • 如果已填写过密钥，请自行核对现有密钥仍与当前支付宝应用匹配。​扣子 AI 将直接使用现有密钥，完成后续开发。
     
6. 单击确认链接，然后使用支付宝App 扫描二维码，确认密钥。

   

   

7. 返回到扣子编程项目的会话页面，输入已确认。
8. 等待审核通过。
   开发完成后，需要等待应用审核通过后（通常 1-3 个工作日），才能正式使用支付功能。
   如果审核不通过，你可以登录支付宝开放平台，查看具体拒绝原因。
   

步骤五：部署应用

审核通过后，你可以将应用部署到线上，用户即可通过链接访问应用并购买商品。真实交易金额将直接进入你签约的支付宝账户。

1. 单击右上角的部署。
2. 配置部署参数。
   参数说明，请参考部署网页应用。

   

   

技术支持

当你反复修复问题失败时，可通过如下方式，联系支付宝支付技能团队。

常见问题

密钥托管是否安全？

密钥托管是安全的。密钥托管服务通过加密措施确保你的密钥信息在存储和使用过程中的安全。相比手动在对话或代码中暴露密钥，托管是更安全的方式。

如何判断应用已通过支付宝审核？

你可以登录支付宝开放平台，单击右上角的控制台，然后在网页/移动应用页面中，查看目标应用的状态。

如果状态为已上线，则表示审核通过。

如果支付宝审核不通过，我该怎么办？

首先确认是产品签约审核不通过，还是开放平台应用上架审核不通过。

• 产品签约不通过：你可以登录支付宝商家平台，单击电脑网站支付对应的查看详情，查看具体拒绝原因，并按指引完成相关操作。然后你可以在详情页直接重新提交或者回到扣子编程对话区输入我要入驻指令，系统会引导你重新提交申请。
• 应用上架审核不通过：你可以登录支付宝开放平台，找到目标应用，查看具体拒绝原因，并按指引完成相关操作。然后你可以重新向扣子 AI 发起**我要入驻​**的指令，系统会引导你重新提交申请。

测试失败或报错，如何处理？

在开发过程中，如果出现测试失败或者报错问题，你可以在对话中，直接描述问题，扣子 AI 会自行进行修复。例如：

能否使用模型生成的应用密钥？

不能。在配置密钥环节，模型可能会自行生成一组密钥，但这组密钥并非真实的支付宝密钥，无法实现支付。必须使用支付宝开放平台密钥工具生成应用公钥和应用私钥，以及通过支付宝开放平台生成支付宝公钥。

反复修复失败时，如何处理？

当你修复问题反复失败时，建议滚动到之前已验证成功的版本，重新开发。如果还有问题，可参考技术支持，联系支付宝支付技能团队。

出现“应用私钥与支付宝公钥不匹配”错误时，如何处理？

该错误主要由密钥配置错误（如公私钥配反、支付宝公钥错配为应用公钥、公私钥实际不配对）引起，请勿让模型反复修改，容易导致模型幻觉加重，越改越错。请严格按照以下步骤自查密钥。

1. 确认公私钥已正确配对、正确配置，或重置公私钥。
   重置操作：在支付宝开放平台密钥工具中重置应用公钥、应用私钥；复制重置后的应用公钥到支付宝开放平台重新配置支付宝公钥。
2. 在密钥托管集成服务中，重新输入正确的支付宝公钥和应用私钥。
3. 更新完成后，单击页面右上角的重启图标，重启项目。