SSmartPool开放平台

设计稿,未实现,未经沙箱验收。只作接口走查,不发送真实请求。基线已有能力单独列明,不代表此设计已经落地。

设计来源:支付服务 PR #17 · 提交 7d2ae11e91ecd073944f98473ef41a67cd0f6146

支付服务(易宝同款) · 5 组 · 17 个接口
组数量编号
A 易宝同款6A1—A6
B 接收易宝通知2B1—B2
C 自有接口5C1—C5
D 运维检查2D1—D2
E 旧接口2E1—E2

用途:供监控判断应用是否已经启动,不证明依赖可用。

P8另用第7个易宝接口“交易日账单下载”(bill-trade-day-download),由后台定时任务调用,不对收银台开放,不新增第18页。P1b、P8批次暂定;对账只记录差错和告警,不自动改资金状态。

D1 · 对应易宝接口

易宝名称易宝没有
接口标识易宝没有
易宝路径 / 事件易宝没有
谁调谁负载均衡 / 监控 → 本服务
基线现状已有存活端点;字段以设计稿为准,不补猜测
开发批次(计划)—(已有,不在新能力批次中改)

和易宝不一样的地方

  • 本服务自有协议,易宝没有对应接口。

后续范围(第22节)

各角色应得金额后续采用品牌总部转账、再提现,不用余额分账,另行设计;本轮不新增相关接口或执行资金操作。第一阶段分账字段仍一律拒绝。

待定问题与有条件决定

第 19 节未单列该接口专属问题;不表示已实现或已验收。

  • 未在设计稿明确的字段、类型、必填性和响应层级保持未定义,不根据示例反推 schema。
  • 设计稿主要给出用途和规则;未命名的金额、原因、状态、游标、就绪项不补造协议字段名。
逐条来源规则与上下文

就绪检查(P6)

- `GET /up` 保留为存活检查(只说明应用起来了)。
- 新增 `GET /ready`(只对负载均衡和监控开放,不对公网):
  - 数据库:能连、能读写一张心跳表、迁移是最新;
  - 缓存 / 锁存储:能取放锁(多节点时必须是共享存储,不能是本机文件);
  - C05:应用目录不是 `UnconfiguredPaymentDirectory`,幂等摘要密钥已装配;
  - 通道材料:已加载、未过期(只回布尔,不回任何密钥信息);
  - 定时任务心跳:`payment:poll` 最近一次在 60 秒内、`payment:prune-nonces` 在 10 分钟内;
  - 积压:待查订单、待投递推送、待发告警超过阈值时降级;
  - 生产环境下故障注入开关(第 21.4 节)必须是关的,开着就 503。
  - 全部通过 200,否则 503,正文只给每项 `ok` / `fail`。
- 不在就绪检查里实时调用易宝(外部依赖另做渠道延迟和错误率监控)。

部署路径与来源(部署清单 A3,Jim 第 6 条)

| 路径 | 方法 | 允许来源 |
| --- | --- | --- |
| `/api/v1/notify/yeepay` | POST | 公网 443,易宝回调来源(按《回调网络配置》用域名 `out.yeepay.com` 解析同步,不写死 IP) |
| `/api/v1/notify/yeepay/refund` | POST | 同上 |
| `/rest/v1.0/*`、`/api/v1/payments/*`(旧接口并行期) | 按各接口 | 私网,或已核实的业务后端出口 IP |
| `/api/v1/collections/*`、`/api/v1/internal/*` | POST | 私网 |
| `/ready`、`/up` | GET | 负载均衡和监控所在私网 |

- 只放行上面两条回调的**精确路径**,不放宽整个 `/api/*`。
- 验收:两条回调从公网可达;其余路径从未授权公网来源探测必须被拒(拿实际探测结果,不只看安全组 443 截图);业务调用只从私网或已核实出口成功。

不在本设计范围

- 分账、归集、资金方案、循环收款池、提现、余额(GPAY-04—GPAY-21 的资金类)。对账只做第 13.5 节的收款、退款逐笔核对(P8),分账账单、资金账单核对不在第一阶段。
- 公众号 / 小程序 / 支付宝预下单(GPAY-07)。
- 部署执行、采购、改服务器、开公网(部署方案另行审批)。
- 真实扣款和退款:只用易宝沙箱或测试商户。
- 入网(进件):门店、教练、供应链、商户池商户的入网走服务商入网接口,第一阶段不加接口(产品负责人 11/11)。
- 转账和提现(产品负责人 11/11):系统记录门店、教练、供应商、品牌总部各自应得的金额;到提现时间点由品牌总部按应得金额转给门店、教练、供应商,再自动提现到对方账户。后续阶段再设计;品牌总部转给对方用“转账”接口,**不用余额分账**。第一阶段收款、退款接口里的分账字段继续一律拒绝。后续会用到的易宝接口(只记出处,现在不设计):转账下单 `POST /rest/v1.0/account/transfer/b2b/order`(在线文档 `docs-v3/api/options_rest_v1.0_account_transfer_b2b_order.md`),结果通知 `account.business.transfer-result`;提现下单 `POST /rest/v1.0/account/withdraw/order`(Skill 的 `withdraw-order`)。
API REFERENCE 13.4.1.1payment-service-D1

D1 存活检查支付设计

供监控判断应用是否已经启动,不证明依赖可用。

契约状态:设计稿实现状态:设计未实现;基线:已有存活端点;字段以设计稿为准,不补猜测真实接口验收:未经沙箱验收
GET/upDESIGN ONLY · NO LIVE CALL
i
设计稿,未实现,未经沙箱验收

字段、规则、错误和有条件决定取自固定设计提交;只作展示,不运行请求或模拟成功。

  • 仅静态合成示例;设计未实现、未经沙箱验收;不启用模拟成功,不发送 HTTP。
设计稿 · 仅展示 · 不发送请求

01接口说明

业务端 / 模块支付服务(易宝同款) / D 运维检查
请求格式来源未定义
鉴权与权限只对负载均衡和监控所在私网开放,不对公网开放(第15、21.10节);具体请求鉴权头未明确。 · 设计展示,禁止网络请求
技术服务归属(元信息)支付服务

负载均衡 / 监控 → 本服务目录引用不授予调用权限。

来源业务约束
  • 未在设计稿明确的字段、类型、必填性和响应层级保持未定义,不根据示例反推 schema。
  • 设计稿主要给出用途和规则;未命名的金额、原因、状态、游标、就绪项不补造协议字段名。

02请求头 0 个字段

来源没有可展开的字段定义。完整约束可在「来源与状态」查看。

03请求参数 按来源列示,未明确部分不补造

来源没有可展开的字段定义。完整约束可在「来源与状态」查看。

04响应参数

仅说明应用存活;设计稿没有给出 HTTP 状态、响应字段或响应类型。

来源没有可展开的字段定义。完整约束可在「来源与状态」查看。

05错误码 沿用来源定义

设计稿未明确错误响应,保留待确认,不补造错误码。

06来源与状态

契约状态:设计稿实现状态:设计未实现;基线:已有存活端点;字段以设计稿为准,不补猜测真实接口验收:未经沙箱验收
sourceCommit7d2ae11e91ecd073944f98473ef41a67cd0f6146
查看原始契约、引用与状态记录
{
  "contract": {
    "parameters": [],
    "responses": {
      "default": {
        "description": "仅说明应用存活;设计稿没有给出 HTTP 状态、响应字段或响应类型。"
      }
    },
    "sourceExtensions": {
      "x-permission": "设计展示,禁止网络请求",
      "x-source-sections": [
        "15",
        "21.10",
        "22"
      ]
    }
  },
  "status": {
    "contract": "设计稿",
    "implementation": "设计未实现;基线:已有存活端点;字段以设计稿为准,不补猜测",
    "realApiAcceptance": "未经沙箱验收"
  },
  "provenance": {
    "sourceCommit": "7d2ae11e91ecd073944f98473ef41a67cd0f6146",
    "sourceBlob": "74501663abc0df79dd867f39057b29e7cd1345b3",
    "sourceUrl": "https://github.com/SmartPool-Dev/smartpool-payment-service/pull/17",
    "paymentService": {
      "code": "D1",
      "group": "健康检查",
      "purpose": "供监控判断应用是否已经启动,不证明依赖可用。",
      "direction": "负载均衡 / 监控 → 本服务",
      "supplier": {
        "name": "易宝没有",
        "id": "易宝没有",
        "path": "易宝没有"
      },
      "phase": "—(已有,不在新能力批次中改)",
      "baselineStatus": "已有存活端点;字段以设计稿为准,不补猜测",
      "differences": [
        "本服务自有协议,易宝没有对应接口。"
      ],
      "openQuestions": [],
      "sourceSections": [
        {
          "id": "15",
          "title": "就绪检查(P6)",
          "body": "- `GET /up` 保留为存活检查(只说明应用起来了)。\n- 新增 `GET /ready`(只对负载均衡和监控开放,不对公网):\n  - 数据库:能连、能读写一张心跳表、迁移是最新;\n  - 缓存 / 锁存储:能取放锁(多节点时必须是共享存储,不能是本机文件);\n  - C05:应用目录不是 `UnconfiguredPaymentDirectory`,幂等摘要密钥已装配;\n  - 通道材料:已加载、未过期(只回布尔,不回任何密钥信息);\n  - 定时任务心跳:`payment:poll` 最近一次在 60 秒内、`payment:prune-nonces` 在 10 分钟内;\n  - 积压:待查订单、待投递推送、待发告警超过阈值时降级;\n  - 生产环境下故障注入开关(第 21.4 节)必须是关的,开着就 503。\n  - 全部通过 200,否则 503,正文只给每项 `ok` / `fail`。\n- 不在就绪检查里实时调用易宝(外部依赖另做渠道延迟和错误率监控)。"
        },
        {
          "id": "21.10",
          "title": "部署路径与来源(部署清单 A3,Jim 第 6 条)",
          "body": "| 路径 | 方法 | 允许来源 |\n| --- | --- | --- |\n| `/api/v1/notify/yeepay` | POST | 公网 443,易宝回调来源(按《回调网络配置》用域名 `out.yeepay.com` 解析同步,不写死 IP) |\n| `/api/v1/notify/yeepay/refund` | POST | 同上 |\n| `/rest/v1.0/*`、`/api/v1/payments/*`(旧接口并行期) | 按各接口 | 私网,或已核实的业务后端出口 IP |\n| `/api/v1/collections/*`、`/api/v1/internal/*` | POST | 私网 |\n| `/ready`、`/up` | GET | 负载均衡和监控所在私网 |\n\n- 只放行上面两条回调的**精确路径**,不放宽整个 `/api/*`。\n- 验收:两条回调从公网可达;其余路径从未授权公网来源探测必须被拒(拿实际探测结果,不只看安全组 443 截图);业务调用只从私网或已核实出口成功。"
        },
        {
          "id": "22",
          "title": "不在本设计范围",
          "body": "- 分账、归集、资金方案、循环收款池、提现、余额(GPAY-04—GPAY-21 的资金类)。对账只做第 13.5 节的收款、退款逐笔核对(P8),分账账单、资金账单核对不在第一阶段。\n- 公众号 / 小程序 / 支付宝预下单(GPAY-07)。\n- 部署执行、采购、改服务器、开公网(部署方案另行审批)。\n- 真实扣款和退款:只用易宝沙箱或测试商户。\n- 入网(进件):门店、教练、供应链、商户池商户的入网走服务商入网接口,第一阶段不加接口(产品负责人 11/11)。\n- 转账和提现(产品负责人 11/11):系统记录门店、教练、供应商、品牌总部各自应得的金额;到提现时间点由品牌总部按应得金额转给门店、教练、供应商,再自动提现到对方账户。后续阶段再设计;品牌总部转给对方用“转账”接口,**不用余额分账**。第一阶段收款、退款接口里的分账字段继续一律拒绝。后续会用到的易宝接口(只记出处,现在不设计):转账下单 `POST /rest/v1.0/account/transfer/b2b/order`(在线文档 `docs-v3/api/options_rest_v1.0_account_transfer_b2b_order.md`),结果通知 `account.business.transfer-result`;提现下单 `POST /rest/v1.0/account/withdraw/order`(Skill 的 `withdraw-order`)。"
        }
      ],
      "requestFields": [],
      "responseFields": [],
      "uncertainty": [
        "未在设计稿明确的字段、类型、必填性和响应层级保持未定义,不根据示例反推 schema。",
        "设计稿主要给出用途和规则;未命名的金额、原因、状态、游标、就绪项不补造协议字段名。"
      ],
      "displayFields": [],
      "keyRules": [],
      "authDescription": "只对负载均衡和监控所在私网开放,不对公网开放(第15、21.10节);具体请求鉴权头未明确。"
    }
  },
  "diagnostics": {
    "networkEnabled": false,
    "documentationOnly": true
  },
  "businessRules": [
    "本服务自有协议,易宝没有对应接口。"
  ],
  "issues": [
    "未在设计稿明确的字段、类型、必填性和响应层级保持未定义,不根据示例反推 schema。",
    "设计稿主要给出用途和规则;未命名的金额、原因、状态、游标、就绪项不补造协议字段名。"
  ]
}
SmartPool 接口文档源码/候选文档 · 不可真实调用