平台端 / 支付管理 / 接入应用
西安禾斗 · 平台运营

接入应用

平台共用一套支付服务。私有化品牌作为接入应用调用,授权仅限本品牌。

本屏管理接口 · 后续阶段

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;只读设计展示,未接通,不代表已实现。

待接入支付服务 · 当前仅展示空态和“—”,所有写操作暂不可用。
记录总数—
启用 / 已完成—
待处理—
应用名称授权范围签名密钥推送地址状态操作
暂无接入应用记录待接入支付服务