接入微信支付与支付宝

把组织自己的微信支付商户号或支付宝应用接到 Raise 后，经营、会员等应用可以向顾客发起扫码收款。款项直接进你自己的商户账户，平台不代收、不托管。

Raise 这边的设置在「我的组织」→「应用」→「收款设置」，界面说明见收款设置。本页讲在商户平台和开放平台里去哪里取每一项。

注意

下面的商户平台、开放平台菜单路径按公开文档整理，没有对着真实商户后台核对过，以对方后台的最新说明为准。

开始前准备

• 微信支付：一个直连商户号（不支持服务商模式），以及与它绑定的公众号或小程序 AppID。
• 支付宝：支付宝开放平台的账号，能创建应用。
• Raise 里「管理员」角色的账号。收款设置只能由管理员本人修改，助手不能代办。

微信支付

1. 在微信支付商户平台开通「Native 支付」。

2. 在商户平台取得以下各项，填进 Raise「微信支付」卡片的同名字段：

   Raise 字段	去哪里取
   「AppID」	商户平台 → 产品中心 → AppID 账号管理。与商户号绑定的公众号或小程序 AppID
   「商户号」	商户平台首页「账户信息」，8–12 位数字
   「商户 API 证书序列号」	商户平台 → 账户中心 → API 安全 → 管理证书。也可对 apiclient_cert.pem 执行 openssl x509 -noout -serial
   「微信支付公钥 ID」	API 安全 → 微信支付公钥里的公钥 ID（PUB_KEY_ID_ 开头）。还在用平台证书的，填平台证书序列号
   「商户私钥」	申请 API 证书时下载的 apiclient_key.pem，整段粘贴（含 BEGIN / END 两行）
   「微信支付公钥（或平台证书）」	上一项公钥 ID 对应的 pub_key.pem 或平台证书，整段粘贴
   「APIv3 密钥」	API 安全 → 设置 APIv3 密钥，正好 32 个字符

3. 点卡片底部的「保存」。校验不通过时什么都不保存，卡片显示「没有保存」和原因。

4. 点「测试配置」，通过后打开卡片右上角的启用开关。

微信支付没有沙箱，测试请用试一笔 0.01 元。

支付宝

1. 在支付宝开放平台创建应用，开通「当面付」或「电脑网站支付」。

2. 用支付宝「密钥工具」生成 RSA2（2048 位）密钥对。把应用公钥上传到开放平台这个应用里，开放平台随后会显示「支付宝公钥」。

3. 填进 Raise「支付宝」卡片：

   Raise 字段	去哪里取
   「应用 AppID」	开放平台 → 控制台 → 我的应用里的 AppID，10–20 位数字
   「卖家 PID（可选）」	开放平台账户中心里 2088 开头的 16 位数字。填了以后，付款通知里的卖家必须是它
   「应用私钥」	第 2 步生成的私钥，整段粘贴
   「支付宝公钥」	上传应用公钥后开放平台显示的「支付宝公钥」，不是你的应用公钥。PEM 或那一长串字符都行

4. 联调阶段可以打开「沙箱环境」，连支付宝沙箱网关，不会真实扣款。正式收款前必须关闭。

5. 点「保存」，再点「测试配置」，通过后打开启用开关。

回调地址

渠道保存后，卡片上会出现「回调地址」，点代码块可以复制。

• 一般不用在商户平台或开放平台填写：它随每一笔订单一起发给支付渠道。
• 怀疑地址泄露、或顶部提醒有签名验证失败的通知时，点「重新生成」。旧地址失效；尚未付款的订单会由平台主动查询，付款不会丢，结果可能稍晚。

测试

1. 渠道卡片保存后，点「测试配置」。它用已保存的配置向渠道发一次只读请求，验证商户号和密钥。有未保存的修改时按钮不可用。
2. 测试通过，再点页面右上角「试一笔 0.01 元」，选渠道（支付宝可选扫码或电脑网站支付），用对应 App 扫码付 1 分钱。
3. 付款后提示「收到了这一笔，渠道配置正常」。这笔钱进你自己的商户账户，可在「订单」页签里全额退回。

任何保存（包括只切换启用开关）都会清空之前的测试结果，需要再测一次。

常见问题

测试显示「测试没有通过」？

卡片提示「请检查密钥和商户号。」，「渠道返回：」后面是支付渠道给的原文。按原文核对对应字段，保存后再测。

保存时提示「这里要的是公钥，看起来粘贴了私钥」？

公钥栏和私钥栏贴反了。支付宝那栏要的是开放平台显示的「支付宝公钥」，不是自己生成的应用公钥。

提示「APIv3 密钥必须正好 32 个字符」？

到商户平台 API 安全里核对，或重新设置一个 32 个字符的 APIv3 密钥。

目前不支持

• 微信支付服务商模式、子商户、分账。
• App 支付。