运营指南导读
本文档体系面向运营、风控、客服、产品同学，用通俗中文说明 LOCAL 跑分通道下的选卡、代收、代付与爬虫对账逻辑。
在线阅读（按章导航）：部署后见 operations-guide-site/README 中的生产 URL。
1. 适用范围
- LOCAL 通道：通道编码以 LOCAL 开头的代收、代付订单（平台内跑分用户接单，非外部三方通道全自动回调）。
- 时区：文中「今天」「近 10 分钟」等均指 印度时间（IST，UTC+5:30）。
- 不包含：USDT 充值、纯外部通道（如部分三方代付）的完整产品说明；研发接口文档见仓库内
PAYMENT_GATEWAY_API.md等。
2. 建议阅读顺序
| 顺序 | 篇次 | 何时需要看 |
|---|---|---|
| 1 | 第 1 篇：LOCAL 通道选卡策略 | 商户代收创单失败 / 无卡可派 / 派单慢 |
| 2 | 第 2 篇：订单主单与子单 | 搞不清「主单 / 子单」状态含义 |
| 3 | 第 3 篇：三端账户余额怎么变 | 排查「钱去哪了」「为什么余额变了」 |
| 4 | 第 4 篇：LOCAL 代收全流程 | 收款单超时、未到账、补单 |
| 5 | 第 5 篇：LOCAL 代付全流程 | 代付待处理、抢单超时、流转下游 |
| 6 | 第 6 篇：爬虫与账单匹配 | 审核中久未出结果、UTR 对不上 |
| 7 | 第 7 篇：异常、重试与重认证 | 钱包掉线、上游繁忙、重认证后补单 |
| 8 | 第 8 篇：常见问题与参数表 | 日常速查 |
附录：代付匹配与账单待定（代付「处理中」挂起、72 小时兜底等专题详解）
3. 章节索引
| 篇次 | 标题 | 一句话 |
|---|---|---|
| 导读 | 本页 | 怎么读这份指南 |
| 第 1 篇 | LOCAL 通道选卡策略 | 创单前挑哪张卡接单 |
| 第 2 篇 | 订单主单与子单 | 两层订单与状态含义 |
| 第 3 篇 | 三端账户余额怎么变 | 商户 / 跑分 / 冻结登记 |
| 第 4 篇 | LOCAL 代收全流程 | 用户付款到成交或关单 |
| 第 5 篇 | LOCAL 代付全流程 | 抢单出款到成交或回池 |
| 第 6 篇 | 爬虫与账单匹配 | 拉账单与对账规则 |
| 第 7 篇 | 异常、重试与重认证 | 失败与补救机制 |
| 第 8 篇 | 常见问题与参数表 | FAQ 与时间表 |
| 附录 | 代付匹配与账单待定 | 代付四种结局与账单待定专题 |
4. 与研发文档的边界
| 类型 | 位置 | 用途 |
|---|---|---|
| 运营指南（本体系） | paisa/docs/operations-guide/chapters/ |
业务规则、状态、资金、运营话术 |
| 接口规范 | paisa/docs/PAYMENT_GATEWAY_API.md |
商户对接 API |
| 代付账单待定附录 | 第 9 篇 / 附录 | 账单「处理中」挂起细则 |
| 架构示意 | paisa/docs/score-running-architecture.md |
技术架构参考 |
修改业务逻辑时，须同步更新对应章节并重新构建部署静态站（见仓库 .cursor/rules/operations-guide.mdc）。
5. 维护约定（给编辑者）
- 唯一正文：各章 Markdown 只维护在
operations-guide/chapters/；勿在指南外另写第二份 LOCAL 运营说明。 - 文风：避免 Java 枚举名、函数名、数据库字段名；用「支付中」「审核中」等中文状态。
- 部署：在
paisa/docs/operations-guide-site执行./deploy.sh "变更说明"，生产站点与选卡文档共用 Cloudflare Pages（见该目录 README）。
下一篇 → 第 1 篇：LOCAL 通道选卡策略