接入应用
平台共用一套支付服务。私有化品牌作为接入应用调用,授权仅限本品牌。
本屏管理接口 · 后续阶段
POST /api/v1/admin/apps/*
仅平台私网,platform_admin 授权;写操作带 operator、request_ref,记审计。所有出参不含易宝余额;密钥、证书只显示配置状态。路径中的 * 表示设计稿接口组,不是可调用接口。具体逐接口字段仍按 r10 契约,不在原型补造。
14.1 接入应用(第 228、229 张)
- 私有化品牌的系统也是接入应用。应用上加 owner_brand_ref(可空):填了的,授权只能登记在这个品牌之内,也不能给 platform_admin,违反 422。SmartPool 自己的应用不填(已定,第 18 节第 9 项)。
- 授权到门店:grants[] 每条是“授权范围+品牌+门店”,门店为空表示这个品牌的全部门店(r10 GPAY-01 的 app_grants 已经是这个结构)。列表出参给页面小字要的内容:品牌名,以及“全部门店”或门店数。
- 签名版本:出参给每种签名最近一次使用的时间(sign_last_seen.v1、.v2,取自第①段报文),页面据此写“v2”或“v1 · 旧接口”。同一把密钥两种签名都能用,不另发密钥。另加开关 allowed_sign_versions(默认两种都允许):调用方切完以后,平台可以按应用把 v1 关掉,关掉后用 v1 签名回 401(第 18 节第 3 项,按建议做)。旧接口下线前“确认没有调用”(一期稿第 16 节)就看这两个时间。
- 推送地址白名单:push_urls[] 可以登记多条,每条只允许 HTTPS、443 端口,不带账号口令和片段;其中最多一条标成默认(资金类事件推到这里,第 13.5 节)。下单请求里的 notifyUrl 必须正好等于白名单里的一条,否则 422(一期稿第 3.3、11.2 节)。列表出参给“已登记几条”和最近一次投递成功的时间。
- 换密钥两步、两把上限、提前停用旧钥、推送密钥只显示一次(M10-R65—R69)不变;停用、启用不变,平台运营应用不能停用自己。
来源:支付服务 #20 · 批准提交 707ca08;只读设计展示,未接通,不代表已实现。
| 应用名称 | 授权范围 | 签名 | 密钥 | 推送地址 | 状态 | 操作 |
|---|---|---|---|---|---|---|
| 暂无接入应用记录待接入支付服务 | ||||||