Cek Limit WDP & Double Diamonds

587.043 request sukses

Endpoint ini digunakan untuk mengecek status limit pembelian Weekly Diamond Pass (WDP) dan bonus Double Diamonds pada akun Mobile Legends, sekaligus mendapatkan nickname pemain.

Akses Terbatas: API ini tidak dapat diakses secara bebas. API Key biasa belum tentu memiliki izin untuk endpoint ini. Untuk mendapatkan akses, silakan hubungi pemilik KokinPay. Akses diberikan setelah Anda memenuhi syarat dan ketentuan yang berlaku.

Hubungi Pemilik KokinPay

Kenapa Perlu Cek Limit? Weekly Diamond Pass dan bonus Double Diamonds memiliki batas pembelian per akun. Dengan mengecek limit lebih dulu, Anda dapat mencegah order gagal karena akun sudah mencapai batas pembelian.

Endpoint

POST /v1/check-limit

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

Request Parameters

Berikut adalah parameter yang diperlukan untuk melakukan request cek limit:

Parameter	Type	Status	Deskripsi
api_key	string	Required	API Key yang digunakan untuk autentikasi request. Harus sudah mendapat izin akses endpoint ini
id	string	Required	User ID Mobile Legends yang ingin dicek
server	string	Required	Server ID atau Zone ID Mobile Legends

Request Example

Request Body (JSON)

{
  "api_key": "your-api-key-here",
  "id": "85104878",
  "server": "2122"
}

cURL Example (POST)

curl -X POST https://api.kokinpay.com/v1/check-limit \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your-api-key-here",
    "id": "85104878",
    "server": "2122"
  }'

Response

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

Response Sukses (200 OK)

{
  "status": true,
  "data": {
    "id": "85104878",
    "server": "2122",
    "nickname": "Legends.",
    "weekly_pass_status": {
      "is_limited": false
    },
    "double_diamonds_status": {
      "is_eligible": true,
      "items": [
        {
          "code": "double-diamonds-50",
          "is_limited": false
        },
        {
          "code": "double-diamonds-150",
          "is_limited": false
        },
        {
          "code": "double-diamonds-250",
          "is_limited": false
        },
        {
          "code": "double-diamonds-500",
          "is_limited": false
        }
      ]
    }
  }
}

Field	Type	Deskripsi
status	boolean	Status response. `true` jika berhasil, `false` jika gagal
data.id	string	User ID akun yang dicek
data.server	string	Server ID atau Zone ID akun yang dicek
data.nickname	string	Nickname pemain
data.weekly_pass_status.is_limited	boolean	`true` jika akun sudah mencapai limit pembelian Weekly Diamond Pass (tidak bisa membeli lagi)
data.double_diamonds_status.is_eligible	boolean	`true` jika akun masih berhak mendapatkan bonus Double Diamonds
data.double_diamonds_status.items	array	Daftar paket Double Diamonds beserta status limitnya
items[].code	string	Kode paket Double Diamonds
items[].is_limited	boolean	`true` jika paket tersebut sudah mencapai limit pembelian

Response Error

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

Error - Parameter Tidak Lengkap (400 Bad Request)

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

Error - API Key Tidak Dikirim (401 Unauthorized)

{
  "status": false,
  "message": "API Key dibutuhkan dalam permintaan ini"
}

Error - Akses Tidak Diizinkan (401 Unauthorized)

{
  "status": false,
  "message": "Akses tidak diizinkan"
}

Error - API Key Tidak Valid (401 Unauthorized)

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

Error - Data Akun Tidak Ditemukan (404 Not Found)

{
  "status": false,
  "message": "Data akun tidak ditemukan"
}

Error - Terjadi Kesalahan (500 Internal Server Error)

{
  "status": false,
  "message": "Terjadi kesalahan saat cek limit akun. Silahkan hubungi admin KokinPay"
}

HTTP Status Code

Status Code	Deskripsi
200	Request berhasil diproses dan data akun ditemukan
400	Parameter tidak lengkap
401	API Key tidak dikirim, tidak valid, atau tidak memiliki izin akses endpoint ini
404	Data akun tidak ditemukan
500	Terjadi kesalahan pada server

Contoh Implementasi

Contoh Implementasi PHP

<?php

$data = [
    'api_key' => "your-api-key-here",
    'id' => "85104878",
    'server' => "2122"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.kokinpay.com/v1/check-limit");
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 "Nickname: " . $result['data']['nickname'] . "\n";
    echo "WDP limit: " . ($result['data']['weekly_pass_status']['is_limited'] ? 'Ya' : 'Tidak') . "\n";

    foreach($result['data']['double_diamonds_status']['items'] as $item) {
        echo $item['code'] . ": " . ($item['is_limited'] ? 'Limit' : 'Tersedia') . "\n";
    }
} else {
    echo "Error: " . $result['message'];
}
?>

Contoh Implementasi JavaScript (Fetch API)

const data = {
  api_key: "your-api-key-here",
  id: "85104878",
  server: "2122"
};

fetch('https://api.kokinpay.com/v1/check-limit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
  if(result.status) {
    const d = result.data;
    console.log('Nickname:', d.nickname);
    console.log('WDP limit:', d.weekly_pass_status.is_limited);
    d.double_diamonds_status.items.forEach(item => {
      console.log(item.code, item.is_limited ? 'Limit' : 'Tersedia');
    });
  } else {
    console.log('Error:', result.message);
  }
})
.catch(error => console.error('Error:', error));

Contoh Implementasi Python

import requests

data = {
    'api_key': "your-api-key-here",
    'id': "85104878",
    'server': "2122"
}

response = requests.post(
    'https://api.kokinpay.com/v1/check-limit',
    json=data
)

result = response.json()

if result['status']:
    d = result['data']
    print(f"Nickname: {d['nickname']}")
    print(f"WDP limit: {d['weekly_pass_status']['is_limited']}")
    for item in d['double_diamonds_status']['items']:
        print(item['code'], 'Limit' if item['is_limited'] else 'Tersedia')
else:
    print(f"Error: {result['message']}")

Tips Implementasi:

Panggil endpoint ini sebelum customer membayar produk Weekly Diamond Pass atau Double Diamonds
Jika is_limited bernilai true, nonaktifkan atau sembunyikan paket tersebut di form order
Gunakan field code pada items untuk mencocokkan dengan paket di sistem Anda
Tampilkan nickname sebagai konfirmasi akun sebelum customer melanjutkan pembayaran
Berikan feedback visual yang jelas saat loading dan error

Kembali ke Cek Region Lanjut ke Callback