PLN Mobile 数据 API：电表、预付令牌与账单

PLN Mobile 是印尼国家电力公司 PT PLN (Persero) 的官方自助应用，Play 商店开发者显示为 P L N（PT PLN Pusat），面向应用里称作 Electrizen 的家庭与小微商户。手机号 OTP 登录后，首页可购买预付 token listrik、缴纳后付 tagihan、用 Catat Meter Mandiri（SwaCAM）自助抄表而不必等抄表员、提交带 Auto Dispatch 的 pengaduan 派给最近班组、申请新装（pasang baru）或增容（ubah daya）、办理 ICONNET 光纤、预约 ListrikQu 维修，并在公共 SPKLU 启动 Charge.In 充电。令牌与电费可通过银行虚拟账户、电子钱包或信用卡结账，应用还会推送住所及周边馈线的停电（padam）与复电（nyala）通知。界面为印尼语，帮助台 [email protected]，客服为（区号）123。Play 评分为 4.9（约 165 万条评价）、下载量 1000 万+，是全国唯一官方电力客户端，与 MyPertamina、各地 PDAM 等印尼国有服务应用并列，而非另一家电力公司的竞品。

名下电表以 idpel 为键，携带 tarif、daya、jenisLayanan 与 noMeter，以及所属 unitUlp 和通电标志 statusSambungan。后付费行包含账期 periode、起止表码 standAwal / standAkhir、用电量 pemakaianKwh、印尼盾 tagihan / totalBayar 与 statusBayar。预付购买返回 20 位 kodeToken，并拆出 nominal、rpStroom、kwh 与 adminFee。SwaCAM 提交用户自助的 standMeter 与 fotoMeter，回执带 statusValidasi 和 nomorAgenda。

故障工单记录 kategoriGangguan、autoDispatch、petugas 与 estimasiTindak。馈线停电给出 statusPadam、estimasiNyala 和 jumlahIdpelTerdampak。新装与增容写入 jenisPengajuan、dayaBaru、nomorPermohonan 与 estimasiBiaya。Charge.In 站点列出 connectorType、availableConnectors 与 tarifPerKwh；一次会话再记下 kwhDelivered 和 totalBiaya。IconCash 则提供 saldoIconCash 与 energyPoint。

家庭能源账本可把支出绑到 idpel 与 kodeToken；运维看板可把 statusPadam 与未结 nomorAgenda 画在同一张图上；电动车导航可按 tarifPerKwh 选 CCS2 车位并保存 sessionId。openData Studio 把这份 Electrizen 记录变成可调用的开放数据。

应用截图

API 端点一览

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

通过 OTP 创建 Electrizen 会话

POST /v1/auth/electrizen-session osint

用注册手机号和短信 OTP 换取会话，后续 IDPEL、账单、令牌与报修调用都依赖该会话。

认证方式：本调用无需认证。注册手机号加上短信 OTP 签发 accessToken，后续请求以 Authorization: Bearer 携带。

msisdn
otp
channel
deviceId
accessToken
refreshToken
userId
email
namaUser
ktpMasked

POST /v1/auth/electrizen-session HTTP/1.1
Content-Type: application/json

{
  "msisdn": "081234567890",
  "otp": "482193",
  "channel": "SMS",
  "deviceId": "android-8.1.1"
}

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session",
  "refreshToken": "rt-pln-7c11",
  "userId": "u-441902",
  "msisdn": "081234567890",
  "email": "[email protected]",
  "namaUser": "Budi Santoso",
  "ktpMasked": "3275****1234"
}

列出已绑定的 IDPEL 电表

GET /v1/meters opendata

返回已登录 Electrizen 添加的全部 IDPEL，含预付/后付标志、电价类别与以 VA 计的合同容量。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。

userId
idpel
alias
namaPelanggan
jenisLayanan
tarif
daya
noMeter
isDefault

GET /v1/meters HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session

{
  "userId": "u-441902",
  "meters": [
    {
      "idpel": "321234567890",
      "alias": "Rumah Depok",
      "namaPelanggan": "BUDI SANTOSO",
      "jenisLayanan": "PREPAID",
      "tarif": "R1",
      "daya": 1300,
      "noMeter": "88001234567",
      "isDefault": true
    },
    {
      "idpel": "321298765432",
      "alias": "Toko",
      "namaPelanggan": "BUDI SANTOSO",
      "jenisLayanan": "POSTPAID",
      "tarif": "B1",
      "daya": 3500,
      "noMeter": "88009876543",
      "isDefault": false
    }
  ]
}

IDPEL 电表快照

GET /v1/meters/{idpel} opendata

读取单个 IDPEL 背后的用电点：电价、容量 VA、电表编号、ULP 营业所以及通电/停电标志。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken，限定为用户已绑定的 IDPEL。

idpel
namaPelanggan
jenisLayanan
tarif
daya
golongan
noMeter
merkMeter
alamat
kelurahan
unitUlp
unitInduk
statusSambungan
latitude
longitude

GET /v1/meters/321234567890 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session

{
  "idpel": "321234567890",
  "namaPelanggan": "BUDI SANTOSO",
  "jenisLayanan": "PREPAID",
  "tarif": "R1",
  "daya": 1300,
  "golongan": "R1/1300VA",
  "noMeter": "88001234567",
  "merkMeter": "ITRON",
  "alamat": "JL MARGONDA RAYA NO 12, DEPOK",
  "kelurahan": "BEJI",
  "unitUlp": "ULP DEPOK",
  "unitInduk": "UID JABAR",
  "statusSambungan": "NYALA",
  "latitude": -6.387,
  "longitude": 106.828
}

当期后付费电费账单

GET /v1/bills/postpaid/{idpel} openfinance

返回某 IDPEL 的未结后付电费，含用电量 kWh、印尼盾金额、到期日与缴费状态。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。

idpel
namaPelanggan
periode
standAwal
standAkhir
pemakaianKwh
tagihan
denda
ppn
materai
totalBayar
currency
statusBayar
jatuhTempo
noRef

GET /v1/bills/postpaid/321298765432 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session

{
  "idpel": "321298765432",
  "namaPelanggan": "BUDI SANTOSO",
  "periode": "202610",
  "standAwal": 18420,
  "standAkhir": 19105,
  "pemakaianKwh": 685,
  "tagihan": 812400,
  "denda": 0,
  "ppn": 0,
  "materai": 10000,
  "totalBayar": 822400,
  "currency": "IDR",
  "statusBayar": "UNPAID",
  "jatuhTempo": "2026-10-20",
  "noRef": "BL-202610-321298765432"
}

购买预付 token listrik

POST /v1/prepaid/token openfinance

为某个 IDPEL 购买预付电费令牌，返回 20 位 kodeToken 以及 kWh 与印尼盾拆分。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。结账返回银行虚拟账户、电子钱包或银行卡的支付引用。

idpel
namaPelanggan
tarif
daya
nominal
adminFee
rpStroom
kwh
kodeToken
noMeter
noRef
statusBayar
currency
vaNumber
paymentMethod

POST /v1/prepaid/token HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Content-Type: application/json

{
  "idpel": "321234567890",
  "nominal": 100000,
  "paymentMethod": "VA_MANDIRI"
}

{
  "idpel": "321234567890",
  "namaPelanggan": "BUDI SANTOSO",
  "tarif": "R1",
  "daya": 1300,
  "nominal": 100000,
  "adminFee": 2500,
  "rpStroom": 97500,
  "kwh": 62.4,
  "kodeToken": "1234-5678-9012-3456-7890",
  "noMeter": "88001234567",
  "noRef": "TKN-20261009-88021",
  "statusBayar": "PAID",
  "currency": "IDR",
  "vaNumber": "8800123456789012"
}

提交 SwaCAM 自助抄表

POST /v1/swacam/readings opendata

记录用户自助拍摄的 kWh 读数（Catat Meter Mandiri / SwaCAM）并附电表照片，使下一期后付账单按实际读数计费。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。相机权限用于附加 fotoMeter。

idpel
noMeter
standMeter
fotoMeter
latitude
longitude
standSebelumnya
pemakaianKwh
periode
statusValidasi
nomorAgenda
pesan

POST /v1/swacam/readings HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Content-Type: application/json

{
  "idpel": "321298765432",
  "noMeter": "88009876543",
  "standMeter": 19105,
  "fotoMeter": "https://cdn.example/swacam/19105.jpg",
  "latitude": -6.387,
  "longitude": 106.828
}

{
  "idpel": "321298765432",
  "noMeter": "88009876543",
  "standMeter": 19105,
  "standSebelumnya": 18420,
  "pemakaianKwh": 685,
  "periode": "202610",
  "statusValidasi": "ACCEPTED",
  "nomorAgenda": "SWC-2026-11820",
  "pesan": "Stand meter diterima"
}

提交带 Auto Dispatch 的 pengaduan

POST /v1/complaints opendata

为某个 IDPEL 开立故障工单；在 Auto Dispatch 覆盖区会派给最近的技术班组并返回可跟踪的 agenda 号。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。

idpel
kategoriGangguan
deskripsi
latitude
longitude
fotoLampiran
nomorAgenda
statusLaporan
autoDispatch
petugas
nomerPetugas
unitUlp
estimasiTindak

POST /v1/complaints HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Content-Type: application/json

{
  "idpel": "321234567890",
  "kategoriGangguan": "PADAM",
  "deskripsi": "Listrik padam sejak 21:10, MCB aman",
  "latitude": -6.387,
  "longitude": 106.828,
  "fotoLampiran": "https://cdn.example/aduan/padam-1.jpg"
}

{
  "nomorAgenda": "PGD-2026-441902",
  "idpel": "321234567890",
  "kategoriGangguan": "PADAM",
  "statusLaporan": "DISPATCHED",
  "autoDispatch": true,
  "petugas": "Ahmad Fauzi",
  "nomerPetugas": "0812xxxx321",
  "unitUlp": "ULP DEPOK",
  "estimasiTindak": "2026-10-09T23:40:00+07:00"
}

IDPEL 周边停电（padam）状态

GET /v1/outages opendata

报告该户及周边馈线是否停电，并给出预计复电时间与受影响 IDPEL 数量。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。查询参数为已绑定 idpel 或设备经纬度。

idpel
statusPadam
statusSambungan
penyebab
feeder
wilayah
unitUlp
estimasiNyala
jumlahIdpelTerdampak
notifikasiNyala
latitude
longitude

GET /v1/outages?idpel=321234567890&latitude=-6.387&longitude=106.828 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session

{
  "idpel": "321234567890",
  "statusPadam": true,
  "statusSambungan": "PADAM",
  "penyebab": "GANGGUAN_PENYULANG",
  "feeder": "PYL DEPOK 07",
  "wilayah": "DEPOK",
  "unitUlp": "ULP DEPOK",
  "estimasiNyala": "2026-10-09T23:15:00+07:00",
  "jumlahIdpelTerdampak": 1840,
  "notifikasiNyala": false
}

新装 / 增容申请

POST /v1/services/applications opendata

提交新装或变更容量申请，返回可跟踪的 nomorPermohonan 以及印尼盾费用估算。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。新装申请可以没有已有 idpel。

jenisPengajuan
idpel
dayaLama
dayaBaru
tarif
alamatPasang
nomorPermohonan
estimasiBiaya
currency
statusPengajuan
unitUlp
slaHari

POST /v1/services/applications HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Content-Type: application/json

{
  "jenisPengajuan": "UBAH_DAYA",
  "idpel": "321298765432",
  "dayaLama": 1300,
  "dayaBaru": 3500,
  "tarif": "R1",
  "alamatPasang": "JL MARGONDA RAYA NO 12, DEPOK"
}

{
  "nomorPermohonan": "PB-2026-77821",
  "jenisPengajuan": "UBAH_DAYA",
  "idpel": "321298765432",
  "dayaLama": 1300,
  "dayaBaru": 3500,
  "tarif": "R1",
  "estimasiBiaya": 2450000,
  "currency": "IDR",
  "statusPengajuan": "IN_REVIEW",
  "unitUlp": "ULP DEPOK",
  "slaHari": 5
}

SPKLU Charge.In 充电站地图

GET /v1/spklu/stations opendata

列出附近的公共 SPKLU Charge.In 充电桩，含枪型、空闲车位、排队长度与每 kWh 印尼盾电价。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。

stationId
namaStasiun
latitude
longitude
connectorType
availableConnectors
totalConnectors
tarifPerKwh
currency
statusStasiun
antrian
radiusKm

GET /v1/spklu/stations?latitude=-6.2088&longitude=106.8456&radiusKm=5 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session

{
  "stations": [
    {
      "stationId": "SPKLU-JKT-0018",
      "namaStasiun": "SPKLU Rest Area KM 19",
      "latitude": -6.214,
      "longitude": 106.891,
      "connectorType": ["CCS2", "CHAdeMO", "AC"],
      "availableConnectors": 3,
      "totalConnectors": 6,
      "tarifPerKwh": 2467,
      "currency": "IDR",
      "statusStasiun": "AVAILABLE",
      "antrian": 0
    }
  ]
}

开始 SPKLU 充电会话

POST /v1/spklu/sessions openfinance

开始或快照一次 Charge.In 充电会话，返回已充电 kWh、时长与印尼盾总额。

认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。充电桩上的 NFC 或二维码标识 connectorId。

stationId
connectorId
connectorType
vehicleId
sessionId
statusCharging
kwhDelivered
durasiMenit
tarifPerKwh
totalBiaya
currency
socPercent

POST /v1/spklu/sessions HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Content-Type: application/json

{
  "stationId": "SPKLU-JKT-0018",
  "connectorId": "C-CCS2-02",
  "connectorType": "CCS2",
  "vehicleId": "B1234ABC"
}

{
  "sessionId": "CHG-2026-99012",
  "stationId": "SPKLU-JKT-0018",
  "connectorId": "C-CCS2-02",
  "connectorType": "CCS2",
  "statusCharging": "CHARGING",
  "kwhDelivered": 18.4,
  "durasiMenit": 27,
  "tarifPerKwh": 2467,
  "totalBiaya": 45400,
  "currency": "IDR",
  "socPercent": 64
}

IconCash 钱包快照
GET /v1/iconcash/wallet openfinance
读取应用内 IconCash 余额、能量积分以及钱包 / NFC 卡界面上的 KYC 与提现开关。
认证方式：使用 POST /v1/auth/electrizen-session 签发的 Bearer accessToken。KTP 升级界面控制提现。
- userId
- saldoIconCash
- currency
- energyPoint
- statusKyc
- ktpMasked
- canWithdraw
- nfcCardId
```
GET /v1/iconcash/wallet HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
```
```
{
  "userId": "u-441902",
  "saldoIconCash": 185000,
  "currency": "IDR",
  "energyPoint": 240,
  "statusKyc": "VERIFIED",
  "ktpMasked": "3275****1234",
  "canWithdraw": true,
  "nfcCardId": "NFC-8812"
}
```

数据类别

电表
电费账单
预付令牌
抄表读数
停电
服务工单
电动车充电
钱包

数据使用场景与案例

家庭用电量与账单对账
家庭能源或个人理财应用按 idpel 绑定每个用电点，从后付 tagihan 拉取 pemakaianKwh / standAwal / standAkhir，并从预付购买记录 kodeToken 与 kwh，使电费支出落在同一本账上。
馈线停电运维看板
市政或楼宇运维看板把 statusPadam、feeder、estimasiNyala 与 jumlahIdpelTerdampak 画到地图上，再拼上未结 pengaduan（nomorAgenda、autoDispatch、petugas），让班组与居民看到同一段停电窗口。
Charge.In 行程规划
电动车导航列出附近的 stationId，带 connectorType、availableConnectors 与 tarifPerKwh，并在 CCS2 或 CHAdeMO 充电结束后按 sessionId 记下 kwhDelivered 与 totalBiaya。
新装与增容进度跟踪
承包商或物业 CRM 提交 jenisPengajuan 为 PASANG_BARU 或 UBAH_DAYA 的申请（含 dayaLama / dayaBaru），并对照所属 unitUlp 跟踪 nomorPermohonan、estimasiBiaya 与 statusPengajuan。

常见问题

PLN Mobile 如何标识一块电表？

每个用电点是一个 Electrizen 在 OTP 登录后绑定的 idpel。电表快照返回 tarif、daya（VA）、jenisLayanan（PREPAID 或 POSTPAID）、noMeter、alamat 与 unitUlp。之后的账单、令牌、SwaCAM 抄表与报修都以该 idpel 为键。

购买 token listrik 会返回什么？

POST /v1/prepaid/token 接收 idpel 与 nominal，虚拟账户或电子钱包结清后返回 kodeToken（20 位）、kwh、rpStroom、adminFee 与 noRef——与成功购令牌界面上的回执一致。

停电与投诉能否跟踪？

GET /v1/outages 报告该户及周边馈线的 statusPadam、feeder、estimasiNyala 与 jumlahIdpelTerdampak。POST /v1/complaints 开立带 Auto Dispatch 的 pengaduan，返回 nomorAgenda、petugas 与 estimasiTindak，可像应用内历史一样跟踪。

这是公开的 PLN 开发者 API 吗？

不是。这里的路径是依据应用自身界面（IDPEL、令牌、tagihan、SwaCAM、pengaduan、停电、新装、Charge.In、IconCash）还原的、登录后这些功能所使用的私有接口面，而非对外文档化的第三方 API。

与 PLN Mobile 相似的应用

MyPertamina — MyPertamina 是印尼国家石油公司 Pertamina 面向驾车用户的官方加油与忠诚度应用，与 PLN Mobile 同属全国性国有企业自助客户端。
Saudi Energy — Saudi Energy 是沙特电力公司的自助应用，覆盖合同账户账单、预付电表充值与停电报修——与 PLN Mobile 同类，面向沙特电网。
Enel São Paulo — Enel São Paulo 是 ENEL BRASIL 面向圣保罗配电特许区的客户应用，提供账单二联单、PIX 缴费、自助抄表与停电报修工单。
Hathway Broadband — Hathway Broadband 是印度宽带运营商的自助应用，覆盖套餐、账单与工单；PLN Mobile 内的 ICONNET 光纤与之最接近。

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

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

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

获取报价

PLN Mobile 数据 API：电表、预付令牌与账单

应用截图

API 端点一览

通过 OTP 创建 Electrizen 会话

列出已绑定的 IDPEL 电表

IDPEL 电表快照

当期后付费电费账单

购买预付 token listrik

提交 SwaCAM 自助抄表

提交带 Auto Dispatch 的 pengaduan

IDPEL 周边停电（padam）状态

新装 / 增容申请

SPKLU Charge.In 充电站地图

开始 SPKLU 充电会话

IconCash 钱包快照

数据类别

数据使用场景与案例

家庭用电量与账单对账

馈线停电运维看板

Charge.In 行程规划

新装与增容进度跟踪

常见问题

与 PLN Mobile 相似的应用

更多效率工具类应用

Adobe Scan AI PDF Scanner, OCR

All Languages Translator

Call Blocker - Blacklist

Enel São Paulo

相关主题

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

PLN Mobile 数据 API：电表、预付令牌与账单

应用截图

API 端点一览

通过 OTP 创建 Electrizen 会话

列出已绑定的 IDPEL 电表

IDPEL 电表快照

当期后付费电费账单

购买预付 token listrik

提交 SwaCAM 自助抄表

提交带 Auto Dispatch 的 pengaduan

IDPEL 周边停电（padam）状态

新装 / 增容申请

SPKLU Charge.In 充电站地图

开始 SPKLU 充电会话

IconCash 钱包快照

数据类别

数据使用场景与案例

家庭用电量与账单对账

馈线停电运维看板

Charge.In 行程规划

新装与增容进度跟踪

常见问题

相关应用

与 PLN Mobile 相似的应用

更多效率工具类应用

Adobe Scan AI PDF Scanner, OCR

All Languages Translator

Call Blocker - Blacklist

Enel São Paulo

相关主题

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