Cek Nickname Game

587.044 request sukses

Endpoint ini digunakan untuk melakukan validasi ID game dan mendapatkan nickname pemain sebelum melakukan transaksi pembelian item game.

Kenapa Perlu Cek Nickname? Fitur ini membantu mengurangi kesalahan input ID game dari customer Anda. Dengan menampilkan nickname pemain, customer dapat memastikan ID yang dimasukkan sudah benar sebelum melakukan pembayaran.

Endpoint

POST /v1/check-nickname

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

Request Parameters

Berikut adalah parameter yang diperlukan untuk melakukan request cek nickname:

Parameter	Type	Status	Deskripsi
api_key	string	Required	API Key yang digunakan untuk autentikasi request
id	string	Required	User ID atau Player ID dari game yang ingin dicek
server	string	Optional	Server ID atau Zone ID (hanya untuk game tertentu yang memerlukan server)
game_code	string	Required	Kode game yang ingin dicek. Lihat daftar lengkap kode game di sini

Request Example

Menggunakan POST Method

Request Body (JSON)

{
  "api_key": "your-api-key-here",
  "id": "123456789",
  "server": "2001",
  "game_code": "mobile-legends"
}

cURL Example (POST)

curl -X POST https://api.kokinpay.com/check-nickname \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your-api-key-here",
    "id": "123456789",
    "server": "2001",
    "game_code": "mobile-legends"
  }'

Response

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

Response Sukses (200 OK)

{
  "status": true,
  "data": {
    "nickname": "ProPlayer123"
  }
}

Field	Type	Deskripsi
status	boolean	Status response. `true` jika berhasil, `false` jika gagal
nickname	string	Nickname atau username pemain

Response Error

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

Error - User ID Tidak Ditemukan (404 Not Found)

{
  "status": false,
  "message": "User ID tidak ditemukan atau tidak valid"
}

Error - Game Code Tidak Valid (400 Bad Request)

{
  "status": false,
  "message": "Game code tidak valid atau tidak tersedia"
}

Error - Parameter Tidak Lengkap (400 Bad Request)

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

Error - Server ID Diperlukan (400 Bad Request)

{
  "status": false,
  "message": "Server ID diperlukan untuk game ini"
}

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 nickname. Hubungi support KokinPay untuk mendapatkan bantuan"
}

HTTP Status Code

Status Code	Deskripsi
200	Request berhasil diproses dan user ditemukan
400	Parameter tidak lengkap, game code tidak valid, atau server ID diperlukan
401	API Key tidak valid atau tidak ditemukan
404	User ID tidak ditemukan atau tidak valid
500	Terjadi kesalahan pada server

Contoh Implementasi

Contoh Implementasi PHP

<?php

$api_key = "your-api-key-here";
$user_id = "123456789";
$server_id = "2001";
$game_code = "mobile-legends";

$data = [
    'api_key' => $api_key,
    'id' => $user_id,
    'server' => $server_id,
    'game_code' => $game_code
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.kokinpay.com/check-nickname");
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";
} else {
    echo "Error: " . $result['message'];
}
?>

Contoh Implementasi JavaScript (Fetch API)

const api_key = "your-api-key-here";
const user_id = "123456789";
const server_id = "2001";
const game_code = "mobile-legends";

const data = {
  api_key: api_key,
  id: user_id,
  server: server_id,
  game_code: game_code
};

fetch('https://api.kokinpay.com/check-nickname', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => {
  if(result.status) {
    console.log('Nickname:', result.data.nickname);
  } 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"
user_id = "123456789"
server_id = "2001"
game_code = "mobile-legends"

data = {
    'api_key': api_key,
    'id': user_id,
    'server': server_id,
    'game_code': game_code
}

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

result = response.json()

if result['status']:
    print(f"Nickname: {result['data']['nickname']}")
else:
    print(f"Error: {result['message']}")

Tips Implementasi:

Gunakan fitur ini di form input sebelum customer melakukan pembayaran
Tampilkan nickname di halaman konfirmasi untuk validasi tambahan
Cache response untuk ID yang sama agar tidak perlu request berulang kali
Berikan feedback visual yang jelas saat loading dan error
Untuk game dengan server, pastikan memberikan dropdown pilihan server yang benar

Kembali ke Transaksi Lihat Daftar Kode Game