外观
收款设置
组织管理员在这里配置微信支付与支付宝商户号。款项直接进入你自己的商户账户，平台不代收、不托管。配置并启用收款渠道后，经营、会员等业务应用才能向顾客发起扫码收款。你也可以在此发起「试一笔 0.01 元」测试收款并查看订单记录。
谁能用
- 角色要求：仅「管理员」可以使用。系统导航表只为管理员提供「收款设置」入口，「审计员」「分析员」「成员」在侧栏看不到此功能。
- 无权限访问：若无权限账号直接打开页面地址，界面显示空状态「没有权限」，并提示「你的账号角色不允许查看这个页面。请联系租户管理员。」。
- 读取权限：管理员本人可以查看；管理员的助手可代读（助手回答中不包含回调地址、付款链接与密钥）。
- 写入权限：保存渠道配置、测试配置、更换回调地址、发起测试收款、取消收款、全额退款、重新结算等操作，必须由管理员本人在界面上完成。助手令牌或支持授权均不能代为修改，助手会提示「收款设置只能由管理员本人修改」。
- 业务订单限制：业务应用收取的款项必须在来源应用中取消或退款，本页面不能对有来源应用的订单执行取消收款或退款。
- 服务依赖：若当前部署环境未安装收款服务，界面提示「这个部署没有收款服务」。「我的组织」对每个组织常驻，不能卸载。
怎么打开
- 在工作台左侧进入「行政」分组。
- 点击「我的组织」，在导航中选择「应用」分组。
- 点击「收款设置」进入页面。
页面默认打开「收款渠道」页签，也可切换到「订单」页签。
浏览器页签标题由「我的组织」、分组「应用」、页名「收款设置」与当前页签（「收款渠道」或「订单」）用「 · 」拼接而成。
界面一览
页头与全局提醒
- 1页头「收款设置」：用自己的商户号，平台不代收
- 2「试一笔 0.01 元」：渠道配好后才测；本清单不发起真实支付
- 3页签「收款渠道」「订单」
- 4固定两张卡：微信支付、支付宝；未配置也出空卡
- 页头区域：展示标题「收款设置」，说明文字为「使用你自己的商户号，款项直接进你的商户账户。」。右上角提供「试一笔 0.01 元」按钮。页面概览数据约每 30 秒自动刷新一次。数据加载时显示骨架屏，出错时显示通用错误状态并支持重试。
- 顶部提醒（满足特定条件时显示）：
- 结算失败提醒：当有已付款订单向业务应用记账重试满 12 次仍未入账时，显示提醒标题，说明有若干笔订单已付款但没有记入业务应用，正文显示「款项已到账，经营或会员的记账失败。」，可点击「查看这些订单」自动切换至「订单」页签并将筛选条件设为「结算失败待处理」。
- 异常通知提醒：过去 24 小时收到异常付款通知时显示，标题为「过去 24 小时有异常的付款通知」，内容包括签名验证失败次数（提示若干次通知签名验证失败，已拒绝，持续出现请检查密钥或重新生成回调地址）以及金额不符次数（提示若干次通知金额与订单不符，已拒绝并记入审计日志，请到商户平台核对）。
功能页签
| 页签 | 主要内容与布局 | 说明 |
|---|---|---|
| 「收款渠道」 | 固定展示两张卡片：「微信支付」与「支付宝」（未配置时也展示空卡片） | 默认页签。卡片内展示渠道名称、当前状态、产品说明、获取位置指引、配置字段、密钥状态徽标、回调地址、测试结果以及操作按钮 |
| 「订单」 | 展示所有收款订单明细列表，页签触发器带有待付徽章 | 存在待付款订单时显示待付笔数徽章。包含按状态筛选下拉框、桌面端数据表格（移动端一行一单）、分页栏与行操作菜单，约每 15 秒自动刷新 |
常用操作
配置微信支付
- 1「AppID」：与商户号绑定（示例 wx…）
- 2「商户号」：8–12 位数字（示例占位）
- 3证书序列号与下方密钥：不要贴真实 pem / APIv3 密钥
- 在微信支付商户平台开通「Native 支付」并取得下面各项（微信支付仅支持直连商户）。每一项去哪里取，见接入微信支付与支付宝。
- 在「收款设置」页面的「收款渠道」页签中，找到「微信支付」卡片。
- 填写微信支付配置项：
字段 必填 说明 「AppID」 是 填写与商户号绑定的 AppID（公众号或小程序）。输入框占位显示「wx…」 「商户号」 是 微信支付商户号，为 8–12 位数字 「商户 API 证书序列号」 是 商户 API 证书的序列号，十六进制字符串 「微信支付公钥 ID」 是 微信支付公钥 ID（以 PUB_KEY_ID_开头）。若仍在使用平台证书，填写平台证书序列号「商户私钥」 密钥，已存可留空 申请 API 证书时下载的 apiclient_key.pem，整段粘贴（必须包含 BEGIN 与 END 两行） 「微信支付公钥（或平台证书）」 密钥 上述公钥 ID 对应的 pub_key.pem 或平台证书，整段粘贴。用于验证微信的应答和付款通知 「APIv3 密钥」 密钥，密码框 必须正好 32 个字符。用于解密付款通知 - 点击卡片底栏的「保存」。
- 若校验失败，卡片标题显示「没有保存」，提示「校验未通过，未保存：」及具体原因，系统不会保存任何改动。
- 保存成功后，系统提示微信支付的配置已保存，请重新「测试配置」。保存后此前的测试结果作废。
- 点击底栏「测试配置」按钮。系统使用已保存的配置向微信支付网关验证商户号与密钥连通性。
- 测试通过后，打开卡片右上角的「启用」开关。开启后系统提示「已启用……」。
提示
微信支付没有沙箱环境，卡片说明标注「微信支付没有沙箱，测试请用右上角「试一笔 0.01 元」。」。配置保存后系统会自动生成「回调地址」，并提示「一般不用在商户平台填写。」，通常无需手动在微信商户后台登记。
配置支付宝
- 在支付宝开放平台创建应用，开通「当面付」或「电脑网站支付」，并取得下面各项。怎么做见接入微信支付与支付宝。
- 在「收款渠道」页签中，找到「支付宝」卡片。
- 填写支付宝配置项：
字段 必填 说明 「应用 AppID」 是 支付宝应用的 AppID，为 10–20 位数字。应用须已开通「当面付」或「电脑网站支付」 「卖家 PID（可选）」 否 2088 开头的 16 位数字。填入后，付款通知中的卖家必须与该 PID 一致 「应用私钥」 密钥 RSA2（2048 位）密钥对的私钥，整段粘贴 「支付宝公钥」 密钥 「支付宝公钥」（非应用公钥）。支持 PEM 格式或一长串字符（须 ≥ 2048 位） - 若在联调测试阶段，可开启卡片上的「沙箱环境」开关（说明显示「连支付宝沙箱网关，不会真实扣款。正式收款前必须关闭。」）。
- 点击卡片底栏的「保存」。通过校验后配置生效。
- 点击底栏「测试配置」按钮测试连通性。
- 测试通过后，打开卡片右上角的「启用」开关。开启后系统提示「已启用……」。
注意
支付宝沙箱环境仅用于联调，正式上线向顾客收款前必须关闭「沙箱环境」。
测试渠道配置
- 确保渠道卡片配置已保存且无未保存的修改。若有未保存的改动，卡片提示「有未保存的修改，「测试配置」用已保存的配置。」且「测试配置」按钮禁用。
- 点击卡片底栏的「测试配置」。
- 查看卡片上的测试反馈：
- 未测试过：显示「还没有测试过。保存后点「测试配置」。」。
- 测试通过：显示「测试通过 · ……」及时间，说明「密钥和商户号可用。建议再「试一笔 0.01 元」。」。
- 测试失败：显示「测试没有通过 · ……」及时间，说明「请检查密钥和商户号。渠道返回：」及渠道返回的原文。
提示
任何保存操作（包括仅修改启用开关）都会清空此前的测试结果，卡片会重新显示「还没有测试过。保存后点「测试配置」。」。
重新生成回调地址
- 在已配置的渠道卡片中查看「回调地址」区域。可点击代码块复制完整地址。
- 若遇到通知异常或密钥泄露风险，点击「重新生成」。
- 在弹出的「重新生成回调地址？」确认弹窗中查看说明：「旧地址失效。尚未付款的订单会由平台主动查询，付款不会丢，结果可能稍晚。」。
- 点击弹窗中的「重新生成」按钮。
- 完成后提示「已生成新的回调地址」。
停用收款渠道
- 在需要停用的渠道卡片右上角，关闭启用开关。
- 关闭后系统提示「已停用……，已有订单仍可查询和退款」。停用后该渠道不能发起新收款，但已有订单仍可查询、关闭、退款及接收异步通知。
发起测试收款（试一笔 0.01 元）
- 点击页面右上角「试一笔 0.01 元」按钮。若当前没有已配置且已启用的渠道，系统提示「没有可用的渠道。先配置、测试并启用一个渠道。」。
- 在弹出的「试一笔 」对话框（金额为 ¥0.01）中：
- 查看说明文字：「真实付款 1 分钱，进你自己的商户账户，可在订单里退回。」。
- 在「收款渠道」下拉菜单中选择一个已启用的渠道。若开启了沙箱环境，渠道名称旁会标注「（沙箱）」。
- 若该渠道支持多个支付产品，在「支付方式」下拉菜单中选择：「扫码支付」「扫码支付（当面付）」或「电脑网站支付（跳转收银台）」。
- 点击「生成收款码」。系统生成一笔金额为 ¥0.01、主题固定为「收款测试」的测试订单，默认有效时间为 15 分钟（该订单不计入经营或会员账目）。
- 在弹出的「试一笔收款」对话框中完成付款：
- 扫码支付：界面显示渠道徽标（「微信支付」或「支付宝」）、金额
¥0.01、主题「收款测试」与付款二维码（无障碍标签为渠道名加「付款二维码」）。提示「请用」「微信」或「支付宝」「扫一扫 · 」，显示有效倒计时（「…… 内有效」或「等待付款」）。使用对应 App 扫码完成支付。 - 电脑网站支付：界面提示「这笔收款用支付宝收银台完成：点下面的按钮打开，付款后回到这里。」，点击「打开支付宝收银台」或「复制付款链接」前往完成付款。
- 状态轮询与反馈：
- 付款过程中对话框约每 2.5 秒轮询一次支付状态。
- 若连续 3 次及以上查不到付款结果，提示「暂时查不到付款结果，仍在重试。已付款的话，款项不会丢，稍后会自动入账。」。
- 付款成功后显示「支付成功」，弹出提示「收到了这一笔，渠道配置正常」，约 1.8 秒后对话框自动关闭。
- 若二维码超时未付显示「二维码已过期」及「未在有效期内完成，没有扣款，可重新生成。」（超时后系统仍会继续查询约 90 秒）；点击取消显示「订单已关闭」及「已取消，没有扣款。」；若渠道拒绝显示「下单失败」及「支付渠道拒绝，没有扣款。请检查「收款设置」后重试。」。可点击「重新生成」重新发起。
- 扫码支付：界面显示渠道徽标（「微信支付」或「支付宝」）、金额
查看与筛选订单
- 1应用里收的款须在该应用里取消 / 退款；本页只管本页试单
- 2页签「订单」
- 点击「订单」页签进入订单列表。有待付订单时，页签触发器显示待付笔数徽章。
- 使用顶部的状态筛选下拉框（无障碍标签为「按状态筛选」）过滤列表，可选状态包括：
- 「全部状态」
- 「待付款」
- 「已付款」
- 「已退款」
- 「已关闭」
- 「失败」
- 「结算失败待处理」
- 查看订单列表各列数据：
- 「时间」：订单创建时间，按月-日 时:分展示（24 小时制）。
- 「订单」：展示订单主题与商户订单号。
- 「渠道」：展示支付渠道名称。
- 「金额」：收款金额；已退款订单额外展示「已退 」加具体退还金额。
- 「状态」：订单当前所处状态。
- 「来源」：展示来源业务应用，包括「经营」「会员」或其他应用名称；测试订单显示为「管理员测试」。
- 列表按创建时间倒序排列，每页固定展示 20 笔，约每 15 秒自动刷新。底部显示分页信息「第 …… 页 · …… 笔」（或「加载中…」）以及「上一页」「下一页」按钮。
- 若列表为空，无订单时提示「还没有订单」「启用渠道后，点右上角「试一笔 0.01 元」。」；筛选无匹配时提示「没有符合条件的订单」「换一个状态看看。」。
取消测试收款订单
- 点击「订单」页签，找到来源为「管理员测试」、状态为「待付款」或「创建中」的测试订单。
- 点击该行右侧的操作菜单，选择「取消收款」。
- 在弹出的「取消这笔收款？」确认对话框中查看商户订单号与金额，正文提示「客户若刚好付了款，取消会被拒绝；否则订单关闭，二维码失效。」。
- 点击对话框中的「取消收款」按钮。
- 若客户刚好完成了付款，系统会记为已付并拒绝取消，提示「对方刚刚付了款，订单已记为已付」；若尚未付款，订单关闭，二维码失效，界面提示「已提交」。
全额退款测试订单
- 点击「订单」页签，找到来源为「管理员测试」、状态为「已付款」且尚有剩余可退金额的测试订单。
- 点击该行右侧的操作菜单，选择「全额退款」。
- 在弹出的「退回这笔款？」确认对话框中核对订单号与金额，正文提示「退还这笔订单的剩余金额。微信退款需等渠道处理。」。
- 点击对话框中的「全额退款」按钮。
- 提交后系统提示「已提交」。款项将从组织的商户账户原路退回付款人，订单状态更新为「已退款」。
重新结算订单
- 当顶部显示记账失败提醒时点击「查看这些订单」，或在「订单」页签将状态筛选切换为「结算失败待处理」。
- 找到已付款或已退款、但记入业务应用失败且重试满 12 次的订单。
- 点击该行右侧的操作菜单，选择「重新结算」。
- 在弹出的「重新结算？」确认对话框中查看说明：「客户已付款但没有记入业务应用，重新结算会再试一次。」。
- 点击对话框中的「重新结算」按钮。提交后提示「已提交」。
- 系统将清空该订单（以及该订单未入账的成功退款）的重试计数，后台在下一轮自动重新向业务应用发起入账。款项本身不受影响。
状态说明
渠道状态
| 渠道状态 | 说明 |
|---|---|
| 「未配置」 | 尚未填写并保存商户参数配置。卡片右上角启用开关处于禁用状态 |
| 「已停用」 | 已保存渠道参数配置，但关闭了启用开关。不能发起新收款，已有订单仍可正常查询、关闭、退款及接收异步回调通知 |
| 「已启用」 | 渠道配置完整且已打开启用开关。业务应用扫码收款及管理员「试一笔 0.01 元」均可正常使用 |
订单状态
订单状态单向流转，不可逆流：
创建中 → 待付款 → 已付款 → 已退款未付款时可终止流转为 已关闭；下单被渠道拒绝或失败时流转为 失败。
| 订单状态 | 说明 |
|---|---|
| 「创建中」 | 订单正在向支付渠道网关请求下单 |
| 「待付款」 | 订单已创建成功，二维码已生成，等待顾客付款。页签徽章显示待付笔数 |
| 「已付款」 | 顾客已完成付款。系统先向支付网关主动查单核对金额与商户后确认，款项已进商户账户 |
| 「已退款」 | 订单款项已全额退还给付款人，列表金额旁标明「已退 」加具体退还金额 |
| 「已关闭」 | 订单在有效时间内未完成支付，或由管理员主动操作「取消收款」，二维码已失效 |
| 「失败」 | 支付渠道拒绝下单或处理失败，未发生扣款 |
| 「结算失败待处理」 | 订单已成功付款或退款，但向经营或会员应用自动记账重试满 12 次仍失败。悬停可查看上次失败错误信息 |
让助手帮你做
助手支持代为读取收款信息，或在获得你授权确认后执行相关管理动作。由于涉及资金与商户配置，助手对「收款渠道」与「收款订单」的操作风险均为高风险，必须由管理员本人核对确认。
你可以在对话中这样对助手说：
帮我把支付宝渠道的 AppID 改成 ……，先不要动密钥。 启用微信支付。 支付宝改用沙箱 / 改回正式。 换一个支付宝回调地址。 用微信发起一笔 0.01 元的测试收款。 把那笔测试收款退回去。 把入不了账的那笔订单重新入账。
助手操作交互与确认机制
| 操作类别 | 助手操作内容 | 确认交互与要求 | 风险级别 |
|---|---|---|---|
| 设置收款渠道 | 修改 AppID、商户号、序列号、公钥 ID、沙箱开关或启用状态 | 须验证管理员身份；对话提示确认「保存后，组织的应用用这里的商户账户和密钥向顾客收款：钱进入这个商户账户。」。密钥可留空沿用 | 高 |
| 更换收款回调地址 | 重新生成回调地址令牌 | 须验证管理员身份；对话提示确认「旧的回调地址立刻失效：之前发起、还没付款的订单不再收到回调，由定时查询补上结果。」 | 高 |
| 发起测试收款 | 发起一笔真实测试收款订单 | 对话提示确认「这会向支付渠道发起一笔真实的收款：付款后，钱进入组织的商户账户。」。金额最少 1 分，说明默认「收款测试」（最多 60 字），有效时间默认 15 分钟（可选 5 分钟到 2 天） | 高 |
| 取消收款订单 | 取消未付款的测试单 | 对话提示确认「关闭后，这笔订单不能再付款。」（仅能取消无来源应用的未付测试单） | 高 |
| 退款 | 原路退还测试订单款项 | 须验证管理员身份；对话提示确认「退款会把钱从组织的商户账户原路退给付款人，发出后不能撤回。」。支持部分退款，原因最多 80 字 | 高 |
| 重新入账 | 对结算失败订单重置重试计数 | 为未入账订单重新提供 12 次记账重试机会，无单独确认文案 | 高 |
注意
受安全机制限制，助手不能执行以下操作：
设置
收款设置各项参数直接在渠道卡片中进行维护：
| 设置项 | 作用 | 默认值 | 谁能修改 |
|---|---|---|---|
| 各渠道商户字段 | 配置各支付渠道的商户号、AppID、公钥、私钥等接入凭证 | 未配置 | 仅管理员本人 |
| 「启用」开关 | 控制渠道是否开放使用。关闭后无法发起新收款，已有订单仍可查、退、关、收回调 | 关（未启用） | 仅管理员本人 |
| 「沙箱环境」（仅支付宝） | 控制是否连入支付宝沙箱网关。开启时不产生真实扣款，正式收款前必须关闭 | 关 | 仅管理员本人 |
| 「回调地址」 | 接收支付网关付款通知的专属地址。遇异常可「重新生成」 | 首次保存配置时系统自动生成 | 仅管理员本人（需确认） |
| 「测试配置」结果 | 展示商户号和密钥的网关连通性验证结果（只读展示） | 无（「还没有测试过」） | 任何保存修改均会清空结果 |
展开查看：配置输入格式与校验规则
系统在保存配置时会进行前端与服务端格式校验：
- 必填提示：未填必填项提示「请填写」+ 字段名称。
- 微信商户号：必须为 8–12 位数字，否则提示「商户号是 8–12 位数字」。
- 微信 AppID：必须为 6–32 位字母、数字、下划线或短横线，否则提示「AppID 格式不对（字母、数字、下划线或短横线，6–32 位）」。
- 证书序列号：必须为十六进制字符串（0–9、A–F），否则提示「序列号是十六进制字符串（0–9、A–F）」。
- APIv3 密钥：必须正好 32 个字符，否则提示「APIv3 密钥必须正好 32 个字符」。
- 支付宝 AppID：必须为 10–20 位数字，否则提示「AppID 是 10–20 位数字」。
- 卖家 PID：必须为 2088 开头的 16 位数字，否则提示「卖家 PID 是 2088 开头的 16 位数字」。
- 公私钥混淆检查：公钥栏若粘贴了私钥提示「这里要的是公钥，看起来粘贴了私钥」；私钥栏若粘贴了公钥提示「这里要的是私钥，看起来粘贴了公钥」。
- 密钥完整性：密钥缺少结束行提示「密钥不完整：缺少 END 那一行」。
注意事项
- 资金账户与结算归属：收款资金直接进入组织自有的微信或支付宝商户账户。平台不代收、不托管、不垫付、不分账。银行卡号和支付密码均不经过平台。与平台向组织收取的套餐费用完全隔离（套餐费请参考用量与套餐）。
- 金额与币种限制：收款币种仅支持人民币（CNY），金额按整数分计算。单笔收款金额上限为 1000 万元。订单收款主题最多 60 个字符，不能包含控制字符。
- 密钥安全与审计：密钥保存至安全密钥库后，界面仅展示「已设置」徽标（附带指纹前 8 位）或「未设置」，输入框占位显示「留空不修改」，无法查看或复制私钥明文。系统审计日志仅记录被修改的字段名称与指纹，不记录密钥内容。
- 退款不可撤销：退款请求发出后由支付网关原路退回付款人，无法撤回。单笔订单累计退款金额不能超过实付金额。微信支付退款需等待渠道处理。
- 业务订单与测试订单隔离：
- 入账重试机制：业务订单付款成功后由系统后台自动向对应业务应用记账。若入账失败，系统将以 30 秒为基准倍增重试时间，上限 4 小时，最多自动重试 12 次。若重试满 12 次仍失败，订单状态变更为「结算失败待处理」，需管理员手动点击「重新结算」。
- 更换回调地址的影响：重新生成回调地址后，旧地址立刻失效。在此之前发起且尚未付款的订单不再接收旧地址回调，平台会自动发起主动查询补偿结果，付款不会丢失，但结果确认可能稍有延迟。
- 平台证书维护：微信支付平台证书若到期，需管理员手动在微信卡片中更新证书内容，系统不提供自动轮换。
目前不支持
- 服务商模式、子商户、进件申请与分账功能（仅支持直连商户）。
- App 支付。
- 渠道对账单自动下载。
- 多币种结算与发票税务对接。
- 在本页面查看订单详情抽屉、发起部分退款、填写退款原因，或自定义试单金额与有效期限。
- 平台代收与资金托管。
常见问题
为什么配置保存后，点击「测试配置」或者切换启用开关后卡片又显示「还没有测试过」？
在收款设置中，任何保存操作（包括仅开启或关闭启用开关）都会清空上一次的网关测试记录。这是系统的正常安全设计，界面会重新显示「还没有测试过。保存后点「测试配置」。」。建议在完成所有参数修改并保存后，再点击「测试配置」。
为什么在订单列表里，有些订单没有「取消收款」或「全额退款」按钮？
来自经营或会员等业务应用的订单，其行操作菜单中不提供取消或退款按钮。为了保障财务记账一致性，业务订单必须在发起该订单的业务应用内部办理取消或退款手续。本页面的「取消收款」和「全额退款」仅对来源为「管理员测试」的试单开放。
顶部提示有若干笔订单已付款、但没有记入业务应用，应该如何处理？
这表明顾客已经成功支付，款项已安全进入组织的微信或支付宝商户账户，但系统自动向经营或会员应用记账时连续重试 12 次失败。款项不会丢失，也不会被回滚。你可以点击提示中的「查看这些订单」，在对应订单的行菜单中点击「重新结算」，系统会清空重试计数并在下一轮后台调度中再次尝试入账。
微信支付可以使用沙箱环境进行测试吗？
微信支付不支持沙箱环境。微信支付卡片明确标注「微信支付没有沙箱，测试请用右上角「试一笔 0.01 元」。」。请使用真实的微信支付商户号，通过右上角「试一笔 0.01 元」发起 1 分钱真实收款来验证连通性，付款后可在订单列表中点击「全额退款」原路退回。支付宝则提供「沙箱环境」开关，开启后连接支付宝沙箱网关，但在正式对外收款前必须关闭沙箱。