Payment skill

Skill TencentCloudBase/awesome-miniprogram-skills/skills/payment-skill

微信小程序 Skills 示例集合 —— 从简单待办到解决数据存储、支付、AI 调用，开箱即用。帮你的小程序快速接入微信小程序 AI 开发模式

Install

npx -y skills add TencentCloudBase/awesome-miniprogram-skills --skill payment-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

微信支付集成 Skill：下单支付、查询订单、关闭订单、申请退款、查询退款、商家转账、查询转账

SKILL.md

4.3 KB, as published. Nobody here has run it

payment-skill 微信支付场景

业务流程图

用户意图
  │
  ├─ 下单支付（"帮我付款"）──→ createOrder → 支付订单卡片
  │                                │
  │                       用户点击"确认支付"
  │                                ↓
  │                       调用 wx.requestPayment
  │                                ↓
  │                          支付成功/失败
  │
  ├─ 查询订单（"查一下订单"）──→ queryOrder → 订单状态卡片
  │
  ├─ 关闭订单（"取消这个订单"）─→ closeOrder → 订单状态卡片（已关闭）
  │
  ├─ 申请退款（"我要退款"）───→ refundOrder → 退款结果卡片
  │
  ├─ 查询退款（"退款进度"）───→ queryRefund → 退款状态卡片
  │
  ├─ 商家转账（"转账给我"）───→ transferMoney → 转账结果卡片
  │
  └─ 查询转账（"转账到了吗"）──→ queryTransfer → 转账状态卡片

createOrder 必须在支付前调用——先获取支付参数才能调起微信支付。 refundOrder 必须在订单支付成功后调用——未支付的订单无法退款。 closeOrder 仅适用于未支付的订单——已支付订单无法关闭，需走退款流程。

原子接口依赖关系

接口	作用	组件	前置条件
createOrder	创建支付订单并调起支付	payment-card	用户明确表达支付意图
queryOrder	查询订单状态	order-status-card	已有 outTradeNo
closeOrder	关闭未支付订单	order-status-card	订单状态为 NOTPAY
refundOrder	申请退款	refund-card	订单状态为 SUCCESS
queryRefund	查询退款进度	refund-card	已有 outRefundNo
transferMoney	发起商家转账	transfer-card	用户确认转账
queryTransfer	查询转账状态	transfer-card	已有 outBillNo

业务约束（跨接口铁律）

1. 输出形态

所有成功返回的接口（isError=false）且绑定了组件的，必须展示卡片，禁止以纯文本列出卡片中的详情数据。
Agent 回复时可附加一句简短引导话术，但禁止把订单号、金额、状态等以 markdown 列表形式展开。

2. 执行顺序

refundOrder 必须在 queryOrder 确认订单为 SUCCESS 状态后调用。
closeOrder 必须在 queryOrder 确认订单为 NOTPAY 状态后调用。
禁止并发调用支付接口；须等上一笔结束后再发起下一笔。

3. 数据来源

outTradeNo 必须来自 createOrder 返回的 outTradeNo 原值，禁止编造。
outRefundNo 必须来自 refundOrder 返回的 outRefundNo 原值，禁止编造。
outBillNo 必须来自 transferMoney 返回的 outBillNo 原值，禁止编造。

4. 金额处理

所有金额单位为分（如 1 元 = 100 分）。
禁止使用前端传入的金额直接下单，生产环境应从后端查询。
退款金额不能超过订单总金额。

5. 安全约束

后端通过 wx.cloud.callHTTPFunction 调用，平台自动鉴权。
payer.openid 由后端从 x-wx-openid header 自动获取，前端无需传递。
禁止在前端硬编码任何密钥或证书信息。

用户意图分流

直接意图（触发本 SKILL）

"帮我付款"
"我要支付"
"买单"
"查一下订单状态"
"这个订单还没付吧"
"取消订单"
"关闭这个订单"
"我要退款"
"申请退货退款"
"退款到哪了"
"转账给我"
"发红包"

意图分流规则

用户说出"付款/支付/买单" → createOrder
用户问"订单状态/查单" → queryOrder
用户说"取消/关闭订单" → closeOrder（先查单确认 NOTPAY）
用户说"退款/退钱" → refundOrder（先查单确认 SUCCESS）
用户问"退款进度/到账了吗" → queryRefund
用户说"转账/打款" → transferMoney
用户问"转账状态" → queryTransfer
用户表达歧义 → 先反问澄清，禁止猜测