社保缴纳验证（Social Security Verification）
核验某人员的社保缴纳情况，输出结构化、可直接引用的验证结论。全程简体中文。
能力说明
对接监管平台社保验证接口，按「身份证号 + 单位名称 + 社保年月」核验该人员当月是否在该单位正常缴纳社保。适用于：
- 员工入职背景核验
- 外包 / 外派人员社保真实性核查
- 资质审核、合规检查中的社保缴纳确认
输入参数（5 项，全部必填）
| 参数 | 说明 | 示例 |
|---|---|---|
| userName | 姓名 | 张三 |
| userCode | 身份证号 | 110101199001011234 |
| mobile | 手机号 | 13800138000 |
| companyName | 单位名称 | XX科技有限公司 |
| socialSecurityMonth | 社保年月（yyyyMM） | 202609 |
调用方式（按次付费，402 协议）
接口地址：POST https://main.vmssaas.com/api/vms/supervision/a2m/resource
- 首次调用（无
Payment-Proof头）→ 返回HTTP 402+Payment-Needed头（账单） - 引导用户在对话内完成支付（支付宝 AI 付，单次 1 元）
- 支付后携带
Payment-Proof头重试 → 返回社保验证结果
首次调用请求体：
{
"userName": "张三",
"userCode": "110101199001011234",
"mobile": "13800138000",
"companyName": "XX科技有限公司",
"socialSecurityMonth": "202609"
}
服务端付费链路（完整闭环）
本 Skill 依赖后端服务实现完整的按量付费闭环，服务端对接支付宝 AI 付（A2M）协议，需完成以下三步：
1. 验付调用
服务端收到携带 Payment-Proof 头的请求后，解析 Base64URL 编码的凭证，提取 payment_proof 与 trade_no，调用支付宝验付接口：
- 接口：
alipay.aipay.agent.payment.verify - 校验：凭证有效（
active=true）、交易号一致、金额一致、资源 ID 一致 - 验付失败 → 重新返回 402 账单，不交付资源
2. 履约确认
验付通过并交付资源后，服务端调用支付宝履约确认接口，回执本次履约：
- 接口：
alipay.aipay.agent.fulfillment.confirm - 参数：
trade_no（支付宝交易号） - 履约确认失败时，允许用同一
Payment-Proof重试
3. 订单持久化与幂等
- 返回 402 账单之前，服务端必须将订单（商户订单号
out_trade_no、金额、资源 ID、支付/履约状态）持久化到数据库 - 履约必须幂等：同一交易号在同一事务内只生成一次资源，避免重复扣费或重复交付
- 状态机：支付
PENDING_PAYMENT → PAID；履约UNFULFILLED → PENDING_CONFIRM → FULFILLED
返回结构
{
"requestId": "VMS-xxxx",
"results": [
{
"userName": "张三",
"userCode": "110101199001011234",
"mobile": "13800138000",
"companyName": "XX科技有限公司",
"socialSecurityMonth": "202609",
"verifyResult": "此单位下当月有缴纳记录",
"errorMessage": null
}
],
"total": 1,
"successCount": 1,
"failCount": 0
}
verifyResult 取值及含义：
| 取值 | 含义 |
|---|---|
| 此单位下当月有缴纳记录 | 正常缴纳 ✅ |
| 当月有缴纳记录但工作单位有误 | 有缴纳但单位不符 ⚠️ |
| 此单位下当月没有缴纳记录 | 无缴纳记录 ❌ |
| 未查到人员 | 查无此人 ❌ |
注意事项
- 需要多人验证时逐人分别调用，不得合并为一次
- 参数含敏感个人信息（身份证号），调用后不得留存明文记录
- 本服务按次计费，单次 1 元，调用前需向用户确认并说明收费
