💚 微信支付微服务 API
wxpay.hudongbot.com — 基于 EggJS + 微信支付 V3 API 的企业级支付网关
接口列表
POST
/payment
发起支付（JSAPI / Native / H5 / APP）
🔒 AK/SK 签名鉴权
| 参数 | 类型 | 必填 | 说明 |
|---|
| channel | string | 必填 | 渠道名称 |
| payType | string | 必填 | 支付方式：jsapi / native / h5 / app |
| outTradeNo | string | 必填 | 商户订单号（必须以 {channel}_ 开头） |
| amount | string | 必填 | 金额（单位：分，正整数） |
| description | string | 可选 | 商品描述 |
| payerId | string | JSAPI必填 | 用户 openid |
| notifyUrl | string | 可选 | 回调通知地址 |
| returnUrl | string | 可选 | 同步跳转地址（H5支付） |
| ak | string | 必填 | Access Key |
| sk | string | 必填 | Secret Key |
| timestamp | string | 必填 | 毫秒时间戳 |
| sign | string | 必填 | SHA256(channel+ak+sk+timestamp) |
POST
/payment/query
查询订单
🔒 AK/SK 签名鉴权
| 参数 | 类型 | 必填 | 说明 |
|---|
| channel | string | 必填 | 渠道名称 |
| outTradeNo | string | 二选一 | 商户订单号 |
| transactionId | string | 二选一 | 微信支付订单号 |
POST
/payment/close
关闭订单
🔒 AK/SK 签名鉴权
POST
/wxpay/refund/precheck
退款预校验（8项规则校验 + 生成 precheckToken）
🔒 refund_aksk 鉴权（含退款权限检查）
POST
/wxpay/refund/execute
执行退款（验证 precheckToken + 调用微信退款接口）
🔒 refund_aksk 鉴权
POST
/payment/notify
微信支付异步回调（AES-256-GCM 解密 + 转发业务方）
🔓 免 AK/SK 鉴权（微信平台签名验证）
环境变量配置
| 变量名 | 格式 | 说明 |
|---|
| HD_API | channel1:ak1:sk1,channel2:ak2:sk2 | 支付接口 AK/SK 密钥对 |
| HD_TUI_API | channel1:maxAmount1:allowPart1:sk1,... | 退款权限配置 |
| WXPAY_MCH_ID | 字符串 | 微信支付商户号 |
| WXPAY_APP_ID | 字符串 | 微信应用 AppID |
| WXPAY_API_V3_KEY | 32位字符串 | 微信支付 V3 API 密钥 |
| WXPAY_PRIVATE_KEY | PEM 格式 | 商户 API 私钥 |
| WXPAY_SERIAL_NO | 字符串 | 商户 API 证书序列号 |
| WXPAY_NOTIFY_URL | URL | 微信支付回调地址 |
| NOTIFY_URLS | channel1:url1,channel2:url2 | 业务方回调转发地址 |
| PORT | 数字 | 服务端口（默认 9000） |
签名算法
sign = SHA256(channel + ak + sk + timestamp)
支付方式说明
| payType | 说明 | 微信接口 | 返回内容 |
|---|
| jsapi | JSAPI/小程序支付 | /v3/pay/transactions/jsapi | prepayId + paySign |
| native | Native扫码支付 | /v3/pay/transactions/native | codeUrl（二维码链接） |
| h5 | H5支付 | /v3/pay/transactions/h5 | h5Url（跳转链接） |
| app | APP支付 | /v3/pay/transactions/app | prepayId + paySign |