芝麻先享Skill

📋 技能概述

本 Skill 提供芝麻先享（动态金额模式）的全流程操作能力，通过调用支付宝开放平台 API 实现信用服务的开通、下单、扣款及订单管理。

🔐 前置准备

申请条件

⚠️ 重要：
- 芝麻先享仅支持自研商家/服务商接入
- 不支持沙箱调试，需使用生产环境

使用前请确保已完成：

• ✅ 在支付宝开放平台创建应用
• ✅ 申请芝麻先享产品能力（审核需1-3个工作日）
• ✅ 获取芝麻信用服务ID（应用详情页 → 能力列表，28位数字）

📖 详细接入流程请参阅 支付宝开放平台文档

配置文件

配置文件路径：~/.antConfig/config.json（用户主目录下）

必填配置项：

{
  "X-OpenPlatform-alipayPublicKey": "<支付宝公钥>",
  "X-OpenPlatform-appId": "<应用 ID>",
  "X-OpenPlatform-PrivateKey": "<应用私钥>"
}

📖 配置示例请参阅 [config.json.example](references/config.json.example)

🚀 快速开始

详见 [README.md](./README.md)

📖 完整流程请参阅 [业务流程详解](skill/workflow.md)

💬 使用方式

本技能支持两种使用方式：

方式一：交互式引导

用户发起模糊请求时，通过交互式引导逐步完成操作：

用户：芝麻先享
助手：[自我介绍，让用户选择技术咨询或产品操作]

📖 详细引导规范请参阅 [交互引导规范](skill/interaction-guide.md)

方式二：直接指令

用户可通过明确指令直接调用，跳过交互引导：

💡 详细参数说明请参阅 [API 参考文档](skill/api-reference.md)

技术咨询类指令： 接入流程、接口文档、错误码、常见问题、模式区别

🔄 业务流程

芝麻先享服务支持两种业务流程：

免确认模式流程：

1.开通服务 → 2.查询协议 → 3.免密下单 → 4.扣款 → 5.退款
                              │
                              └──→ 6.结束订单(不扣款)

需确认模式流程：

1.开通下单 → 2.扣款 → 3.退款
       │
       └──────────→ 4.结束订单(不扣款)

📖 详细的流程图及命令示例请参阅 [业务流程详解](skill/workflow.md)

📎 文档导航

详见 [README.md](./README.md) 或以下链接：

• [业务流程](skill/workflow.md) | [API 参考](skill/api-reference.md) | [常见问题](skill/faq.md)
• [示例报文](references/examples/) | [字段词典](skill/glossary.md) | [交互引导](skill/interaction-guide.md)

⚠️ 注意事项

1. 履约标识：结束订单时 is_fulfilled=true 显示已守约，false 显示已取消
2. 免确认 vs 需确认：

- 免确认（order）：用户已开通，传入 creditagreementid - 需确认（create-order）：用户未开通，传入 zmserviceid

1. 自动处理：finish 命令自动生成请求号，pay 命令自动使用信用订单号作为授权码

🐛 错误处理

📖 更多问题请参阅 [常见问题](skill/faq.md)

📝 更新日志

📖 [查看完整更新日志](CHANGELOG.md)

最后更新：2026-04-18