🔐 微信刷脸支付配置

配置微信支付参数，启用刷脸支付功能

⚙️ 基础配置

微信服务商平台的 AppId
微信服务商平台的商户号（以 16 开头）
在微信服务商平台设置的 APIv3 密钥（32位）
在微信服务商平台可查看证书序列号
从 apiclient_key.pem 文件中复制私钥内容，包含 -----BEGIN PRIVATE KEY----- 和 -----END PRIVATE KEY-----
微信支付成功后的回调地址，必须是 HTTPS 且外网可访问

📡 API 接口文档

刷脸支付
订单查询
退款接口
回调通知

POST /api/facepay/create

{ "faceCode": "刷脸凭证（从刷脸设备获取）", "outTradeNo": "商户订单号", "totalAmount": 100, // 单位：分 "description": "商品描述", "subMchId": "子商户号" // 可选，服务商模式必填 }

GET /api/facepay/query/{outTradeNo}?subMchId=xxx

// 查询订单支付状态 // subMchId: 可选，服务商模式传入子商户号 // 返回: { success, tradeState, transactionId, ... }

POST /api/facepay/close/{outTradeNo}?subMchId=xxx

// 关闭未支付订单 // subMchId: 可选，服务商模式传入子商户号

POST /api/facepay/refund

{ "outTradeNo": "商户订单号", "outRefundNo": "商户退款单号", "refundAmount": 100, // 退款金额（分） "totalAmount": 100, // 原订单金额（分） "reason": "退款原因", "subMchId": "子商户号" // 可选，服务商模式必填 }

GET /api/facepay/refund/query/{outRefundNo}?subMchId=xxx

// 查询退款状态 // subMchId: 可选，服务商模式传入子商户号

POST /api/facepay/notify

// 微信支付成功后的回调地址 // 需要在配置中设置 notifyUrl 指向此接口

POST /api/facepay/refund/notify

// 微信退款成功后的回调地址

📖 使用说明

  1. 服务商模式：填写服务商的 AppId、商户号、证书等配置
  2. 在微信服务商平台申请刷脸支付权限
  3. 下载服务商商户 API 证书（apiclient_key.pem）
  4. 设置 APIv3 密钥（32位）
  5. 在上表填写配置信息并保存
  6. 点击"测试配置"验证配置是否正确
  7. 勾选"启用刷脸支付"后保存
  8. 将 notifyUrl 配置为 https://easyuser.top/api/facepay/notify
  9. 调用 API 时通过 subMchId 参数指定子商户号（由刷脸设备传入）