Agent Skills
返回列表
第三方券码自动充值服务

第三方券码自动充值服务

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_68dc3d67/recharge-prod-buy。

技能介绍

解决的问题

第三方券码充值通常分散在商品目录、下单、支付和回调状态里，人工或脚本对接时需要反复解析字段。这个技能把充值服务封装为 MCP 工具，让模型可直接查询可充商品、创建订单、获取支付链接并跟踪订单状态。

工作方式

技能要求使用 Streamable HTTP Transport 连接 MCP 服务端点，不支持 SSE Transport。核心工具包括：

  • product_list：按关键词分页查询已上架商品
  • product_get：根据 product_id 查询商品详情
  • order_create：提交 items 和 account_no 创建充值订单，返回微信/支付宝支付链接
  • order_get：查询订单状态；对 pending 订单检查支付状态，支付成功后自动触发第三方充值

典型流程是先搜索商品，确认商品 ID、数量和充值手机号，再创建订单并把 wxpay_url / alipay_url 交给用户。用户支付后，再次调用 order_get 可获取最新状态。

适用边界

account_no 是充值目标账号，通常不是登录账号；订单金额按 selling_price 乘以数量计算，不等于面值。同一账号、商品和数量的 pending 订单 10 分钟内会复用。charge_type 区分直充和卡密，paid + fail、refunded 等状态需要按业务规则提示用户。

使用场景

  • 接入聊天机器人时，让用户按关键词查询可充值商品并确认面值、售价与商品 ID。
  • 用户给出手机号和充值需求后，创建第三方券码订单并返回微信支付或支付宝支付链接。
  • 支付完成后，通过订单号检查 `pay_status` 与 `order_status`，判断直充、卡密或失败状态。
  • 排查下单失败原因时，根据 `success` 为 `false` 的 `error` 字段定位商品不存在或未上架。

适合人员

  • 需要把第三方券码充值流程接入智能客服或自动下单系统的后端工程师。
  • 希望用 MCP 工具封装支付链接与订单状态查询的 Agent 开发者。
  • 要区分直充、卡密和退款异常，并编写状态提示逻辑的业务集成工程师。
  • 需要自动化搜索商品、创建订单并跟踪支付状态的工具链维护者。