Mi Claro Ecuador 数据 API：余额、流量包与账单

Claro Ecuador · 电信

Mi Claro Ecuador 是 Claro Ecuador 面向厄瓜多尔用户的官方自助服务应用（设备上显示为 Mi Claro），同属 América Móvil，覆盖预付与后付移动线路以及同一登录下的家庭宽带与电视。闪屏之后通过线路一次性验证码、已保存会话或生物识别登录，首页打开余额磁贴、语音与流量包、当前套餐、名下其他线路与业务，以及未结账单。用户可缴费或充值、购买国内与漫游包、赠送套餐、开关漫游、查看通话记录、更换套餐、管理无纸化账单、重置光猫 Wi-Fi、预约营业厅，并维护个人资料。它服务 Claro Ecuador 全国用户，与 Tigo Ecuador（原 Movistar Ecuador 网络）和 CNT 同处运营商自助服务赛道。

美元预付余额桶在所选线路上拆成 currentBalance、bonusBalance 与 periodicBalance，各自带有 validTillDateCurrent、validTillDateBonus 或 validTillDatePeriodic，并按 BalanceType 挂在 AccountID 与 ServiceID 上。同一登录下的移动与家庭业务通过 accountID、serviceID、contractID、lob、planName、planType、profileType 与 roleType 挂靠，并带 dueDate、total 与 currency。后付账单补充 billNo、amountDue、remainingAmount、paymentDueDate 与 billingPeriod；国内与漫游流量包给出 Datos_Totales、Datos_Restantes、Unidad_Restantes、Porcentaje_Uso 与 Fecha_Limite_Uso，类型由 UsageItemType 与 ServiceFeatureType 标明。充值流水保留 billingRechargeHistoryAmounts、billingRechargeHistoryMainBalance、billingRechargeHistoryBonoBalance、billingRechargeHistoryPromoBalance 与 billingRechargeHistoryRechargeChannel；提交充值后返回 amount、paymentDate 与 statusDate。套餐资格校验给出 qualificationResult、productOffering 与 productOfferingPrice，随后按 packageNum 开通到 msisdn。

台账机器人每晚对账三个预付余额桶，催收栈盯住逾期未付的 billNo 与 paymentDueDate，用量监控在 Fecha_Limite_Uso 前于 Datos_Restantes 下降时告警。openData Studio 把同一批对象整理成可调用的开放数据。

应用截图

API 端点一览

请求/响应示例为依据应用界面重构的示意示例，并非实时抓包。

签发 SSO setToken
POST /v1/auth/sso-token osint
确认线路 OTP，并返回后续第一方请求作为 Bearer 使用的 SSO setToken 与 request_id。
认证方式：无需登录。请求体为 grant_type=client_credentials，外加厄瓜多尔 set-token 步骤的 OTP。返回的 setToken 在后续第一方调用中作为 Authorization: Bearer 发送。
- grant_type
- scope
- code
- request_id
- setToken
- token_type
```
POST /v1/auth/sso-token HTTP/1.1
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "scope": "default",
  "code": "482913"
}
```
```
{
  "request_id": "req-8f21a4c2",
  "setToken": "eyJhbGciOi...",
  "token_type": "Bearer"
}
```

列出关联账户与业务

POST /v1/accounts/associated opendata

返回已登录持有人的关联移动与家庭业务，含 accountID、serviceID、planName、dueDate、total 与 currency，用于选择当前线路。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。

countryCode
accountID
serviceID
contractID
lob
originalLOB
serviceDescription
planID
planName
planType
planDescription
planAddress
profileType
roleType
serviceType
state
dueDate
total
totalFormat
currency
updateDate
todoClaro
isExactAccount
isSelected

POST /v1/accounts/associated HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "countryCode": "EC"
}

{
  "services": [
    {
      "accountID": "ACC-10028471",
      "serviceID": "SVC-593998112233",
      "contractID": "CTR-88421",
      "lob": "mobile",
      "originalLOB": "mobile",
      "serviceDescription": "Prepago voz y datos",
      "planID": "PLAN-PRE-15",
      "planName": "Claro Prepago 15",
      "planType": "PREPAID",
      "planDescription": "Bolsa nacional",
      "planAddress": "Av. Amazonas 123, Quito",
      "profileType": "holder",
      "roleType": "owner",
      "serviceType": 1,
      "state": "active",
      "dueDate": "2026-10-31",
      "total": "12.50",
      "totalFormat": "$12.50",
      "currency": "USD",
      "updateDate": "2026-10-12",
      "todoClaro": 0,
      "isExactAccount": true,
      "isSelected": 1
    }
  ]
}

读取预付与赠金余额

POST /v1/balances/retrieve openbanking

返回当前 accountId 的预付 currentBalance、bonusBalance 与 periodicBalance，各自带有效期，以及首页余额磁贴使用的 BalanceType/Currency 行。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。请求体 accountId 选择线路。

accountId
currentBalance
bonusBalance
periodicBalance
periodicBalanceNote
validTillDateCurrent
validTillDateBonus
validTillDatePeriodic
validTillDateVoice4
BalanceType
Total
Currency
DueDate
ServiceID
AccountID

POST /v1/balances/retrieve HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "accountId": "ACC-10028471"
}

{
  "accountId": "ACC-10028471",
  "currentBalance": "12.50",
  "bonusBalance": "3.00",
  "periodicBalance": "5.00",
  "periodicBalanceNote": "promo bag",
  "validTillDateCurrent": "2026-10-31",
  "validTillDateBonus": "2026-10-20",
  "validTillDatePeriodic": "2026-11-15",
  "validTillDateVoice4": "2026-10-31",
  "BalanceType": "PREPAID",
  "Total": "12.50",
  "Currency": "USD",
  "DueDate": "2026-10-31",
  "ServiceID": "SVC-593998112233",
  "AccountID": "ACC-10028471"
}

读取流量包用量

POST /v1/usage/consumption opendata

返回所选业务的国内与漫游包用量：剩余单位、流量总量、Porcentaje_Uso 与流量包界面展示的 Fecha_Limite_Uso。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。

countryCode
accountID
serviceID
Unidad
Unidad_Utilizados
Unidad_Restantes
Datos_Totales
Datos_Usados
Datos_Restantes
Saldo_Maestro
Porcentaje_Uso
Fecha_Limite_Uso
Fecha_Consulta
UsageItemType
ServiceFeatureType
ServiceFeatureSubType

POST /v1/usage/consumption HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "countryCode": "EC",
  "accountID": "ACC-10028471",
  "serviceID": "SVC-593998112233"
}

{
  "countryCode": "EC",
  "accountID": "ACC-10028471",
  "serviceID": "SVC-593998112233",
  "Unidad": "GB",
  "Unidad_Utilizados": "6.2",
  "Unidad_Restantes": "8.8",
  "Datos_Totales": 15.0,
  "Datos_Usados": 6.2,
  "Datos_Restantes": 8.8,
  "Saldo_Maestro": "12.50",
  "Porcentaje_Uso": 41.3,
  "Fecha_Limite_Uso": "2026-10-31",
  "Fecha_Consulta": "2026-10-12",
  "UsageItemType": "DATA",
  "ServiceFeatureType": "NATIONAL_BAG",
  "ServiceFeatureSubType": "LTE"
}

获取客户账单

POST /v1/bills/customer-bill openfinance

返回所选账户的后付客户账单，含账单历史界面使用的 amountDue、paymentDueDate、remainingAmount、billingPeriod、billNo 与 state。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。请求体 accountID 与 lob 选择出账业务。

accountID
lob
limit
billNo
amountDue
remainingAmount
paymentDueDate
billingPeriod
state
characteristicList
error
errorList

POST /v1/bills/customer-bill HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "accountID": "ACC-10028471",
  "lob": "mobile",
  "limit": 6
}

{
  "bills": [
    {
      "billNo": "B-202610-01",
      "amountDue": "24.90",
      "remainingAmount": "24.90",
      "paymentDueDate": "2026-10-20",
      "billingPeriod": "202610",
      "state": "unpaid",
      "characteristicList": [],
      "error": null,
      "errorList": null
    }
  ]
}

列出充值流水

GET /v1/recharges/history openbanking

返回预付充值行：日期、金额、充值后的主余额 / 赠金 / 促销余额，以及流量包充值历史界面展示的充值渠道。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。

billingRechargeHistoryTitle
billingRechargeHistorySubTitle
billingRechargeHistoryDate
billingRechargeHistoryAmounts
billingRechargeHistoryMainBalance
billingRechargeHistoryBonoBalance
billingRechargeHistoryPromoBalance
billingRechargeHistoryRechargeChannel
billingRechargeHistoryInfo

GET /v1/recharges/history HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "items": [
    {
      "billingRechargeHistoryTitle": "Recarga",
      "billingRechargeHistorySubTitle": "Canal app",
      "billingRechargeHistoryDate": "2026-10-05",
      "billingRechargeHistoryAmounts": "5.00",
      "billingRechargeHistoryMainBalance": "12.50",
      "billingRechargeHistoryBonoBalance": "3.00",
      "billingRechargeHistoryPromoBalance": "0.00",
      "billingRechargeHistoryRechargeChannel": "APP",
      "billingRechargeHistoryInfo": "Prepago"
    }
  ]
}

提交余额充值

POST /v1/topup/balance openbanking

为关联方 id 与渠道 name 提交预付余额充值，返回充值确认使用的 amount、paymentDate 与 statusDate。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。

balanceTopup
amount
id
name
startDate
paymentDate
statusDate

POST /v1/topup/balance HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "balanceTopup": {
    "amount": "5.00",
    "id": "SVC-593998112233",
    "name": "APP",
    "startDate": "2026-10-12",
    "paymentDate": "2026-10-12"
  }
}

{
  "statusDate": "2026-10-12T15:04:00-05:00",
  "amount": "5.00",
  "paymentDate": "2026-10-12",
  "id": "SVC-593998112233",
  "name": "APP",
  "startDate": "2026-10-12"
}

读取通话记录
POST /v1/calls/history opendata
按日期窗口与 countryCode 请求通话记录，返回通话记录界面使用的 acknowledgementIndicator。
认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。
- countryCode
- dateFrom
- dateTo
- acknowledgementIndicator
```
POST /v1/calls/history HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "countryCode": "EC",
  "dateFrom": "2026-10-01",
  "dateTo": "2026-10-12"
}
```
```
{
  "countryCode": "EC",
  "acknowledgementIndicator": "OK"
}
```

校验可购套餐资格

POST /v1/offerings/qualify opendata

返回所选账户可购买的附加包资格，含购买套餐界面使用的 qualificationResult、productOffering 与 productOfferingPrice。

认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。

countryCode
accountId
lob
qualificationResult
productOffering
productOfferingQualificationItem
productOfferingPrice
planID
planName

POST /v1/offerings/qualify HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "countryCode": "EC",
  "accountId": "ACC-10028471",
  "lob": "mobile"
}

{
  "countryCode": "EC",
  "qualificationResult": "qualified",
  "productOffering": {
    "planID": "PLAN-PRE-15",
    "planName": "Claro Prepago 15"
  },
  "productOfferingQualificationItem": [
    {
      "productOfferingPrice": "5.00"
    }
  ]
}

开通新套餐包
POST /v1/packages/add openfinance
为所选线路开通 packageNum 标识的国内或漫游包，并返回确认界面使用的 acknowledgementIndicator。
认证方式：来自 POST /v1/auth/sso-token 的 Authorization: Bearer setToken。
- msisdn
- packageNum
- lob
- acknowledgementIndicator
```
POST /v1/packages/add HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "msisdn": "593998112233",
  "packageNum": "PKG-DATA-2GB",
  "lob": "mobile"
}
```
```
{
  "acknowledgementIndicator": "OK"
}
```

数据类别

余额
账单
用量
充值
账户
通话记录

数据使用场景与案例

预付余额对账
台账机器人每晚拉取 currentBalance、bonusBalance 与 periodicBalance 及其有效期，并与首页磁贴已保存的 AccountID / ServiceID 对齐。
后付账单催收
催收栈盯住每张 billNo 上的 amountDue、remainingAmount 与 paymentDueDate，账单在 billingPeriod 过后仍未付时启动催缴。
流量包用量告警
当 Datos_Restantes 或 Unidad_Restantes 下降、Porcentaje_Uso 在 Fecha_Limite_Uso 前升高时触发告警，不必等待流量包界面。
充值渠道分析
预付运营把 billingRechargeHistoryRechargeChannel 与 billingRechargeHistoryAmounts 以及充值后的主余额 / 赠金 / 促销余额对照作图。

常见问题

Mi Claro Ecuador 背后有哪些账户对象？

预付线路把余额拆成 currentBalance、bonusBalance 与 periodicBalance，各带有效期，并按 BalanceType 挂在 AccountID 与 ServiceID 上。后付账单包含 billNo、amountDue、remainingAmount、paymentDueDate 与 billingPeriod。流量包暴露 Datos_Totales、Datos_Restantes、Unidad_Restantes、Porcentaje_Uso 与 Fecha_Limite_Uso，充值流水保留渠道以及充值后的主余额、赠金与促销余额。

应用如何认证第一方请求？

登录确认线路上的一次性验证码，返回 SSO setToken 与 request_id。后续第一方请求把该 setToken 作为 Bearer 令牌发送。授权步骤在 OTP 换票之前使用 client_credentials。

可以一起查询哪些线路？

关联账户行列出登录名下每一条移动与家庭业务，含 accountID、serviceID、contractID、lob、planName、planType、profileType、roleType、dueDate、total 与 currency，因此余额、账单与流量包可以按线路拉取。

流量包与附加套餐如何表示？

用量行暴露 Datos_Totales、Datos_Restantes、Unidad_Restantes、Porcentaje_Uso 与 Fecha_Limite_Uso，由 UsageItemType 与 ServiceFeatureType 分型。购买资格返回 qualificationResult、productOffering 与 productOfferingPrice；开通套餐提交 packageNum 与 msisdn，并返回 acknowledgementIndicator。

与 Mi Claro Ecuador 相似的应用

Mi Tigo Ecuador — Mi Tigo Ecuador 是 Tigo Ecuador 的官方自助应用（Play 包名 com.otecel.mimovistar）：用户可查询余额、购买 combo、充值并缴账单，覆盖 Millicom 于 2025 年收购 Telefónica Ecuador 后的原 Movistar Ecuador 网络。
CNT APP — CNT APP 是厄瓜多尔国营电信公司 Corporación Nacional de Telecomunicaciones CNT EP 的官方客户端，用于查看套餐与账单、转余额或流量，并在厄瓜多尔各地充值。
App Tuenti — App Tuenti 是 Tuenti Ecuador 面向 Tuenti 虚拟运营商品牌的线路管理应用：可查询余额、购买 combo 并在手机上充值。
Mi Claro Chile — Mi Claro Chile 是 Claro Chile 面向家庭与移动线路的用户应用，覆盖账单、缴费、余额、充值记录与在线叠加包变更。
Mi Movistar Chile — Mi Movistar Chile 是 Telefónica Chile 的自助应用，用于查询流量与分钟用量、缴纳账单并管理移动与家庭套餐。
Azercell — Azercell 是 Azercell Telekom 面向阿塞拜疆线路的官方自助应用：余额查询、上网包、漫游包与电子钱包充值。
Asiacell — Asiacell 是 ASIACELL COMMUNICATIONS PJSC 的官方自助应用，用于管理 Asiacell、YOOZ 与 Elite 线路，覆盖剩余流量、语音与短信、主余额、后付账单和充值。

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

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

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

获取报价

Mi Claro Ecuador 数据 API：余额、流量包与账单

应用截图

API 端点一览

签发 SSO setToken

列出关联账户与业务

读取预付与赠金余额

读取流量包用量

获取客户账单

列出充值流水

提交余额充值

读取通话记录

校验可购套餐资格

开通新套餐包

数据类别

数据使用场景与案例

预付余额对账

后付账单催收

流量包用量告警

充值渠道分析

常见问题

与 Mi Claro Ecuador 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Hathway Broadband

相关主题

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

Mi Claro Ecuador 数据 API：余额、流量包与账单

应用截图

API 端点一览

签发 SSO setToken

列出关联账户与业务

读取预付与赠金余额

读取流量包用量

获取客户账单

列出充值流水

提交余额充值

读取通话记录

校验可购套餐资格

开通新套餐包

数据类别

数据使用场景与案例

预付余额对账

后付账单催收

流量包用量告警

充值渠道分析

常见问题

相关应用

与 Mi Claro Ecuador 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Hathway Broadband

相关主题

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