OuYingJun1024
3d1e8969e6
- 新增 docs/integrations/(README + jiguang/sms/meituan/pangle/wxpay 各一篇): 记录各 SDK 集成的签名/验签/加解密/协议细节与踩坑(对齐 app/integrations 分层) - docs/api 接口文档变薄: 受影响接口头部加「集成实现」链接,把验签/RSA/CPS 签名 等重逻辑描述移到集成文档;ad-pangle-callback 验签段精简为指针 - docs/api/README 补架构说明(api 薄 / 重逻辑在 integrations) - 后端技术实现.md 目录树补全(福利/钱包/签到/省钱/发奖端点 + crud/integrations 现状), pangle/wxpay 标注移入 integrations - ad_reward_golive_checklist 路径同步 core→integrations Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2.9 KiB
2.9 KiB
微信支付 V3 — 商家转账到零钱（提现）+ code 换 openid（wxpay）
文件:
app/integrations/wxpay.py| 关联接口:wallet-withdraw · wallet-withdraw-status · wallet-bind-wechat · wallet-withdraw-info | ← 集成索引
作用
两件事：①提现——微信支付 V3「商家转账到零钱」；②绑定——微信授权 code 换 openid / 昵称头像。移植自 elderhelper，密钥懒加载（文件缺失不在 import 时炸，只在真正调用时抛 WxPayNotConfiguredError，与极光私钥同款策略）。
函数
| 函数 | 说明 |
|---|---|
create_transfer(openid, amount_fen, out_bill_no, user_name=None) |
发起商家转账到零钱。返回 {status_code, data} |
query_transfer(out_bill_no) |
按商户单号查转账单状态 |
cancel_transfer(out_bill_no) |
撤销转账单（仅 WAIT_USER_CONFIRM/ACCEPTED 可撤）。用户没在确认页确认就离开时调 |
encrypt_sensitive(plain) |
用微信支付平台公钥 OAEP(SHA1) 加密敏感信息（实名） |
code_to_openid(code) |
code 换 openid（sns/oauth2），失败抛 ValueError |
code_to_userinfo(code) |
code 换 openid + 拉昵称头像，返回 {openid, nickname, avatar_url, raw} |
签名机制
- 请求签名：商户 API 私钥 RSA-SHA256/PKCS1v15，构造 V3
Authorization头（WECHATPAY2-SHA256-RSA2048，含 mchid/nonce/timestamp/serial_no/signature）。 - 敏感字段（实名）：微信支付平台公钥 OAEP(SHA1) 加密，请求头带
Wechatpay-Serial。 - 实名传递阈值：
amount_fen >= 30（沿用 elderhelper，实际以微信侧要求为准）才加密带user_name。 - 转账接口路径:
/v3/fund-app/mch-transfer/transfer-bills，hosthttps://api.mch.weixin.qq.com。
配置
| 配置项 | 说明 |
|---|---|
WECHAT_APP_ID / WECHAT_APP_SECRET |
微信开放平台移动应用 appid / secret（换 openid 用） |
WXPAY_MCH_ID / WXPAY_MCH_SERIAL_NO |
商户号 / 商户证书序列号 |
WXPAY_MCH_PRIVATE_KEY_PATH |
商户 API 私钥 .pem 路径 |
WXPAY_PUBLIC_KEY_PATH / WXPAY_PUBLIC_KEY_ID |
微信支付平台公钥 .pem 路径 / 公钥 ID |
WXPAY_TRANSFER_SCENE_ID |
转账场景 ID |
WXPAY_REQUEST_TIMEOUT_SEC |
请求超时 |
踩坑
- userinfo 可能脱敏：微信隐私新政下
sns/userinfo可能返回昵称「微信用户」/灰头像，nickname/avatar_url可能为空，调用方需兜底（绑定不因此失败，openid 已拿到）。 cancel_transfer是提现「轮询查单时若仍WAIT_USER_CONFIRM」的退款依据（见 wallet-withdraw-status 的副作用）。- 凭证/证书未配置时所有转账类调用抛
WxPayNotConfiguredError，api 层翻成503。