商户后台使用说明
登录与安全、测试与生产环境、5 个固定角色、菜单速览，以及退款、争议材料、结算、密钥轮换、变更收款账户等常见操作。
最后更新于 2026-10-16 · 契约 v1.0.0
登录与安全
- 由所有者或管理员邀请加入，邀请默认 72 小时内有效；首次登录设置密码。
- 需要 MFA 的角色在登录流程中完成身份验证器绑定后才能进入后台。
- 敏感操作需要二次认证（输入动态码）：成功后默认 5 分钟内，本次登录的其他敏感操作不再询问；默认连续 5 次输错锁定 15 分钟。
- MFA 设备丢失时不提供恢复码：普通成员由所有者或管理员重置；所有者由另一名所有者重置；唯一的所有者联系平台线下核验身份后重置。
- 忘记密码时在登录页找回；加入多个商户时在顶栏切换商户。
说明
本页标注“默认”的时长与次数由平台统一设置，平台可在允许范围内调整；实际以商户后台显示的失效时间或提示为准。
测试与生产环境
- 顶栏“生产 / 测试”按钮切换环境；测试环境显示橙色横幅“当前为测试环境 · 数据不产生真实资金”。
- 两个环境的数据、API Key、Webhook 端点相互隔离。
- 生产尚未开通时，生产环境显示开通说明。
角色说明
| 角色 | 主要能做 | 不能做 |
|---|---|---|
| 所有者 | 全部功能；唯一可以申请变更收款账户、转移所有权（均需二次认证） | — |
| 管理员 | 管理普通员工、API Key、Webhook、回跳地址；查看资金、导出报表、发起退款 | 变更或授予所有者；修改平台设定的费率、限额、结算周期 |
| 财务 | 查看余额、费用、结算；导出财务报表；发起退款；上传争议材料 | 管理 API Key、Webhook、团队 |
| 开发者 | 在“可授予 API 范围”内管理 API Key；配置 Webhook、回跳地址；查看开发日志；查看支付与退款（付款人信息脱敏） | 查看余额、费用、结算；发起退款 |
| 只读人员 | 查看支付与退款；开启“可查看资金”后可看余额、费用、结算 | 任何写操作；导出 |
成员级设置（所有者、管理员可改）：只读人员的“可查看资金”（默认关）；开发者的“可授予 API 范围”（默认 payments:read、payments:write、refunds:read）。角色固定，不能自定义。
费率、限额、结算周期由平台设定，商户（包括管理员）不能自行修改；生产费率调整至少提前 24 小时通知。
菜单速览
| 菜单 | 页面 | 功能简述 | 后台入口 | 可见角色 |
|---|---|---|---|---|
| 概览 | 概览 | 成功交易额、退款、待处理事项等（按权限裁剪） | 打开（在新标签页打开商户后台） | 全部 |
| 交易管理 | 支付订单 | 按支付号、商户订单号、时间、状态、币种、金额、接入方式、卡品牌与后四位查询 | 打开（在新标签页打开商户后台） | 全部 |
| 交易管理 | 订单详情 | 金额、状态、尝试记录、3DS 结果、费用、退款汇总、结算情况、通知时间线 | 支付订单 › 订单详情 | 全部开发者看到的付款人信息脱敏、不显示费用 |
| 交易管理 | 申请退款 | 在订单详情中发起，显示可退金额与资金占用 | 订单详情内弹窗 | 所有者、管理员、财务 |
| 交易管理 | 退款记录 / 退款详情 | 退款状态、金额、退回资金、审核结果；平台异常退款只读展示（来源“异常退款”） | 打开（在新标签页打开商户后台） | 全部 |
| 交易管理 | 争议案件 / 详情与材料提交 | 案件、证据截止时间、材料上传 | 打开（在新标签页打开商户后台） | 所有者、管理员、财务、只读人员 |
| 资金管理 | 余额概览 | 按币种展示 7 个余额桶 | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务、只读人员只读人员需开启“可查看资金” |
| 资金管理 | 账务流水 | 来源业务、增减、余额桶、发生与记账时间 | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务、只读人员只读人员需开启“可查看资金” |
| 资金管理 | 结算单 / 结算单详情 | 账期、明细、手续费、打款金额、账户尾号、结果 | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务、只读人员只读人员需开启“可查看资金” |
| 资金管理 | 打款记录 | 打款状态与参考号 | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务、只读人员只读人员需开启“可查看资金” |
| 资金管理 | 对账单与报表 | 按环境、币种、时间导出 CSV（导出任务） | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务 |
| 开发者中心 | API Key / 密钥详情 | 创建、轮换、撤销；使用记录 | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 开发者中心 | Webhook 配置 | 端点、订阅事件、签名密钥轮换（密钥只在创建与轮换时展示一次）、测试发送 | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 开发者中心 | API 调用记录 | 按 request_id、路径、状态查询（日志最长保留 30 天） | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 开发者中心 | 事件投递记录 | 事件与每次投递的结果 | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 开发者中心 | 回跳地址白名单 | 登记 return_url、cancel_url 规则 | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 开发者中心 | 接口文档与测试指南 | 进入本文档站；登录后查看测试卡取值 | 打开（在新标签页打开商户后台）（需要所有者、管理员或开发者） | 所有者、管理员、开发者 |
| 团队管理 | 员工 / 邀请记录 / 固定角色说明 | 邀请、改角色、停用；邀请状态 | 打开（在新标签页打开商户后台）（需要所有者或管理员） | 所有者、管理员 |
| 团队管理 | 所有权转移 | 二次认证后发起，受让人接受后生效 | 打开（在新标签页打开商户后台）（需要所有者） | 所有者 |
| 商户设置 | 基本信息 | 商户资料、状态与能力（只读部分由平台设定） | 打开（在新标签页打开商户后台） | 全部财务、开发者、只读人员只读 |
| 商户设置 | 收款账户 | 查看脱敏账户；所有者申请变更 | 打开（在新标签页打开商户后台）（需要所有者、管理员或财务） | 所有者、管理员、财务管理员、财务只读 |
| 商户设置 | 通知联系人 | 技术、财务、争议、业务联系人 | 打开（在新标签页打开商户后台） | 全部所有者、管理员可编辑 |
| 商户设置 | 登录安全 | 密码、MFA、会话 | 打开（在新标签页打开商户后台） | 全部 |
| 商户设置 | 操作日志 | 操作人、动作、目标、脱敏变更、IP、时间 | 打开（在新标签页打开商户后台）（需要所有者或管理员） | 所有者、管理员 |
| 顶栏 | 通知中心 | 站内通知（显示全部环境的通知，每条带环境标签，可按环境筛选） | 打开（在新标签页打开商户后台） | 全部 |
常见操作
发起退款
可操作的角色：所有者、管理员、财务
- 交易管理 › 支付订单，找到并打开订单详情（支付订单（在新标签页打开商户后台））。
- 点【申请退款】，填写退款金额（全额也要填写具体金额）、原因、商户退款号；弹窗显示可退本金与资金占用。
- 提交后状态为“待审核”（测试环境默认自动批准，直接进入“处理中”）；平台审核通过后进入“处理中”，最终“退款成功”或“退款失败”，结果见站内通知与退款详情。
- 商户资金不足时不受理（不生成退款单）并提示差额，平台不会自动缩减退款金额或垫付。可以线下补款，平台财务登记后重新提交；或请平台评估动用你的保证金或风险冻结资金，批准后 7 天内用同一商户退款号与金额重新提交即自动使用。
- 已提交的退款不能自行取消。
上传争议材料
可操作的角色：所有者、管理员、财务
- 收到“新争议”通知后进入交易管理 › 争议案件，打开案件（争议案件（在新标签页打开商户后台））。
- 查看争议原因、金额与证据截止时间（换算为你的显示时区并显示剩余时间）。
- 上传订单、交付、服务记录、沟通记录等材料：PDF、JPG、PNG、TXT、CSV，单个文件不超过 10 MB、单个案件合计不超过 50 MB；安全扫描通过后才能提交。
- 提交后由平台向上游提交并记录；临近截止时会提醒，结案时通知结果；资金影响以真实资金事件为准。
- 过了截止时间不能通过修改日期恢复。
查看结算单
可操作的角色：所有者、管理员、财务、只读人员
- 资金管理 › 结算单，按币种、状态、时间筛选（结算单（在新标签页打开商户后台）（需要所有者、管理员或财务））。
- 打开详情：账期（业务时区）、来源明细、占用金额 S、结算手续费 F、银行打款金额 S − F、收款账户快照（尾号）、打款状态与银行参考号。
- 结算单显示“平台审核中”时由平台审核；打款显示“处理中（银行确认中）”时请等待平台确认，平台不会重复打款；发生退汇时打款与结算单变为“已退汇”，原成功记录保留，退回资金回到待结算后重新评估，平台不会自动用原账户重新打款，请核对收款账户。
- 需要明细文件时到对账单与报表导出。只读人员需要开启“可查看资金”。
轮换 API Key
可操作的角色：所有者、管理员、开发者
- 开发者中心 › API Key，选择要轮换的 Key，点【轮换】（API Key（在新标签页打开商户后台）（需要所有者、管理员或开发者）；生产需二次认证，开发者限其可授予范围）。
- 新 Key 的完整值只显示一次，立即存入密钥管理服务；为旧 Key 设置失效时间（重叠期不超过 24 小时）。
- 部署新 Key 后，在密钥详情确认旧 Key 的“最近使用时间”不再更新。
- 到期自动失效，或在密钥行的「更多」菜单中点【撤销】手动撤销旧 Key；怀疑泄漏时直接撤销，60 秒内阻断。
- 轮换 Key 不改变幂等作用域，也不影响 Webhook 签名密钥。
轮换 Webhook 签名密钥
可操作的角色：所有者、管理员、开发者
- 开发者中心 › Webhook，点【轮换签名密钥】（需二次认证；签名密钥遗失时也用此操作，平台不提供查看已有密钥）：Webhook 配置（在新标签页打开商户后台）（需要所有者、管理员或开发者）。
- 新密钥只显示一次，立即存入密钥管理服务；重叠期（最长 24 小时）内平台同时用新旧密钥签名，把新密钥加入你的验签配置并部署。
- 重叠期结束后从配置中删除旧密钥，详见签名密钥与轮换。
变更收款账户
可操作的角色：所有者
- 商户设置 › 收款账户，点【申请变更】（仅所有者，需二次认证）：收款账户（在新标签页打开商户后台）（需要所有者、管理员或财务）。
- 填写账户持有人、银行名称、账号及所在地区要求的字段；提交后账号只显示尾号。
- 平台复核；审核通过后进入冷静期（至少 24 小时），期间不用于新的打款。
- 冷静期结束后生效，只用于新生成的结算单；已生成的结算单保留原账户快照；尚未执行且使用旧账户的结算单会被取消并重新生成。
邀请成员
可操作的角色：所有者、管理员
- 团队管理 › 员工，点【邀请】，填写邮箱并选择角色（管理员不能授予所有者）：员工（在新标签页打开商户后台）（需要所有者或管理员）。邀请管理员、财务或开发者时需要二次认证。
- 邀请默认 72 小时内有效，可撤销、重发（重发管理员、财务或开发者的邀请同样需要二次认证）；对方接受后成为成员。
- 需要时在成员设置中调整开发者的“可授予 API 范围”、只读人员的“可查看资金”。
导出对账单与报表
可操作的角色：所有者、管理员、财务
- 资金管理 › 对账单与报表，选择报表类型（支付明细、退款明细、账务流水、结算明细、费用汇总、争议报表）、环境、币种、时间范围与时区。
- 创建导出任务，完成后收到通知；导出文件最长保留 24 小时，期间每次点击下载都会生成短时有效的下载链接（默认 60 秒）。
- 下载时会重新校验你的权限；权限被撤销后，未过期的文件也不能再下载。
常见问题
这页有帮助吗？