POST/api/v1/admin/recharge/channels/{channel}/initialize
管理员Cookie、HTTPS、JWE、ADMIN_RECHARGE_WRITEJSON 响应接入指南 ↗

批量初始化渠道国家套餐

请求参数

请求沿用公共协议、公共请求头和AES/JWE。全部八项客户端头及Accept-Language必填,admin/web/admin_web固定,安装ID绑定管理员Cookie。GET信封放X-Budyoo-JWE,写请求Content-Type为application/jose;下例表示加密前与解密后的业务内容。

channel接受xiaomi、vivo、huawei、oppo、yingyongbao、honor、baidu、google_play、app_store,dev和未知代码拒绝。国家使用目录中的小写两位代码。Google Play仅允许us/jp/kr,App Store允许cn/us/jp/kr,国内七渠道仅允许cn(中国大陆);具体白名单见catalog的channels[].countryCodes。管理端越界国家返回400 INVALID_RECHARGE_CONFIGURATION,不自动改写为美国配置。没有分页或额外查询参数。

仅OWNER持ADMIN_RECHARGE_WRITE可执行。固定六档100、500、1000、3000、6000、10000钻,人民币1元对应10钻净收入;国内七渠道0%、google_play15%、app_store30%。本币priceMinor=ceil(钻石÷10÷(1−扣费)×本币/CNY汇率×10^精度),只在最后向上取整。按国家代码排序加锁,任一国家非零版本或审计失败则整批回滚,返回409或503。成功返回当前渠道运营范围内已保存国家概况。越界国家使整批400并回滚。成功后重发会409,网络失败需先只读核对。

请求示例

Accept-Language: zh-CN
X-Client-Type: admin
X-Platform: web
X-App-Version: 1.0.0
X-App-Build: 1
X-Channel: admin_web
X-Device-Id: 00000000-0000-4000-8000-000000000001
X-Request-Id: 00000000-0000-4000-8000-000000000002
X-Request-Timestamp: <发送时的13位Unix毫秒>
Cookie: <浏览器自动携带的管理员Cookie>
Origin: <本站受信HTTPS Origin>
X-Admin-CSRF: <当前会话内存中的CSRF令牌,写请求必需>

POST /api/v1/admin/recharge/channels/google_play/initialize。必填countries为1–249项国家代码,不允许重复或null,且每项必须属于该渠道countryCodes;国内七渠道每渠道最多1项、Google最多3项、Apple最多4项。仅允许version=0的全新国家,已保存后清空也不能再次初始化。额外字段拒绝,费率、汇率与档位来自服务端快照。

{
  "countries": ["us"]
}

成功响应

data为数组,按country排序,仅包含当前运营国家中已保存过的配置,范围外旧记录不返回;无配置时[]。清空套餐仍保留版本和一行概况。

字段 类型 说明
country string 小写两位国家代码
currency string 本组币种
version integer 当前独立版本
packageCount integer 当前档数,0表示主动清空
updatedAt ISO时间 最近成功保存时间
{
  "code": "SUCCESS",
  "message": "操作成功",
  "data": [
    {
      "country": "us",
      "currency": "USD",
      "version": 1,
      "packageCount": 6,
      "updatedAt": "2026-11-06T08:00:00Z"
    }
  ],
  "errors": []
}

失败响应

HTTP200使用code/message/data/errors外层结构,Cache-Control为no-store。错误同样经JWE认证。

HTTP code 条件
400 INVALID_APP_CHANNEL 渠道未知或不是正式九渠道
400 INVALID_RECHARGE_CONFIGURATION 国家不属于渠道运营范围,或币种、金额、版本、套餐编号、重复项无效
400 BAD_REQUEST/VALIDATION_FAILED/INVALID_CLIENT_HEADERS JSON类型、额外字段、范围或公共头无效
400 ENCRYPTION_REQUIRED/INVALID_ENCRYPTED_REQUEST 缺少或无效JWE
401/403 UNAUTHORIZED/FORBIDDEN/ADMIN_CSRF_INVALID 管理员身份、权限、同源或CSRF不满足
409 RECHARGE_CONFIGURATION_CONFLICT 当前版本已变更,保留输入并重新读取核对
426/429 HTTPS_REQUIRED/TOO_MANY_REQUESTS HTTPS或限流拒绝
503 SERVICE_UNAVAILABLE 数据库、审计或Redis故障,不能视为空配置

失败示例的解密结果为{"code":"RECHARGE_CONFIGURATION_CONFLICT","message":"充值配置已变更,请读取最新版本后再保存。","data":null,"errors":[]}。code固定,message和字段错误支持中英日韩,未知语言回退英文。

接入说明

后台目录同时返回channels和pricing供界面展示。汇率为2026-11-06的固定快照,页面标明时点与来源;国家币种参考Unicode CLDR 49,南极洲无统一法币、朝鲜KPW缺少本次汇率报价,两项按已确认的USD报价并明确提示。批量定价只在明确初始化时计算,汇率变化不会自动改价。

原平台国家GET/PUT继续独立兼容。正式App按服务端会话绑定渠道读取,价格不靠IP、资料国家或客户端临时付款声明决定。此处只保存报价与展示,真实商店商品、订单、支付、退款和到账仍待接入。

2026-11-06国内范围修正后服务器clean verify共786项全部通过。充值相关14项覆盖七个国内渠道仅cn、旧海外报价保留及不可读写、混合国家初始化整批回滚、正式App越界400,以及Google三国、Apple四国和美国展示回退。真实受信HTTPS/JWE的6项只读接口检查和6项页面检查通过,实际逐个切换七个国内渠道均为中国大陆1/1、CNY及六档1:10报价;四语桌面/手机12组布局通过。当前14组/84档可运营,全库存量2241组/13446档的价格、稳定编号和版本摘要保持一致。本次业务写入为0,未安装或运行客户端设备。商店商品绑定、国家识别、订单核验和真实支付继续留到最后接入。