My lifecell 数据接口：余额、信用额度与 eSIM

lifecell · 电信

My lifecell 是乌克兰移动运营商 lifecell（Turkcell 集团）的官方自助服务应用，面向预付费与合约用户，让他们用手机管理自己的号码。登录走运营商 Keycloak SSO；首页展示剩余话费、流量与月费桶以及当前套餐。用户可在应用内用银行卡或 Google Pay 充值、开通信用额度、设置自动扣款、申领 eSIM 二维码、通过乌克兰 Diia 完成身份核验、查看“如在国内”漫游价格，并在主号下挂家庭从号，同一账户还可叠加 Volia 电视与宽带包。它服务全乌克兰的移动用户，主要竞品是 Kyivstar 与 Vodafone Ukraine。

余额桶写入 balanceDetails，字段包括 code、amount、measure、grantedAmount、percentage 与 renewDate（月费计数器为 Counter_Free_MonthlyFee）；订阅者记录把 msisdn 与套餐 tariff（name、tariffPriceFull、period）以及 contract.activationDate 绑在一起。

信用额度 JSON 携带 creditLimit、availableCL、currentMainBalance、feeCL 与 dateEndCL；话单父分组用 parentGroupDesc 对照 accountTotal / commonMain。充值发票返回 taskId 与 transactionId；自动扣款授权暴露 cardMask、productSum 与 nextTryDay。Diia 注册复制 taxCode、passportCode 与 addressUsual；eSIM 安装返回 qrCode 与 activationLink。家庭套餐分账、漫游费用看板和 KYC 后台会消费这些字段，openData Studio 再把它变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

签发移动会话令牌
GET /v1/lifecell/session/token osint
在设备签名校验后为订阅者 MSISDN 签发 XML 会话 token；该 token 在后续移动接口中作为查询参数 token 或 Bearer 发送。
认证方式：无需已有会话。查询参数携带 msisdn、deviceId、languageId、accessKeyCode、signature 和 UUID。返回的 XML token 用作后续调用的查询 token 和 Authorization: Bearer。
- responseCode
- resultText
- method
- token
- msisdn
- deviceId
- languageId
- accessKeyCode
- signature
- UUID
```
GET /v1/lifecell/session/token?msisdn=380630000001&deviceId=8f21a4c2-9b11-4e0a-a3d1-55c17a91f0e2&languageId=uk&accessKeyCode=<access-key>&signature=<device-signature>&UUID=550e8400-e29b-41d4-a716-446655440000 HTTP/1.1
```
```
<?xml version="1.0" encoding="UTF-8"?>
<response method="sessionToken">
  <responseCode>0</responseCode>
  <resultText>OK</resultText>
  <token>lc-sess-7c11e2b9</token>
</response>
```
通过 Keycloak 完成 SSO 登录
GET /v1/lifecell/auth/sso osint
用 Keycloak SSO 凭证换取应用会话：token、订阅者 subId、MSISDN、uniqId 以及 isOMO（虚拟运营商）标志。
认证方式：需已取得运营商 OpenID 会话。查询参数携带 msisdn 与 SSO 凭证；Content-Type: application/json。返回 token、subId、msisdn、uniqId 和 isOMO。
- token
- subId
- msisdn
- uniqId
- isOMO
- responseCode
- resultText
```
GET /v1/lifecell/auth/sso?msisdn=380630000001&token=kc-at-9f33 HTTP/1.1
Content-Type: application/json
```
```
<?xml version="1.0" encoding="UTF-8"?>
<response method="ssoExchange">
  <responseCode>0</responseCode>
  <resultText>OK</resultText>
  <token>lc-sess-7c11e2b9</token>
  <subId>sub-18482911</subId>
  <msisdn>380630000001</msisdn>
  <uniqId>uniq-c91e2b</uniqId>
  <isOMO>false</isOMO>
</response>
```

读取订阅者余额桶

GET /v1/lifecell/balances openbanking

返回已登录线路的余额桶：每个 code 的剩余 amount 与 grantedAmount、计量单位 measure、renewDate，以及首页磁贴使用的月费计数器 Counter_Free_MonthlyFee。

认证方式：移动接口会话查询参数：msisdn、token（来自设备引导或 SSO）、deviceId、languageId、accessKeyCode、signature 和 UUID。

balanceDetails
code
amount
measure
name
grantedAmount
percentage
renewDate
type
isUnlim
isDayOff
Counter_Free_MonthlyFee

GET /v1/lifecell/balances?msisdn=380630000001&token=lc-sess-7c11e2b9&deviceId=8f21a4c2-9b11-4e0a-a3d1-55c17a91f0e2&languageId=uk HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "method": "balances",
  "balanceDetails": [
    {
      "code": "MAIN",
      "amount": "185.40",
      "measure": "UAH",
      "name": "Main balance",
      "grantedAmount": "200.00",
      "percentage": "92",
      "renewDate": "2026-10-31",
      "type": "money",
      "isUnlim": "false",
      "isDayOff": "false"
    },
    {
      "code": "Counter_Free_MonthlyFee",
      "amount": "0.00",
      "measure": "UAH",
      "name": "Monthly fee",
      "grantedAmount": "150.00",
      "percentage": "0",
      "renewDate": "2026-11-01",
      "type": "fee",
      "isUnlim": "false",
      "isDayOff": "false"
    }
  ]
}

加载订阅者摘要与套餐

GET /v1/lifecell/summary opendata

加载首页订阅者记录：MSISDN、accessGroupCode、当前套餐 name/price/period、合同 activationDate、短余额列表 balanceList，以及 LINE_ACTIVATION_DATE、IS_FMC 等属性。

认证方式：移动接口会话查询参数：msisdn、token、deviceId、languageId、accessKeyCode、signature 和 UUID。

subscriber
msisdn
accessGroupCode
useCommonMain
tariff
code
name
period
tariffPriceFull
tariffPriceDiscount
picture_url
webview_url
contract
activationDate
activeLinesCount
contactPerson
balanceList
amount
attributesList
value
applicationAttributes

GET /v1/lifecell/summary?msisdn=380630000001&token=lc-sess-7c11e2b9&languageId=uk HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "subscriber": {
    "msisdn": "380630000001",
    "accessGroupCode": "PREPAID",
    "useCommonMain": true,
    "tariff": {
      "code": "SMART_LIFE_2026",
      "name": "Smart Life",
      "description": "Calls + data",
      "short_description": "150 UAH / 4 weeks",
      "period": "4w",
      "tariffOrderPeriod": "28",
      "tariffPriceFull": "150",
      "tariffPriceDiscount": "150",
      "picture_url": "/static/tariffs/smart-life.png",
      "webview_url": "/tariffs/smart-life"
    },
    "contract": {
      "activationDate": "2023-04-12",
      "activeLinesCount": 1,
      "contactPerson": "Olena K.",
      "lineNumber": "1",
      "number": "CNT-88421"
    },
    "balanceList": [{"code": "MAIN", "amount": 185.4}],
    "attributesList": [
      {"name": "LINE_ACTIVATION_DATE", "value": "2023-04-12"},
      {"name": "IS_FMC", "value": "false"}
    ]
  },
  "applicationAttributes": {
    "attributesList": [{"name": "IS_GIFTS_POOL_AVAILABLE", "value": "true"}]
  }
}

读取信用额度状态
GET /v1/lifecell/credit-limit openfinance
返回话费信用产品：creditStatus、相对 creditLimit 的剩余 availableCL、feeCL、currentMainBalance、免费期 dateEndFreeCL 以及计划停用标志。
认证方式：移动接口 Header：Authorization: Bearer <token>（来自设备引导或 SSO）。
- creditLimitInfo
- creditStatus
- dateEndCL
- feeCL
- creditLimit
- dateEndFreeCL
- availableCL
- currentMainBalance
- minCreditLimit
- maxCreditLimit
- scheduleDeactFlag
```
GET /v1/lifecell/credit-limit HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9
```
```
{
  "responseCode": 0,
  "resultText": "OK",
  "creditLimitInfo": {
    "creditStatus": "ACTIVE",
    "dateEndCL": "2026-11-15",
    "feeCL": 15.0,
    "creditLimit": 200.0,
    "dateEndFreeCL": "2026-10-20",
    "availableCL": 140.0,
    "currentMainBalance": 185.4,
    "minCreditLimit": "50",
    "maxCreditLimit": "500",
    "scheduleDeactFlag": false
  }
}
```

按父分组汇总话单

GET /v1/lifecell/charges/groups openfinance

将明细消费汇总到语音 / 流量 / 短信等父分组，给出 accountTotal、commonMain/commonBonus 与 lineMain/lineBonus、计量单位 measure 和 volume。

认证方式：移动接口会话查询参数：msisdn、token、deviceId、languageId。

chargesDetailParentGroupSummary
id
parentGroupCode
parentGroupDesc
accountTotal
commonBonus
commonMain
lineBonus
lineMain
measure
volume

GET /v1/lifecell/charges/groups?msisdn=380630000001&token=lc-sess-7c11e2b9&languageId=uk HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "chargesDetailParentGroupSummary": [
    {
      "id": 1,
      "parentGroupCode": 10,
      "parentGroupDesc": "Voice",
      "accountTotal": 42.5,
      "commonBonus": "0.00",
      "commonMain": "38.00",
      "lineBonus": "0.00",
      "lineMain": "4.50",
      "measure": "UAH",
      "volume": "86 min"
    },
    {
      "id": 2,
      "parentGroupCode": 20,
      "parentGroupDesc": "Data",
      "accountTotal": 12.0,
      "commonBonus": "2.00",
      "commonMain": "10.00",
      "lineBonus": "0.00",
      "lineMain": "0.00",
      "measure": "UAH",
      "volume": "3.2 GB"
    }
  ]
}

列出可选套餐

GET /v1/lifecell/tariffs opendata

列出已登录线路可切换的目录套餐：code、显示名称、格里夫纳 price、period、排序 order 以及图片 / 详情 URL。

认证方式：移动接口 Header：Authorization: Bearer <token>。

tariffList
code
name
currency
period
price
order
imageUrl
detailUrl

GET /v1/lifecell/tariffs HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "tariffList": [
    {
      "code": "SMART_LIFE_2026",
      "name": "Smart Life",
      "currency": "UAH",
      "period": "4w",
      "price": 150.0,
      "order": 1,
      "imageUrl": "/static/tariffs/smart-life.png",
      "detailUrl": "/tariffs/smart-life"
    },
    {
      "code": "FREE_LIFE",
      "name": "Free Life",
      "currency": "UAH",
      "period": "4w",
      "price": 90.0,
      "order": 2,
      "imageUrl": "/static/tariffs/free-life.png",
      "detailUrl": "/tariffs/free-life"
    }
  ]
}

创建 Oplata 充值发票
POST /v1/lifecell/topup/invoice openbanking
为话费充值打开数字支付发票（email + taskId）并返回 taskId/transactionId；后续卡 / GPay 扣款体携带 amount、msisdn、paymentType、refillSum、orderId、channel 和 osType。
认证方式：数字支付客户端的 HTTP Basic，另加请求头 X-TID、X-LANG、X-CLIENT-ID: Android。与移动会话 token 分离。
- email
- taskId
- transactionId
- amount
- msisdn
- paymentType
- refillSum
- orderId
- channel
- osType
- cardLink
- successUrl
- failedUrl
```
POST /v1/lifecell/topup/invoice HTTP/1.1
Content-Type: application/json
X-TID: tid-c91e2b77
X-LANG: uk
X-CLIENT-ID: Android
Authorization: Basic <digital-client-credentials>

{
  "email": "[email protected]",
  "taskId": "inv-8f21a4"
}
```
```
{
  "taskId": "inv-8f21a4",
  "transactionId": "tx-55c17a91"
}
```

列出自动扣款授权

GET /v1/lifecell/autopay openfinance

以 payer/receiver 行列出已保存的自动扣款：脱敏 cardMask、productCode/productSum、nextTryDay、state 以及账户上的 acceptedRule 标志。

认证方式：移动接口 Header：Authorization: Bearer <token>。

mapAutoPayments
account
acceptedRule
payer
receiver
id
alias
cardAlias
cardMask
cardLink
email
productCode
productType
productSum
extraSum
nextTryDay
state
agent
isNotify

GET /v1/lifecell/autopay HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "mapAutoPayments": {
    "account": {"acceptedRule": true},
    "payer": [
      {
        "id": 4412,
        "alias": "My Visa",
        "cardAlias": "Visa *1111",
        "cardMask": "444433******1111",
        "cardLink": "cl-9f33",
        "email": "[email protected]",
        "productCode": "MAIN_REFILL",
        "productType": "REFILL",
        "productSum": 150.0,
        "extraSum": 0.0,
        "nextTryDay": "2026-11-01",
        "state": "ACTIVE",
        "payer": "380630000001",
        "receiver": "380630000001",
        "agent": "OPLATA",
        "isNotify": true
      }
    ],
    "receiver": []
  }
}

读取已知客户资料

GET /v1/lifecell/profile osint

以嵌套的 generalSpecification 分组返回已知客户资料，每条 specifications 含 name/value，并用 isEditable 标记账户页是否可改。

认证方式：移动接口会话查询参数：msisdn、token、languageId。

clientInfoList
generalSpecification
name
specifications
value
isEditable
characteristic

GET /v1/lifecell/profile?msisdn=380630000001&token=lc-sess-7c11e2b9&languageId=uk HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "clientInfoList": [
    {
      "generalSpecification": [
        {
          "name": "Personal",
          "specifications": [
            {"name": "email", "value": "[email protected]", "isEditable": true, "characteristic": []},
            {"name": "language", "value": "uk", "isEditable": true, "characteristic": []}
          ]
        }
      ]
    }
  ]
}

读取多账户层级

GET /v1/lifecell/family opendata

返回家庭 / 多 SIM 树：hierarchyType、主号 master、上限 maxLineCurator/maxLineMultiaccount，以及每条从号的 msisdn 与 attributes。

认证方式：移动接口会话查询参数：msisdn、token。

hierarchyType
master
maxLineCurator
maxLineMultiaccount
multiaccountLines
lines
msisdn
attributes

GET /v1/lifecell/family?msisdn=380630000001&token=lc-sess-7c11e2b9 HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "hierarchyType": "FAMILY",
  "master": "380630000001",
  "maxLineCurator": 1,
  "maxLineMultiaccount": 5,
  "multiaccountLines": {
    "lines": [
      {
        "msisdn": "380630000002",
        "attributes": [{"name": "role", "value": "slave"}]
      },
      {
        "msisdn": "380630000003",
        "attributes": [{"name": "role", "value": "slave"}]
      }
    ]
  }
}

获取 Diia 注册客户数据

GET /v1/lifecell/kyc/diia osint

复制用于开户或重新识别线路的 Diia 法定身份：名、姓、父称、taxCode、passportCode/passportType、email、addressUsual 和 tokenRegistration。

认证方式：移动接口 Header：Authorization: Bearer <token>。

name
surname
fathername
taxCode
passportCode
passportType
email
addressUsual
tokenRegistration

GET /v1/lifecell/kyc/diia HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "responseCode": 0,
  "resultText": "OK",
  "name": "Olena",
  "surname": "Kovalenko",
  "fathername": "Ivanivna",
  "taxCode": "1234567890",
  "passportCode": "001234567",
  "passportType": "ID",
  "email": "[email protected]",
  "addressUsual": "Kyiv, Khreshchatyk 1",
  "tokenRegistration": "diia-reg-7c11"
}

签发 eSIM 二维码与激活链接
POST /v1/lifecell/esim opendata
签发手机下载运营商配置文件所用的 eSIM LPA qrCode 和 activationLink（在订购数字 SIM 或激活号码之后）。
认证方式： Header：Authorization: Bearer <token>。Content-Type: application/xml;charset=UTF-8。
- qrCode
- activationLink
- responseCode
- resultText
```
POST /v1/lifecell/esim HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9
Content-Type: application/xml;charset=UTF-8
```
```
{
  "responseCode": 0,
  "resultText": "OK",
  "qrCode": "LPA:1$smdp.example$matching-id-8f21",
  "activationLink": "/activate?code=matching-id-8f21"
}
```

读取漫游信息分组

GET /v1/lifecell/roaming opendata

返回已登录线路的 RLAH 漫游分组：title/code、actionCode/actionName/actionValue、priority 以及各分段配额。

认证方式：移动接口 Header：Authorization: Bearer <token>。

uuid
roamingInfo
title
code
actionCode
actionName
actionValue
priority
segments

GET /v1/lifecell/roaming HTTP/1.1
Authorization: Bearer lc-sess-7c11e2b9

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "roamingInfo": [
    {
      "title": "EU RLAH",
      "code": "EU",
      "actionCode": "ENABLE",
      "actionName": "Roam like at home",
      "actionValue": "ON",
      "priority": 1,
      "segments": [{"name": "data", "value": "12 GB"}]
    }
  ]
}

数据类别

余额
套餐
信用额度
话单
充值
自动扣款
资料
多账户
电子身份核验
eSIM
漫游
登录会话

数据使用场景与案例

预付费钱包与信用额度对账
财务机器人拉取各 code 的 balanceDetails amount/measure，并对照 creditLimit、availableCL 与 currentMainBalance，以便放贷或钱包栈在充值前看清剩余话费与未还信用。
家庭套餐分账
家庭或中小企业管理员把多账户层级里的 master 与从号 msisdn 映射到话单分组的 accountTotal / parentGroupDesc，按线路拆分共享套餐账单。
Diia 电子核验后台
开户台席消费 Diia 客户载荷中的 taxCode、passportCode、surname 与 addressUsual，预填 SIM 登记表，避免手工重录政府证件。
漫游费用管控
差旅看板读取 RLAH roamingInfo 的 actionCode、title 与分段配额，对照首页 tariffPriceFull，在员工离开欧盟“如在国内”区域前发出提醒。

常见问题

My lifecell 会话把哪些标识绑到一条线路？

SSO 返回 token、subId、msisdn、uniqId 和 isOMO；后续调用还会带 deviceId 与 UUID。摘要记录在 accessGroupCode 与 contract.activationDate 旁重复 msisdn。

剩余话费和信用额度分别怎么表示？

首页磁贴读 balanceDetails 里每个 code 的 amount/measure（含 Counter_Free_MonthlyFee）。信用产品是另一段 JSON：creditLimit、availableCL、currentMainBalance、feeCL 和 dateEndCL。

Diia 会带回哪些身份字段？

注册客户载荷复制 name、surname、fathername、taxCode、passportCode、passportType、email、addressUsual 和 tokenRegistration，用于 SIM 登记与重新识别。

家庭从号如何建模？

多账户层级给出主号 master、hierarchyType、上限 maxLineCurator / maxLineMultiaccount，以及每条从号的 msisdn 与 attributes。

与 My lifecell 相似的应用

My Kyivstar — My Kyivstar 是乌克兰运营商 Kyivstar 的官方自助应用，用于管理号码与账户、在应用内充值和查看账单明细；维基百科将其与 Vodafone Ukraine 并列为 lifecell 的主要竞品。
My Vodafone UA — My Vodafone UA 是 Vodafone Ukraine 的自助应用，用于查询余额、充值，以及管理套餐、通话、流量、eSIM 和奖励。
Azercell — Azercell 是阿塞拜疆移动运营商的自助应用，可在任何地点管理用户号码。
Asiacell — Asiacell 是伊拉克运营商的自助应用，用于随时随地管理 Asiacell、YOOZ 和 Elite 线路。
hambi (Beeline Uzbekistan) — hambi 是 Beeline 乌兹别克斯坦的超级应用，把运营商用户服务集中在一个客户端里。
Turkcell — Turkcell 是土耳其运营商的应用，用于办理用户业务和技术购物；该公司曾持有乌克兰 lifecell 的股份。
Mi Movistar Chile — Mi Movistar Chile 是智利 Telefónica 的运营商自助应用，提供权益、专属优惠和用户支持。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

My lifecell 数据接口：余额、信用额度与 eSIM

应用截图

API 端点一览

签发移动会话令牌

通过 Keycloak 完成 SSO 登录

读取订阅者余额桶

加载订阅者摘要与套餐

读取信用额度状态

按父分组汇总话单

列出可选套餐

创建 Oplata 充值发票

列出自动扣款授权

读取已知客户资料

读取多账户层级

获取 Diia 注册客户数据

签发 eSIM 二维码与激活链接

读取漫游信息分组

数据类别

数据使用场景与案例

预付费钱包与信用额度对账

家庭套餐分账

Diia 电子核验后台

漫游费用管控

常见问题

与 My lifecell 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Hathway Broadband

相关主题

需要集成这个 App 的数据 API？

My lifecell 数据接口：余额、信用额度与 eSIM

应用截图

API 端点一览

签发移动会话令牌

通过 Keycloak 完成 SSO 登录

读取订阅者余额桶

加载订阅者摘要与套餐

读取信用额度状态

按父分组汇总话单

列出可选套餐

创建 Oplata 充值发票

列出自动扣款授权

读取已知客户资料

读取多账户层级

获取 Diia 注册客户数据

签发 eSIM 二维码与激活链接

读取漫游信息分组

数据类别

数据使用场景与案例

预付费钱包与信用额度对账

家庭套餐分账

Diia 电子核验后台

漫游费用管控

常见问题

相关应用

与 My lifecell 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Hathway Broadband

相关主题

需要集成这个 App 的数据 API？