{"components":{"schemas":{"BudgetResult":{"additionalProperties":false,"properties":{"amount":{"description":"追加金额","type":"string"},"card_id":{"description":"卡片 ID","type":"string"},"currency":{"description":"币种","type":"string"},"id":{"description":"预算申请 ID","type":"string"},"problem":{"description":"待处理说明","type":"string"},"state":{"description":"COMPLETE / UNCERTAIN / REJECTED","type":"string"},"tenant_id":{"description":"租户 ID","type":"string"}},"type":"object"},"BudgetUpdate":{"additionalProperties":false,"properties":{"amount":{"description":"币种主单位；推荐十进制字符串，避免浮点精度损失","oneOf":[{"pattern":"^[0-9]+(\\.[0-9]+)?$","type":"string"},{"minimum":0,"type":"number"}]},"request_id":{"format":"uuid","type":"string"}},"required":["amount"],"type":"object"},"Card":{"additionalProperties":false,"properties":{"budget":{"description":"累计预算","type":"string"},"can_reveal":{"type":"boolean"},"can_secure_view":{"type":"boolean"},"cardholder_id":{"description":"持卡人 ID","type":"string"},"created_at":{"description":"创建时间","type":"string"},"currency":{"description":"币种","type":"string"},"fee_reserve":{"description":"费用预留","type":"string"},"id":{"description":"VCC 卡片/订单 ID","type":"string"},"is_personalized":{"type":"boolean"},"last_four":{"description":"后四位","type":"string"},"nick_name":{"description":"名称","type":"string"},"opening_fee_usd":{"description":"已确认开卡费","type":"string"},"principal_remaining":{"description":"剩余本金","type":"string"},"problem":{"description":"待处理说明","type":"string"},"purpose":{"description":"选填用途","type":"string"},"refund_returns_fee":{"type":"boolean"},"spend_bps":{"type":"integer"},"state":{"description":"LIVE/PAUSED/PROVISIONING/UNCERTAIN/REJECTED/CLOSED","type":"string"},"status":{"description":"卡片状态","type":"string"},"synced_at":{"description":"最后核对时间","type":"string"},"tenant_id":{"description":"所属租户","type":"string"},"tenant_name":{"description":"租户名称","type":"string"}},"type":"object"},"CardCreate":{"additionalProperties":false,"properties":{"amount":{"description":"币种主单位；推荐十进制字符串，避免浮点精度损失","oneOf":[{"pattern":"^[0-9]+(\\.[0-9]+)?$","type":"string"},{"minimum":0,"type":"number"}]},"cardholder_id":{"description":"VCC 持卡人 ID","type":"string"},"currency":{"description":"ISO 币种","type":"string"},"is_personalized":{"type":"boolean"},"nick_name":{"description":"选填卡片名称","type":"string"},"pricing_version":{"description":"quote 返回的 pricing_version","type":"string"},"purpose":{"enum":["","advertising","subscription","procurement","employee"],"type":"string"},"request_id":{"format":"uuid","type":"string"},"tenant_id":{"description":"租户 ID，可改用 x-tenant-id","type":"string"}},"required":["currency","amount","cardholder_id","pricing_version"],"type":"object"},"CardInput":{"additionalProperties":false,"properties":{"amount":{"description":"币种主单位；推荐十进制字符串，避免浮点精度损失","oneOf":[{"pattern":"^[0-9]+(\\.[0-9]+)?$","type":"string"},{"minimum":0,"type":"number"}]},"cardholder_id":{"description":"VCC 持卡人 ID","type":"string"},"currency":{"description":"ISO 币种","type":"string"},"is_personalized":{"type":"boolean"},"nick_name":{"description":"选填卡片名称","type":"string"},"pricing_version":{"description":"quote 返回的 pricing_version","type":"string"},"purpose":{"enum":["","advertising","subscription","procurement","employee"],"type":"string"},"request_id":{"format":"uuid","type":"string"},"tenant_id":{"description":"租户 ID，可改用 x-tenant-id","type":"string"}},"required":["currency","amount"],"type":"object"},"Error":{"additionalProperties":false,"properties":{"code":{"description":"稳定错误码","type":"string"},"message":{"description":"错误说明","type":"string"},"request_id":{"description":"请求跟踪号","type":"string"}},"required":["code","message","request_id"],"type":"object"},"Holder":{"additionalProperties":false,"properties":{"created_at":{"description":"创建时间","type":"string"},"email":{"description":"邮箱","type":"string"},"id":{"description":"持卡人 ID","type":"string"},"name":{"description":"姓名","type":"string"},"problem":{"description":"待处理说明","type":"string"},"state":{"description":"申请状态","type":"string"},"status":{"description":"审核状态","type":"string"},"tenant_id":{"description":"所属租户","type":"string"},"tenant_name":{"description":"租户名称","type":"string"}},"type":"object"},"HolderCreate":{"additionalProperties":false,"properties":{"agreement_consent":{"type":"boolean"},"city":{"description":"城市","type":"string"},"consent":{"type":"boolean"},"country":{"description":"ISO 国家代码","type":"string"},"date_of_birth":{"format":"date","type":"string"},"email":{"format":"email","type":"string"},"first_name":{"description":"英文名","type":"string"},"last_name":{"description":"英文姓","type":"string"},"line1":{"description":"街道地址","type":"string"},"paperless_consent":{"type":"boolean"},"phone":{"description":"联系电话","type":"string"},"postcode":{"description":"邮编","type":"string"},"privacy_consent":{"type":"boolean"},"request_id":{"format":"uuid","type":"string"},"state":{"description":"州/省代码","type":"string"},"tenant_id":{"description":"本账号的租户 ID，可改用 x-tenant-id","type":"string"}},"required":["email","first_name","last_name","date_of_birth","country","city","line1","postcode","consent"],"type":"object"},"Pricing":{"additionalProperties":false,"properties":{"opening_enabled":{"type":"boolean"},"opening_fee_usd_minor":{"description":"开卡费，USD 分","type":"string"},"refund_returns_fee":{"type":"boolean"},"source":{"description":"来源","type":"string"},"spend_bps":{"maximum":10000,"minimum":0,"type":"integer"},"spend_enabled":{"type":"boolean"},"version":{"description":"报价版本","type":"string"}},"type":"object"},"PricingUpdate":{"additionalProperties":false,"allOf":[{"if":{"properties":{"inherit":{"const":false}}},"then":{"required":["opening_enabled","opening_fee_usd","spend_enabled","spend_percent","refund_returns_fee"]}}],"properties":{"expected_version":{"description":"读取报价返回的版本","type":"string"},"inherit":{"type":"boolean"},"opening_enabled":{"type":"boolean"},"opening_fee_usd":{"description":"币种主单位；推荐十进制字符串，避免浮点精度损失","oneOf":[{"pattern":"^[0-9]+(\\.[0-9]+)?$","type":"string"},{"minimum":0,"type":"number"}]},"reason":{"description":"变更原因","type":"string"},"refund_returns_fee":{"type":"boolean"},"spend_enabled":{"type":"boolean"},"spend_percent":{"description":"币种主单位；推荐十进制字符串，避免浮点精度损失","oneOf":[{"pattern":"^[0-9]+(\\.[0-9]+)?$","type":"string"},{"minimum":0,"type":"number"}]}},"required":["expected_version","inherit","reason"],"type":"object"},"Quote":{"additionalProperties":false,"properties":{"budget":{"description":"累计预算","type":"string"},"currency":{"description":"币种","type":"string"},"customer_subsidy_required":{"additionalProperties":{"description":"客户补贴预留，租户限定凭证不返回","type":"string"},"type":"object"},"fee_reserve":{"description":"消费费预留","type":"string"},"opening_fee_usd":{"description":"开卡费 USD","type":"string"},"pricing_version":{"description":"创建卡片时须回传此版本","type":"string"},"refund_returns_fee":{"type":"boolean"},"required_balances":{"additionalProperties":{"description":"所需余额主单位","type":"string"},"type":"object"},"spend_bps":{"type":"integer"}},"type":"object"},"SecureView":{"additionalProperties":false,"properties":{"event_prefix":{"description":"校验 iframe postMessage 的事件前缀","type":"string"},"expires_at":{"format":"date-time","type":"string"},"iframe_url":{"description":"安全展示地址","type":"string"},"token":{"description":"短期展示令牌，不可持久化","type":"string"}},"type":"object"},"SensitiveCard":{"additionalProperties":false,"properties":{"card_number":{"description":"完整卡号；禁止持久化或记录日志","type":"string"},"cvv":{"description":"安全码","type":"string"},"expiry_month":{"type":"integer"},"expiry_year":{"type":"integer"},"name_on_card":{"description":"卡面姓名","type":"string"}},"type":"object"},"Settlement":{"additionalProperties":false,"properties":{"created_at":{"description":"记账时间","type":"string"},"currency":{"description":"币种","type":"string"},"customer_account_id":{"description":"客户账号","type":"string"},"id":{"description":"费用事件 ID","type":"string"},"kind":{"description":"OPENING / SPEND / SPEND_REFUND","type":"string"},"net_minor":{"description":"客户价差，可为负数","type":"string"},"order_id":{"description":"卡片 ID","type":"string"},"platform_fee_minor":{"description":"平台费用，最小单位整数","type":"string"},"tenant_fee_minor":{"description":"租户收费，最小单位整数","type":"string"},"tenant_id":{"description":"租户","type":"string"},"tenant_name":{"description":"租户名称","type":"string"}},"type":"object"},"StatusUpdate":{"additionalProperties":false,"properties":{"request_id":{"format":"uuid","type":"string"},"status":{"enum":["ACTIVE","INACTIVE","CLOSED"],"type":"string"}},"required":["status"],"type":"object"},"Tenant":{"additionalProperties":false,"properties":{"created_at":{"description":"创建时间","type":"string"},"customer_account_id":{"description":"所属客户账号","type":"string"},"email":{"description":"联系人邮箱","type":"string"},"funding_reference":{"description":"入金附言","type":"string"},"id":{"description":"租户 ID","type":"string"},"name":{"description":"租户名称","type":"string"},"pricing":{"$ref":"#/components/schemas/Pricing"},"status":{"description":"ACTIVE / SUSPENDED","type":"string"}},"type":"object"},"TenantCreate":{"additionalProperties":false,"properties":{"email":{"format":"email","type":"string"},"name":{"description":"租户名称","type":"string"},"request_id":{"format":"uuid","type":"string"}},"required":["name"],"type":"object"},"Token":{"additionalProperties":false,"properties":{"environment":{"description":"凭证所属环境","type":"string"},"expires_at":{"format":"date-time","type":"string"},"scopes":{"items":{"description":"权限","type":"string"},"type":"array"},"token":{"description":"短期访问令牌","type":"string"},"token_type":{"const":"Bearer"}},"required":["token","token_type","expires_at"],"type":"object"},"Transaction":{"additionalProperties":false,"properties":{"card_id":{"description":"VCC 卡片 ID","type":"string"},"created_at":{"description":"发生时间","type":"string"},"credited":{"description":"累计退款","type":"string"},"currency":{"description":"币种","type":"string"},"debited":{"description":"累计清算金额","type":"string"},"fee":{"description":"累计租户手续费","type":"string"},"id":{"description":"交易 ID","type":"string"},"merchant":{"description":"商户","type":"string"},"pending":{"description":"待清算授权","type":"string"},"status":{"description":"授权/清算状态","type":"string"},"tenant_id":{"description":"租户 ID","type":"string"},"tenant_name":{"description":"租户名称","type":"string"}},"type":"object"}},"securitySchemes":{"APIKey":{"in":"header","name":"x-api-key","type":"apiKey"},"AccessToken":{"scheme":"bearer","type":"http"},"ClientID":{"in":"header","name":"x-client-id","type":"apiKey"}}},"info":{"description":"VCC 客户业务接口。平台托管上游账户；客户仅访问自己及所属租户的数据。金额推荐使用十进制字符串。凭证固定环境，资源请求默认每分钟 120 次/客户端。敏感卡信息不得写入日志或持久化。","title":"VCC OpenAPI","version":"2026-10-28"},"openapi":"3.1.0","paths":{"/account":{"get":{"operationId":"getaccount","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"当前客户账号及服务配置","x-required-scope":"tenants:read"}},"/authentication/login":{"post":{"operationId":"authenticationLogin","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Token"}}},"description":"成功"},"401":{"description":"凭证错误、过期或已撤销"},"429":{"description":"每个客户端每分钟最多 10 次换取令牌"}},"security":[{"APIKey":[],"ClientID":[]}],"summary":"使用 Client ID 和 API Key 换取 30 分钟 Bearer 令牌"}},"/balances":{"get":{"operationId":"getbalances","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取租户余额及客户结算余额","x-required-scope":"wallets:read"}},"/funding-instructions":{"get":{"operationId":"getfundinginstructions","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"currency","schema":{"default":"USD","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取收款信息与专属附言","x-required-scope":"wallets:read"}},"/issuing/card-transactions":{"get":{"operationId":"getissuingcardtransactions","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"page_num","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"page_size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"card_id","schema":{"description":"VCC 卡片 ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/Transaction"},"type":"array"},"page_num":{"type":"integer"},"page_size":{"type":"integer"},"request_id":{"description":"跟踪号","type":"string"}},"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"分页查询消费与退款","x-required-scope":"transactions:read"}},"/issuing/cardholders":{"get":{"operationId":"getissuingcardholders","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"page_num","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"page_size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"q","schema":{"description":"名称/邮箱关键词","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/Holder"},"type":"array"},"page_num":{"type":"integer"},"page_size":{"type":"integer"},"request_id":{"description":"跟踪号","type":"string"}},"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"分页列出持卡人","x-required-scope":"cardholders:read"}},"/issuing/cardholders/create":{"post":{"operationId":"postissuingcardholderscreate","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"description":"UUID v4；也可使用正文 request_id，两者同时提供时必须相同","in":"header","name":"Idempotency-Key","schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HolderCreate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Holder"}}},"description":"成功"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Holder"}}},"description":"成功"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Holder"}}},"description":"已受理，状态待核对"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"422":{"description":"明确拒绝；响应含已记录的申请状态"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"创建持卡人申请","x-required-scope":"cardholders:write"}},"/issuing/cardholders/{id}":{"get":{"operationId":"getissuingcardholdersid","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Holder"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取持卡人详情","x-required-scope":"cardholders:read"}},"/issuing/cardholders/{id}/refresh":{"post":{"operationId":"postissuingcardholdersidrefresh","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Holder"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"核对持卡人状态","x-required-scope":"cardholders:read"}},"/issuing/cards":{"get":{"operationId":"getissuingcards","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"page_num","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"page_size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"state","schema":{"description":"按业务状态筛选","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/Card"},"type":"array"},"page_num":{"type":"integer"},"page_size":{"type":"integer"},"request_id":{"description":"跟踪号","type":"string"}},"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"分页列出卡片与申请","x-required-scope":"cards:read"}},"/issuing/cards/create":{"post":{"operationId":"postissuingcardscreate","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"description":"UUID v4；也可使用正文 request_id，两者同时提供时必须相同","in":"header","name":"Idempotency-Key","schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardCreate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"已受理，状态待核对"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"422":{"description":"明确拒绝；响应含已记录的申请状态"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"按确认报价申请卡片","x-required-scope":"cards:write"}},"/issuing/cards/quote":{"post":{"operationId":"postissuingcardsquote","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CardInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"检查开卡预算与费用","x-required-scope":"cards:read"}},"/issuing/cards/{id}":{"get":{"operationId":"getissuingcardsid","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取卡片管理信息","x-required-scope":"cards:read"}},"/issuing/cards/{id}/budget":{"post":{"operationId":"postissuingcardsidbudget","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}},{"description":"UUID v4；也可使用正文 request_id，两者同时提供时必须相同","in":"header","name":"Idempotency-Key","schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetResult"}}},"description":"成功"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetResult"}}},"description":"成功"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetResult"}}},"description":"已受理，状态待核对"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"422":{"description":"明确拒绝；响应含已记录的申请状态"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"追加卡片预算","x-required-scope":"cards:write"}},"/issuing/cards/{id}/details":{"post":{"operationId":"postissuingcardsiddetails","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SensitiveCard"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"临时读取完整卡片信息","x-required-scope":"cards:read_sensitive"}},"/issuing/cards/{id}/reconcile":{"post":{"operationId":"postissuingcardsidreconcile","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"核对现有开卡结果，不重新发卡","x-required-scope":"cards:write"}},"/issuing/cards/{id}/secure-view":{"post":{"operationId":"postissuingcardsidsecureview","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecureView"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"创建短期安全展示授权","x-required-scope":"cards:read_sensitive"}},"/issuing/cards/{id}/status":{"post":{"operationId":"postissuingcardsidstatus","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"id","required":true,"schema":{"description":"资源 ID","type":"string"}},{"description":"UUID v4；也可使用正文 request_id，两者同时提供时必须相同","in":"header","name":"Idempotency-Key","schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"成功"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Card"}}},"description":"已受理，状态待核对"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"422":{"description":"明确拒绝；响应含已记录的申请状态"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"启用、暂停或关闭卡片","x-required-scope":"cards:write"}},"/settlements":{"get":{"operationId":"getsettlements","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"page_num","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"page_size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"month","required":false,"schema":{"description":"北京时间的记账月份","pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/Settlement"},"type":"array"},"page_num":{"type":"integer"},"page_size":{"type":"integer"},"request_id":{"description":"跟踪号","type":"string"}},"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"分页读取当月差价结算","x-required-scope":"settlements:read"}},"/statements/{tenant}":{"get":{"operationId":"getstatementstenant","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"tenant","required":true,"schema":{"description":"资源 ID","type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"month","required":true,"schema":{"description":"北京时间的记账月份","pattern":"^[0-9]{4}-[0-9]{2}$","type":"string"}}],"responses":{"200":{"content":{"text/csv":{"schema":{"type":"string"}}},"description":"UTF-8 CSV 文件"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"导出租户月度 CSV 账单","x-required-scope":"wallets:read"}},"/tenants":{"get":{"operationId":"gettenants","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"query","name":"page_num","schema":{"default":0,"minimum":0,"type":"integer"}},{"in":"query","name":"page_size","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}},{"in":"query","name":"q","schema":{"description":"名称/邮箱关键词","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"has_more":{"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/Tenant"},"type":"array"},"page_num":{"type":"integer"},"page_size":{"type":"integer"},"request_id":{"description":"跟踪号","type":"string"}},"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"分页列出租户","x-required-scope":"tenants:read"}},"/tenants/create":{"post":{"operationId":"posttenantscreate","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"description":"UUID v4；也可使用正文 request_id，两者同时提供时必须相同","in":"header","name":"Idempotency-Key","schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantCreate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"}}},"description":"成功"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"}}},"description":"成功"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"}}},"description":"已受理，状态待核对"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"422":{"description":"明确拒绝；响应含已记录的申请状态"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"创建租户","x-required-scope":"tenants:write"}},"/tenants/{tenant}":{"get":{"operationId":"gettenantstenant","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"tenant","required":true,"schema":{"description":"资源 ID","type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tenant"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取租户详情","x-required-scope":"tenants:read"}},"/tenants/{tenant}/pricing":{"get":{"operationId":"gettenantstenantpricing","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"tenant","required":true,"schema":{"description":"资源 ID","type":"string"}},{"in":"query","name":"tenant_id","schema":{"description":"可选租户筛选，与请求头一致","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"读取租户最终售价与平台费用","x-required-scope":"pricing:read"},"post":{"operationId":"posttenantstenantpricing","parameters":[{"in":"header","name":"x-tenant-id","required":false,"schema":{"description":"租户范围，须属于当前客户账号","type":"string"}},{"in":"header","name":"x-api-version","required":false,"schema":{"enum":["2026-10-28"],"type":"string"}},{"in":"path","name":"tenant","required":true,"schema":{"description":"资源 ID","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricingUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pricing"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"请求错误"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"凭证或令牌无效"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"权限/租户/环境限制"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"资源不存在或不属于当前客户"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"业务冲突、余额不足或请求待核对"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"触发限流，遵循 Retry-After"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"上游暂不可用"}},"summary":"更新本账号租户最终售价","x-required-scope":"pricing:write"}}},"security":[{"AccessToken":[]}],"servers":[{"url":"https://vcc-userapi.uncensoredrouter.com/api/v1"}]}