操作手册

建档：点击「添加员工」，选择国家后系统自动加载该国银行目录并带出默认币种；银行名称与银行代码双向联动检索，选中自动互填，也支持手动录入。手机号与证件号码为 EASYLINK 等实名渠道发薪必需。

批量导入：「模板下载」获取标准 Excel（姓名必填；同邮箱自动更新覆盖；实发 = 基本 + 津贴 − 代扣；最多 500 行），「导入 Excel」解析预览确认后提交，结果展示新建 / 更新 / 失败行明细。

维护：支持按关键字（姓名/邮箱/银行/部门/银行名称）、国家、状态筛选；编辑与删除仅限拥有 employees:write 权限的角色。

① 人事建单（草稿）→ ② 提交财务审核 → ③ 财务审核（通过 / 驳回退回草稿并记录意见）→ ④ 出纳发放 → ⑤ 平台超管审核放行（管理端需 Google 动态码）→ ⑥ 提交上游渠道出款 → ⑦ 终态回写工资单与批次。

出纳发放后批次进入「待平台审核」；平台放行时才创建订单并冻结资金、提交上游。任一环节驳回即退回上一环节。订单终态由后台同步任务（默认 15s）回写工资单与批次。

批次状态机：0 草稿 / 1 待财务审核 / 2 已审核（待出纳发放或发放中，由「已建单数」区分）/ 3 全部成功 / 4 失败。批次明细页展示合计金额、费用预估与折合 IDR（汇率以提交上游时锁定为准）。

「新建代付」填写：商户单号（全局唯一，≤32 位）、收款国家与币种（随国家联动）、金额、收款人姓名 / 手机号 / 证件号码（实名渠道必填）、银行与账号、用途与备注；可留空渠道由系统按商户-国家渠道目录自动匹配。

幂等防重：重复提交同一商户单号不会重复出款；API 下单可附加 X-Idempotency-Key。

订单状态机：0 待处理 / 1 处理中 / 2 成功 / 3 失败 / 4 退汇。失败与退汇资金自动解冻退回账户；成功订单可在详情中查看「到账回执」并打印 / 保存 PDF。

充值：商户余额由平台统一入账，不支持自助充值——联系客服获取对公收款账户 → 转账 → 提供付款凭证 → 客服核对后入账。

流水：交易流水与变账记录双视图，均支持 CSV 导出；变账记录含变动前后余额（可用 / 冻结），可试算闭合。金额正负着色：出款红、入账/退回绿。

对账：按日汇总订单总数、总金额、对平 / 未对平与状态分布，空态提示当日无订单。

API 密钥：密钥打码展示、公钥可复制；「轮换密钥」后原密钥立即失效，新密钥仅展示一次，请立即妥善保管。私钥仅生成时展示一次，用于 API 请求签名。

IP 白名单：绑定后仅白名单内 IP 可调用 API（支持 IPv4 与 CIDR 网段，变更即时生效）；未绑定默认全放行。建议加入公司出口与服务器 IP。

两步验证：绑定 Google Authenticator 后，登录与敏感操作需输入 6 位动态码；子账户首次登录同样需绑定。

按收款国家返回该国银行下拉目录：GET /api/banks?country=CN。数据源为平台渠道银行目录：由平台每日同步一次上游银行清单（24h 缓存），拉取失败时降级到内置静态银行列表。员工表单的银行名称/代码检索与代付下单的银行下拉均使用该目录。

业务字典（状态/类型枚举文案）：GET /api/dicts，供页面下拉与徽章渲染。

开发者接入（签名机制、幂等、错误码、回调）见 API 文档。