Listrik PLN
Terakhir diperbarui: 11 September 2026.
Listrik PLN wajib Inquiry. Alur tiap sub kategori berbeda karena PLN Prabayar memilih nominal produk token setelah Inquiry, sedangkan PLN Pascabayar dan PLN Non-Taglis menggunakan product_id dari Inquiry Status.
Available Sub Category
| Value | Nama | Inquiry | Keterangan |
|---|---|---|---|
pln-prabayar | PLN Prabayar | Wajib | Inquiry memeriksa meter/ID pelanggan, lalu mengambil nominal produk token lewat Product List. |
| - | PLN Pascabayar | Wajib | Tidak menggunakan Product List. Nominal transaksi diambil otomatis dari hasil Inquiry Status sesuai jumlah tagihan pelanggan. |
| - | PLN Non-Taglis | Wajib | Tidak menggunakan Product List. Nominal transaksi diambil otomatis dari hasil Inquiry Status sesuai tagihan registrasi pelanggan. |
Inquiry Product Code
| Produk | inquiry_product_code |
|---|---|
| PLN Prabayar | INQPLN |
| PLN Pascabayar | INQPLNPASCA |
| PLN Non-Taglis | INQPLNNONTAGLIS |
Kode inquiry ini dipakai sama untuk environment development dan production.
PLN Prabayar
PLN Prabayar digunakan untuk pembelian token listrik.
- Jalankan Inquiry menggunakan
INQPLN. - Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
- Jika Inquiry
SUCCESS, ambil nominal produk lewat Product List menggunakansub_category=pln-prabayardanreference_idinquiry yang valid. - Jika ada
unsold_1atauunsold_2, Product List menampilkan produkUNSOLD*di urutan atas. - Lanjutkan ke proses Checkout dan Payment.
GET /client/v2/product/list?sub_category=pln-prabayar&phone_number=04187670019&reference_id=9543
Authorization: Bearer {customer_token}
X-SECRET-KEY: {partner_secret_key}
Product List PLN Prabayar wajib menggunakan reference_id. Jika reference_id tidak cocok, gagal, atau kedaluwarsa, permintaan ditolak.
PLN Pascabayar
PLN Pascabayar digunakan untuk pembayaran tagihan listrik bulanan.
- Jalankan Inquiry menggunakan
INQPLNPASCA. - Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
- Jika Inquiry
SUCCESS, ambilproduct_iddari response Inquiry Status. - Lanjutkan ke proses Checkout dan Payment.
Product Sync dan Product List untuk pln-pascabayar mengembalikan products: [] karena nominal tagihan berasal dari hasil Inquiry.
PLN Non-Taglis
PLN Non-Taglis digunakan untuk tagihan non-listrik PLN seperti registrasi layanan tertentu.
- Jalankan Inquiry menggunakan
INQPLNNONTAGLIS. - Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
- Jika Inquiry
SUCCESS, ambilproduct_iddari response Inquiry Status. - Lanjutkan ke proses Checkout dan Payment.
Product Sync dan Product List untuk pln-nontaglis mengembalikan products: [] karena nominal tagihan berasal dari hasil Inquiry.
Catatan Integrasi
- Produk internal
INQ*tidak tampil di Product Sync dan Product List. reference_idwajib digunakan ulang pada Product List PLN Prabayar, Checkout, dan Payment.reference_idmaksimal berlaku 15 menit dari waktu Inquiry.