Cek Data PLN

587.044 request sukses

Endpoint ini digunakan untuk melakukan validasi nomor meter pelanggan PLN dan mendapatkan nama pelanggan sebelum melakukan transaksi pembelian token listrik.

Kenapa Perlu Cek Data PLN? Fitur ini membantu memastikan nomor meter yang diinput customer sudah benar dengan menampilkan nama pelanggan PLN. Dengan validasi ini, kesalahan input dapat diminimalisir sebelum customer melakukan pembayaran.

Endpoint

POST /v1/check-pln

https://api.kokinpay.com/v1/check-pln

Request Parameters

Berikut adalah parameter yang diperlukan untuk melakukan request cek data PLN:

Parameter	Type	Status	Deskripsi
api_key	string	Required	API Key yang digunakan untuk autentikasi request
customer_number	string	Required	Nomor meter pelanggan PLN (biasanya 11-12 digit)

Request Example

Request Body (JSON)

{
  "api_key": "your-api-key-here",
  "customer_number": "123456789012"
}

cURL Example

curl -X POST https://api.kokinpay.com/check-pln \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your-api-key-here",
    "customer_number": "123456789012"
  }'

Response

API akan mengembalikan response dalam format JSON dengan struktur sebagai berikut:

Response Sukses (200 OK)

{
  "status": true,
  "data": {
    "customer_name": "BUDI SANTOSO"
  }
}

Field	Type	Deskripsi
status	boolean	Status response. `true` jika berhasil, `false` jika gagal
customer_name	string	Nama pelanggan PLN sesuai nomor meter yang dicek

Response Error

Jika terjadi error, API akan mengembalikan response dengan format berikut:

Error - Nomor Meter Tidak Ditemukan (404 Not Found)

{
  "status": false,
  "message": "Nomor meter pelanggan tidak ditemukan atau tidak valid"
}

Error - Parameter Tidak Lengkap (400 Bad Request)

{
  "status": false,
  "message": "Parameter tidak lengkap. Pastikan api_key dan customer_number diisi dengan benar"
}

Error - API Key Tidak Valid (401 Unauthorized)

{
  "status": false,
  "message": "API Key tidak valid atau tidak ditemukan"
}

Error - Terjadi Kesalahan (500 Internal Server Error)

{
  "status": false,
  "message": "Terjadi kesalahan saat cek data pelanggan. Hubungi support KokinPay untuk mendapatkan bantuan"
}

HTTP Status Code

Status Code	Deskripsi
200	Request berhasil diproses dan data pelanggan ditemukan
400	Parameter tidak lengkap atau format nomor meter tidak valid
401	API Key tidak valid atau tidak ditemukan
404	Nomor meter pelanggan tidak ditemukan
500	Terjadi kesalahan pada server

Contoh Implementasi

Contoh Implementasi PHP

<?php

$api_key = "your-api-key-here";
$customer_number = "123456789012";

$data = [
    'api_key' => $api_key,
    'customer_number' => $customer_number
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.kokinpay.com/check-pln");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if($result['status']) {
    echo "Nama Pelanggan: " . $result['data']['customer_name'] . "\n";
} else {
    echo "Error: " . $result['message'];
}
?>

Contoh Implementasi JavaScript (Fetch API)

const api_key = "your-api-key-here";
const customer_number = "123456789012";

const data = {
  api_key: api_key,
  customer_number: customer_number
};

fetch('https://api.kokinpay.com/check-pln', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
  if(result.status) {
    console.log('Nama Pelanggan:', result.data.customer_name);
  } else {
    console.log('Error:', result.message);
  }
})
.catch(error => console.error('Error:', error));

Contoh Implementasi Python

import requests
import json

api_key = "your-api-key-here"
customer_number = "123456789012"

data = {
    'api_key': api_key,
    'customer_number': customer_number
}

response = requests.post(
    'https://api.kokinpay.com/check-pln',
    headers={'Content-Type': 'application/json'},
    data=json.dumps(data)
)

result = response.json()

if result['status']:
    print(f"Nama Pelanggan: {result['data']['customer_name']}")
else:
    print(f"Error: {result['message']}")

Tips Implementasi:

Gunakan fitur ini di form input sebelum customer melakukan pembayaran token listrik
Tampilkan nama pelanggan di halaman konfirmasi untuk validasi tambahan
Validasi format nomor meter (biasanya 11-12 digit angka) sebelum mengirim request
Berikan feedback yang jelas jika nomor meter tidak ditemukan
Cache response untuk nomor meter yang sama agar tidak perlu request berulang kali

Catatan Penting:

Nomor meter PLN biasanya terdiri dari 11-12 digit angka
Pastikan customer memasukkan nomor meter dengan benar tanpa spasi atau karakter khusus
Fitur ini hanya untuk validasi data, bukan untuk melakukan transaksi
Untuk transaksi pembelian token listrik, gunakan endpoint transaksi utama

Kembali ke Daftar Kode Game Lanjut ke Cek Region MLBB