Mi Movistar 数据 API：账单、余额与上门

Movistar Chile · 电信

Mi Movistar Chile 是 Telefónica Chile 的官方自助应用（端内名称 Mi Movistar），面向预付费与后付费移动线路以及光纤和家庭套餐。用户通过短信验证码、合作方登录或手机生物识别进入后，首页即显示以智利比索计价的账单、预付余额、后付欠费、当前套餐以及同一 RUT 下的附加线路。同一客户端可缴费或充值、预约或取消上门、跟踪光纤与终端订单、提交帮助工单并管理已存卡。它服务智利全国的 Movistar 用户，在当地与 Entel、Claro 和 WOM 同台竞争。

智利后付账单以 fechaEmision、fechaVencimiento、montoTotal 与 montoPendiente 落在出账周期 cicloFacturacion 上；预付钱包给出 saldo 与 saldoMonetario，对照后付 deuda / deuda_pendiente。会话是 PKCE 换来的 OpenID access_token，并带 refresh_token、id_token 与 expires_in（grant_type、client_id、code_verifier）。持有人资料以 rutCliente、nombreCliente、numeroCliente 和 customerId 为键，附加线路记为 linea / Telefono / msisdn。

上门预约挂在 apptNumber 与 horario；产品订单返回 orderId、productId 与 offeringId；工单带 status；同一 Bearer 会话还覆盖生物识别登记与短信 otp。

财务按到期日对清智利比索账单，外勤补上门空档，订单台席跟踪光纤与终端交付，门店对照 saldo 与 deuda 报价——openData Studio 把这份订户台账变成可调用的开放数据。

应用截图

API 端点一览

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

用授权码换取 OpenID 令牌
POST /v1/movistar/login osint
用 OpenID authorization_code 与 PKCE code_verifier 换取后续第一方请求使用的 access_token、refresh_token、id_token 与 expires_in。
认证方式：无需登录。请求体为 grant_type=authorization_code、client_id、code 与 PKCE code_verifier。Content-Type application/json。
- grant_type
- client_id
- code
- code_verifier
- access_token
- refresh_token
- id_token
- expires_in
- token_type
```
POST /v1/movistar/login HTTP/1.1
Content-Type: application/json

{
  "grant_type": "authorization_code",
  "client_id": "movistar-app",
  "code": "splitted-auth-code",
  "code_verifier": "pkce-verifier"
}
```
```
{
  "access_token": "eyJhbGciOi...",
  "refresh_token": "rt-8f21a4c2",
  "id_token": "eyJhbGciOi...",
  "expires_in": 3600,
  "token_type": "Bearer"
}
```

列出后付费账单

GET /v1/movistar/invoices opendata

返回已登录线路的后付费账单，含出账周期、开具日与到期日以及智利比索金额。

认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。

boletas
cicloFacturacion
fechaEmision
fechaVencimiento
montoTotal
montoPendiente
monto
boleta

GET /v1/movistar/invoices HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Accept: application/json

{
  "boletas": [
    {
      "cicloFacturacion": "202609",
      "fechaEmision": "2026-09-01",
      "fechaVencimiento": "2026-09-15",
      "montoTotal": 24990,
      "montoPendiente": 24990,
      "monto": 24990,
      "boleta": "B-202609-01"
    }
  ]
}

解析账单下载链接
GET /v1/movistar/invoice-link opendata
按出账周期解析可下载的账单，供账单界面在 fechaVencimiento 与 montoTotal 旁打开 PDF。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。查询参数 cicloFacturacion 选择账单。
- cicloFacturacion
- fechaEmision
- fechaVencimiento
- montoTotal
- status
```
GET /v1/movistar/invoice-link?cicloFacturacion=202609 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "cicloFacturacion": "202609",
  "fechaEmision": "2026-09-01",
  "fechaVencimiento": "2026-09-15",
  "montoTotal": 24990,
  "status": "READY"
}
```
读取预付费余额
GET /v1/movistar/balance opendata
返回当前线路的预付智利比索 saldo 与 saldoMonetario，以及过期剩余和建议充值金额。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- saldo
- saldoMonetario
- saldoExpirado
- montoSaldoRecargar
- linea
```
GET /v1/movistar/balance HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "saldo": 12500,
  "saldoMonetario": 12500,
  "saldoExpirado": 0,
  "montoSaldoRecargar": 3000,
  "linea": "56987654321"
}
```
读取后付费欠款
GET /v1/movistar/debts opendata
返回当前 Telefono 的后付智利比索 deuda 与 deuda_pendiente，即缴账单界面收取的金额。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- deuda
- deuda_pendiente
- montoPendiente
- Telefono
```
GET /v1/movistar/debts HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "deuda": 24990,
  "deuda_pendiente": 24990,
  "montoPendiente": 24990,
  "Telefono": "56987654321"
}
```

读取持有人资料

GET /v1/movistar/profile osint

加载已认证持有人：智利 RUT、法定姓名、客户编号以及当前移动 linea / msisdn。

认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。

rutCliente
nombreCliente
numeroCliente
customerId
customerIdentification
accountId
email
linea
msisdn

GET /v1/movistar/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "rutCliente": "12345678-5",
  "nombreCliente": "Camila Rojas",
  "numeroCliente": "10028471",
  "customerId": "10028471",
  "customerIdentification": "12345678-5",
  "accountId": "ACC-88421",
  "email": "[email protected]",
  "linea": "56987654321",
  "msisdn": "56987654321"
}

列出上门预约档期
GET /v1/movistar/visits opendata
返回可预约的上门档期，含光纤或上门维修窗口的 apptNumber 与 horario。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- slots
- apptNumber
- horario
- schedule
```
GET /v1/movistar/visits HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "slots": [
    {
      "apptNumber": "APT-44019",
      "horario": "2026-10-08T09:00:00-03:00",
      "schedule": "AM"
    }
  ]
}
```
预约一次上门
POST /v1/movistar/visits opendata
预约所选上门档期，使上门界面按 apptNumber 显示 SCHEDULED。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。请求体携带所选 apptNumber 与 horario。
- apptNumber
- horario
- status
```
POST /v1/movistar/visits HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "apptNumber": "APT-44019",
  "horario": "2026-10-08T09:00:00-03:00"
}
```
```
{
  "apptNumber": "APT-44019",
  "horario": "2026-10-08T09:00:00-03:00",
  "status": "SCHEDULED"
}
```
取消上门预约
POST /v1/movistar/visits/cancel opendata
按 apptNumber 取消先前预约的上门。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。请求体（或查询参数）携带已预约上门的 apptNumber。
- apptNumber
- status
```
POST /v1/movistar/visits/cancel HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "apptNumber": "APT-44019"
}
```
```
{
  "apptNumber": "APT-44019",
  "status": "CANCELLED"
}
```
读取产品订单状态
GET /v1/movistar/orders opendata
返回已登录 msisdn 的光纤 / 终端产品订单状态：orderId、productId、offeringId 与 status。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- orderId
- productId
- offeringId
- msisdn
- status
```
GET /v1/movistar/orders HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "orderId": "ORD-338821",
  "productId": "FIBRA-600",
  "offeringId": "OFF-HOGAR-01",
  "msisdn": "56987654321",
  "status": "IN_PROGRESS"
}
```
列出服务工单
GET /v1/movistar/tickets opendata
列出该线路的服务工单，供帮助界面显示 ticket 编号与 status。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- tickets
- ticket
- status
```
GET /v1/movistar/tickets HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "tickets": [
    {
      "ticket": "TKT-90211",
      "status": "OPEN"
    }
  ]
}
```
发送登录或加验短信验证码
POST /v1/movistar/otp osint
向登录或加验挑战使用的智利 msisdn / linea 发送短信 otp。
认证方式：第一因子时可不登录，加验时携带 Bearer。请求体标识 linea / msisdn。
- msisdn
- linea
- status
- otp
```
POST /v1/movistar/otp HTTP/1.1
Content-Type: application/json

{
  "msisdn": "56987654321",
  "linea": "56987654321"
}
```
```
{
  "status": "SENT",
  "otp": true
}
```
登记设备生物识别
POST /v1/movistar/biometric/enrol osint
为已登录 customerId 登记设备生物识别，便于后续启动用校验代替重复短信。
认证方式：来自 POST /v1/movistar/login 的 Authorization: Bearer access_token。
- customerId
- status
```
POST /v1/movistar/biometric/enrol HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "customerId": "10028471"
}
```
```
{
  "status": "ENROLLED",
  "customerId": "10028471"
}
```
校验设备生物识别
POST /v1/movistar/biometric/verify osint
校验已登记的设备生物识别，并可为该 customerId 签发新的 access_token。
认证方式：设备生物识别断言，可附带 Bearer。请求体标识 customerId。
- customerId
- status
- access_token
- expires_in
```
POST /v1/movistar/biometric/verify HTTP/1.1
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json

{
  "customerId": "10028471"
}
```
```
{
  "status": "VERIFIED",
  "access_token": "eyJhbGciOi...",
  "expires_in": 3600
}
```

数据类别

账单
余额
欠费
用户资料
上门预约
产品订单
工单
登录会话

数据使用场景与案例

智利比索账单与欠费对账
夜间任务拉取 GET /v1/movistar/invoices 获取 cicloFacturacion、fechaVencimiento、montoTotal 与 montoPendiente，再读 GET /v1/movistar/debts 的 deuda 对照 GET /v1/movistar/balance 的 saldo，以便在到期日前对清智利比索台账。
上门预约台席
外勤读取 GET /v1/movistar/visits（apptNumber、horario）并用 POST /v1/movistar/visits 填补剩余光纤或维修窗口，档期释放时调用 POST /v1/movistar/visits/cancel。
光纤与终端订单跟踪
订单台席轮询 GET /v1/movistar/orders 的 orderId、productId、offeringId 与 status，并对照 GET /v1/movistar/tickets，让停滞交付与未结工单落在同一块板上。
以 RUT 为键进入 Bearer 会话
门店终端先 POST /v1/movistar/login（grant_type、code_verifier），再 GET /v1/movistar/profile 读取 rutCliente、nombreCliente 与 linea，并 POST /v1/movistar/biometric/enrol，使下次启动走设备校验而非再发短信。

常见问题

Mi Movistar 如何对订阅者 API 调用进行认证？

POST /v1/movistar/login 用授权码加 PKCE code_verifier（grant_type、client_id）换取 access_token、refresh_token、id_token 与 expires_in。之后的请求发送 Authorization: Bearer。POST /v1/movistar/otp 发送短信验证码；POST /v1/movistar/biometric/enrol 与 POST /v1/movistar/biometric/verify 在同一会话上登记并解锁设备生物识别。

哪些端点暴露账单、余额与欠费？

GET /v1/movistar/invoices 返回 cicloFacturacion、fechaEmision、fechaVencimiento、montoTotal 与 montoPendiente。GET /v1/movistar/invoice-link 解析可下载账单。GET /v1/movistar/balance 返回预付 saldo 与 saldoMonetario。GET /v1/movistar/debts 返回当前 Telefono 的后付 deuda 与 deuda_pendiente。

如何预约上门？

GET /v1/movistar/visits 列出带 apptNumber、horario 与 schedule 的档期。POST /v1/movistar/visits 预约所选档期。POST /v1/movistar/visits/cancel 按 apptNumber 释放档期。

能否看到持有人 RUT、订单与工单？

可以。GET /v1/movistar/profile 返回 rutCliente、nombreCliente、numeroCliente、customerId、email 与 linea。GET /v1/movistar/orders 返回 orderId、productId、offeringId 与 status。GET /v1/movistar/tickets 列出 ticket 编号与 status。

与 Mi Movistar Chile 相似的应用

Mi Entel — Mi Entel 是智利运营商 Entel 的官方自助应用：用户可在手机上查询移动与家庭套餐余额、缴账单并管理附加线路。
Mi Claro Chile — Mi Claro 是 Claro Chile 面向预付费与后付费线路的用户应用，覆盖余额、账单与套餐变更。
WOM Chile — WOM 是智利一家移动运营商的自助应用，面向预付费与后付费用户：剩余话费、叠加包与账单缴纳。
Azercell — Azercell 是 Azercell Telekom MMC 面向阿塞拜疆预付费与后付费线路的官方自助应用：马纳特分桶、发票与 SimKredit。
Asiacell — Asiacell 是伊拉克运营商 ASIACELL COMMUNICATIONS PJSC 的官方自助应用，面向预付费与后付费用户：首页余额、使用量与充值。
hambi (Beeline Uzbekistan) — hambi 是 UNITEL 旗下 Beeline 乌兹别克斯坦的自助应用，覆盖核心余额、流量分桶与家庭子账户。
My DishTV — My DishTV 是印度 Dish TV 的用户应用，覆盖 DTH 套餐、充值与发票——目录中另一款运营商自助界面。

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

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

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

获取报价

Mi Movistar 数据 API：账单、余额与上门

应用截图

API 端点一览

用授权码换取 OpenID 令牌

列出后付费账单

解析账单下载链接

读取预付费余额

读取后付费欠款

读取持有人资料

列出上门预约档期

预约一次上门

取消上门预约

读取产品订单状态

列出服务工单

发送登录或加验短信验证码

登记设备生物识别

校验设备生物识别

数据类别

数据使用场景与案例

智利比索账单与欠费对账

上门预约台席

光纤与终端订单跟踪

以 RUT 为键进入 Bearer 会话

常见问题

与 Mi Movistar Chile 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Mitra

相关主题

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

Mi Movistar 数据 API：账单、余额与上门

应用截图

API 端点一览

用授权码换取 OpenID 令牌

列出后付费账单

解析账单下载链接

读取预付费余额

读取后付费欠款

读取持有人资料

列出上门预约档期

预约一次上门

取消上门预约

读取产品订单状态

列出服务工单

发送登录或加验短信验证码

登记设备生物识别

校验设备生物识别

数据类别

数据使用场景与案例

智利比索账单与欠费对账

上门预约台席

光纤与终端订单跟踪

以 RUT 为键进入 Bearer 会话

常见问题

相关应用

与 Mi Movistar Chile 相似的应用

更多电信类应用

Asiacell

Azercell

hambi (Beeline Uzbekistan)

Mitra

相关主题

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