Version 1.0.0

API Documentation KSTORETOPUP

Halo, selamat datang di Dokumentasi Integrasi KSTORETOPUP .

Getting Started

For those who already have a game top-up website, you can connect your game top-up website using the Open API from KSTORETOPUP.

BASE URL:

Production

: https://kstoretopup.com

🔐 Signature Validation (MD5)

Untuk keamanan, setiap request harus menyertakan signature yang divalidasi menggunakan MD5.

Cara Membuat Signature:


                  signature = md5(api_id + api_key)

Contoh:

api_id = "hwurofj282"

api_key = "dc61633005ccwfwirhn3nfnbee933fc309b4"

String yang di-hash: "714b7b109dc3r39938rjf206f6fc596ad94b"

Hasil MD5: "714b7b109dca02caf206f6fc596ad94b"

⚠️ Penting:

Hash MD5 harus dalam format huruf kecil (lowercase)
Jangan pernah membagikan api_key Anda kepada siapapun
Signature adalah kombinasi dari api_id + api_key yang di-enkripsi dengan MD5

API Endpoints

Request Body (JSON)

api_id

API ID

required

api_key

API KEY

required

signature

MD5 Hash (api_id + api_key)

required

Request Example:

{
  "api_id": "hwurofj282",
  "api_key": "dc61633005ccwfwirhn3nfnbee933fc309b4",
  "signature": "714b7b109dc3r39938rjf206f6fc596ad94b",
}

Success Response

{
  "status": true,
  "msg": "successfully retrieved profile data",
  "data": {
    "username": "Achill",
    "balance": 15000,
    "role": "Gold"
  }
}

Failed Response

{
  "status": false,
  "msg": "API ID or API KEY Not Found"
}

{
  "status": false,
  "msg": "Invalid Signature. Please check your API credentials"
}

Request Body (JSON)

api_id

API ID

required

api_key

API KEY

required

signature

MD5 Hash (api_id + api_key)

required

Request Example:

{
  "api_id": "hwurofj282",
  "api_key": "dc61633005ccwfwirhn3nfnbee933fc309b4",
  "signature": "714b7b109dc3r39938rjf206f6fc596ad94b",
}

Success Response

[
  {
    "status": "active",
    "msg": "successfully retrieved service data",
    "data": {
      "id": "1",
      "service_kode": "MLBB-01",
      "game": "Mobile Legends",
      "nama_layanan": "14 Diamonds",
      "harga": {
        "basic": 3310,
        "gold": 3250,
        "platinum": 3120
      }
    }
  }
]

Failed Response

{
  "status": false,
  "msg": "Invalid Signature. Please check your API credentials"
}

Request Body (JSON)

api_id

API ID

required

api_key

API KEY

required

signature

MD5 Hash (api_id + api_key)

required

WhatsApp (+60 format)

required

order_id

Unique Order ID

required

service_kode

Service Code (from /service)

required

target_id

Game User ID

required

target_server

Server/Zone ID (optional)

optional

Request Example:

{
  "api_id": "hwurofj282",
  "api_key": "dc61633005ccwfwirhn3nfnbee933fc309b4",
  "signature": "714b7b109dc3r39938rjf206f6fc596ad94b",
  "whatsapp": "+60123456789",
  "order_id": "KSTORE20260721231723",
  "service_kode": "MLBB-01",
  "target_id": "409094931",
  "target_server": "9837"
}

Success Response

{
  "status": true,
  "msg": "Order successful! Your order is being processed",
  "data": {
    "order_id": "KSTORE20260721231723",
    "nama_layanan": "14 Diamonds",
    "service_kode": "MLBB-01",
    "target_id": "409094931",
    "target_server": "9837",
    "status": "Process",
    "note": "Transaction Success"
  }
}

Failed Response

{
  "status": false,
  "msg": "Your balance is insufficient"
}

{
  "status": false,
  "msg": "service_kode not found"
}

{
  "success": false,
  "message": "Synn error: Insufficient balance"
}

Request Body (JSON)

api_id

API ID

required

api_key

API KEY

required

signature

MD5 Hash (api_id + api_key)

required

order_id

Order ID from /order response

required

Request Example:

{
  "api_id": "hwurofj282",
  "api_key": "dc61633005ccwfwirhn3nfnbee933fc309b4",
  "signature": "714b7b109dc3r39938rjf206f6fc596ad94b",
  "order_id": "KSTORE20260721231723"
}

Success Response

{
  "status": true,
  "msg": "Transaction details retrieved successfully",
  "data": {
    "order_id": "KSTORE20260721231723",
    "status": "Success",
    "note": ""
  }
}

Status Values:

Process - Order sedang diproses
Success - Order berhasil
Failed - Order gagal
Pending - Menunggu pembayaran

Failed Response

{
  "status": false,
  "msg": "order_id not found",
  "data": {
    "order_id": "",
    "status": "error",
    "note": "Order not found"
  }
}

Request Body (JSON)

User ID

required

zone

Server/Zone ID

optional

code

Game Code (ml, ff, etc.)

required

Request Example:

{
  "id": "409094931",
  "zone": "9837",
  "code": "ml"
}

Success Response

{
  "status": true,
  "data": {
    "username": "Seth Glory",
    "id": "409094931",
    "zone": "9837"
  }
}

Failed Response

{
  "status": false,
  "message": "User not found"
}