Modul Belum Final: PLN Prabayar dan Pascabayar sudah siap digunakan. PLN Non-Taglis masih dalam tahap pengujian internal.

Development / Experimental
Products

Listrik PLN

Alur transaksi untuk PLN Prabayar, Pascabayar, dan Non-Taglis.

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

ValueNamaInquiryKeterangan
pln-prabayarPLN PrabayarWajibInquiry memeriksa meter/ID pelanggan, lalu mengambil nominal produk token lewat Product List.
-PLN PascabayarWajibTidak menggunakan Product List. Nominal transaksi diambil otomatis dari hasil Inquiry Status sesuai jumlah tagihan pelanggan.
-PLN Non-TaglisWajibTidak menggunakan Product List. Nominal transaksi diambil otomatis dari hasil Inquiry Status sesuai tagihan registrasi pelanggan.

Inquiry Product Code

Produkinquiry_product_code
PLN PrabayarINQPLN
PLN PascabayarINQPLNPASCA
PLN Non-TaglisINQPLNNONTAGLIS

Kode inquiry ini dipakai sama untuk environment development dan production.

PLN Prabayar

PLN Prabayar digunakan untuk pembelian token listrik.

  1. Jalankan Inquiry menggunakan INQPLN.
  2. Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
  3. Jika Inquiry SUCCESS, ambil nominal produk lewat Product List menggunakan sub_category=pln-prabayar dan reference_id inquiry yang valid.
  4. Jika ada unsold_1 atau unsold_2, Product List menampilkan produk UNSOLD* di urutan atas.
  5. 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.

  1. Jalankan Inquiry menggunakan INQPLNPASCA.
  2. Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
  3. Jika Inquiry SUCCESS, ambil product_id dari response Inquiry Status.
  4. 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.

  1. Jalankan Inquiry menggunakan INQPLNNONTAGLIS.
  2. Lakukan polling Inquiry Status sesuai rekomendasi pada modul Inquiry.
  3. Jika Inquiry SUCCESS, ambil product_id dari response Inquiry Status.
  4. 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_id wajib digunakan ulang pada Product List PLN Prabayar, Checkout, dan Payment.
  • reference_id maksimal berlaku 15 menit dari waktu Inquiry.