微信支付集成：基于 APIv3 的扫码支付

微信支付是国内数亿人在线付款的方式。ShipAny 内置基于 APIv3 的原生微信支付渠道，用你自己的商户号直接收取人民币。

ShipAny 帮你做了什么

• Native 扫码支付：ShipAny 调用 /v3/pay/transactions/native 创建交易，把用户带到二维码页面，用微信扫码付款。
• 支付通知：/api/payment/notify/wechat 用 APIv3 密钥解密通知，并按微信要求返回 { code: "SUCCESS" }。
• 订单查询：按商户订单号兜底查询，即使通知延迟也能确认已支付的订单。
• 订单与积分：支付成功后，在同一个事务里把订单标记为已支付并发放积分。
• 测试金额：以「分」为单位，上线前可以用 0.01 元跑通流程。

原生微信支付用于一次性付款。周期订阅请使用 Stripe 或 Creem。

配置步骤

1. 在微信支付商户平台确认商户号已开通 Native 支付，并与 AppID 完成绑定。
2. 设置 32 位的 APIv3 密钥，申请商户 API 证书，记下证书序列号和商户私钥（PEM）。
3. 在 ShipAny 中打开 管理后台 → 设置 → 支付 → WeChat Pay：打开 Enable WeChat Pay，填入 AppID、商户号、APIv3 密钥、商户私钥、证书序列号，以及通知地址 https://<你的域名>/api/payment/notify/wechat。
4. 把测试金额设为 1，扫码支付 0.01 元验证，上线前记得清空。

注意事项

• APIv3 密钥必须正好 32 位，否则无法解密支付通知。
• 证书序列号要和上传的私钥对应，不匹配时创建交易会报签名错误。
• 同时面向海外用户？Stripe 也能在一次性付款中提供微信支付，不需要国内商户号。