Developer Portal

Lyva Indonesia Public API

v1 · STABLE

Cek ID game · katalog produk · order saldo · webhook callback · tagihan

Beranda Ambil API Key

API v1

API Key

Minku Developer Hub · Public APILive

Public API Cek ID Game, Katalog & Order Saldo Tercepat

REST JSON terpadu dengan autentikasi API ID + API Key, whitelist IP ketat, pemesanan otomatis potong saldo Lyva Indonesia, serta webhook HMAC SHA256 realtime.

ONLINE 99.9%

Base URL Endpoint

https://lyvaindonesia.com/api/v1

Header ID

X-GIMSKU-Api-Id

Secret Key

X-API-Key

💡 Order API otomatis memotong saldo akun Lyva Indonesia. Kuota harian gratis 1.000 req/hari khusus untuk endpoint Cek ID Game.

Uptime GatewayRealtime

99.9%

Multi-provider failover otomatis

Cek ID GameGratis

< 350ms

Free 1.000 req/hari

Batas Rate LimitSafe Limit

60 req/mnt

Bisa dinaikkan via support

Webhook CallbackVerified

HMAC SHA256

Retry hingga 5 kali

Credential Wajib

API Lyva Indonesia memakai API ID + API Key

Semua request API harus membawa X-GIMSKU-Api-Id dan X-API-Key. Order produk memotong saldo Lyva Indonesia otomatis. Kuota harian hanya untuk endpoint cek ID game.

1. Ambil Credential

Buat API ID, API Key, dan Sign di Profil.

2. Isi Keamanan

Whitelist IP dan Callback URL bisa diatur per API.

Order API memotong saldo sesuai harga produk.

Callback akan dikirim ke URL yang kamu simpan di Profil. Validasi request masuk dengan header X-GIMSKU-Signature memakai HMAC SHA256 dan Sign secret.

cURL · products

curl https://lyvaindonesia.com/api/v1/products \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY"

Callback header

X-GIMSKU-Api-Id: apk_YOUR_API_ID
X-GIMSKU-Signature: hmac_sha256_raw_body

API Reference

Semua endpoint publik

Klik kartu untuk lompat ke detail request, response, dan contoh.

GETPOSTWEBHOOK

Autentikasi API

Gunakan API ID dan API Key dari halaman Profil

Semua endpoint public API membutuhkan credential aktif: API ID dan API Key. API ID dipakai sebagai identitas aplikasi/reseller, sedangkan API Key dipakai sebagai secret request. Dapatkan credential melalui Profil Akun dengan login akun Google. Jika Whitelist IP diisi, request dari IP lain akan ditolak.

Header Utama

Rekomendasi untuk semua integrasi server-to-server:

X-GIMSKU-Api-Id: apk_xxx
X-API-Key: gimsku_xxx

Kompatibilitas

Bearer masih diterima. Key lama lyva_ dan header X-Lyva-* tetap didukung sementara agar integrasi lama tidak terputus.

X-GIMSKU-Api-Id: apk_xxx
Authorization: Bearer gimsku_xxx

Sign secret tidak dikirim saat request. Sign dipakai untuk memverifikasi callback dari Lyva Indonesia ke server kamu melalui header X-GIMSKU-Signature. Jangan pernah mengirim API key melalui query URL; gunakan header supaya secret tidak masuk ke log atau riwayat browser.

Endpoint Base URL

https://lyvaindonesia.com

CORS Diaktifkan

POST/api/v1/game-id/check

Verifikasi User ID & Nickname

Melakukan verifikasi Player ID untuk game tertentu dan mengembalikan informasi profil player, termasuk nama panggilan (*nickname*). Beberapa game membutuhkan `zoneId` / parameter server.

Request Body (JSON)

Field	Tipe	Wajib	Keterangan
game	string	Ya	Kode game dari katalog, misal: `mobile-legends` atau `free-fire`
userId	string	Ya	ID unik player yang terdaftar di game
zoneId	string	Kondisional	Wajib jika game membutuhkan zona/server ID (contoh: MLBB)

Contoh Response Sukses (200 OK)

{
  "result": true,
  "message": "Verifikasi berhasil.",
  "data": {
    "valid": true,
    "game": "free-fire",
    "gameName": "Free Fire",
    "userId": "225009777",
    "nickname": "FRNTL-SHOP",
    "country": {
      "code": "ID",
      "name": "ID"
    },
    "provider": "LYVA"
  }
}

GET/api/v1/game-id/games

Daftar Game Pendukung

Mengambil data semua game yang didukung untuk validasi nickname. Response mencakup kode unik game, nama panjang, serta requirement server (`requiresZone`).

Contoh Response Sukses (200 OK)

{
  "result": true,
  "message": "OK",
  "data": {
    "games": [
      {
        "code": "mobile-legends",
        "name": "Mobile Legends: Bang Bang",
        "requiresZone": true,
        "zoneLabel": "Zone ID"
      },
      {
        "code": "free-fire",
        "name": "Free Fire",
        "requiresZone": false
      }
    ],
    "total": 50
  }
}

GET/api/v1/products

List Produk Lyva Indonesia

Mengambil katalog produk Lyva Indonesia untuk top up game, prepaid, dan akun premium. Gunakan fieldidatau code saat membuat pesanan.

Query Opsional

Parameter	Contoh	Keterangan
source	game-feature / prepaid / premiumisme	Filter sumber produk
q	mobile legends	Cari nama produk, kategori, atau kode
limit	100	Maksimal 500 item per request

cURL · products

curl "https://lyvaindonesia.com/api/v1/products?q=mobile%20legends&limit=10" \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY"

{
  "result": true,
  "message": "Katalog produk Lyva Indonesia berhasil dimuat.",
  "data": [
    {
      "id": "game-feature:MLBB5",
      "source": "game-feature",
      "code": "MLBB5",
      "product": "Mobile Legends",
      "name": "5 Diamonds",
      "price": 1800,
      "status": "available",
      "targetFields": [
        {
          "key": "data_no",
          "label": "User ID",
          "required": true
        },
        {
          "key": "data_zone",
          "label": "Server / Zone ID",
          "required": true
        }
      ]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 10,
    "offset": 0
  }
}

POST/api/v1/orders

Order Pakai Saldo

Membuat pesanan produk Lyva Indonesia memakai saldo akun pemilik API key. Jika saldo tidak cukup, sistem akan mengembalikan error dan pesanan tidak diproses.

Request Body (JSON)

Field	Wajib	Keterangan
productId	Ya	ID dari endpoint products, contoh `game-feature:MLBB5`
dataNo	Ya	User ID, email, nomor HP, atau tujuan sesuai targetFields
dataZone	Kondisional	Wajib jika targetFields produk meminta server/zone

cURL · create order

curl -X POST https://lyvaindonesia.com/api/v1/orders \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "game-feature:MLBB5",
    "dataNo": "12345678",
    "dataZone": "1234"
  }'

{
  "result": true,
  "message": "Pesanan dibuat dan dibayar memakai saldo Lyva Indonesia.",
  "data": {
    "order": {
      "transactionId": "LYVA17870000001234",
      "product": "5 Diamonds",
      "paymentMethod": "Saldo Lyva Indonesia API",
      "paymentStatus": "paid",
      "fulfillmentStatus": "processing",
      "total": 1800
    },
    "wallet": {
      "previousBalance": 50000,
      "nextBalance": 48200,
      "charged": 1800
    }
  }
}

GET/api/v1/orders/{transactionId}

Tracking Pesanan API

Mengecek status pembayaran dan pengiriman untuk pesanan yang dibuat oleh API key yang sama. Detail kode delivery tidak dibuka lewat endpoint publik.

cURL · order status

curl https://lyvaindonesia.com/api/v1/orders/LYVA17870000001234 \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY"

Callback tersedia

Detail callback lengkap ada di section Callback API. Isi Callback URL di halaman Profil supaya server kamu menerima update otomatis.

Webhook / Callback

Dokumentasi Callback API

Callback dikirim otomatis ke server kamu saat status pesanan API berubah. URL callback, whitelist IP, API ID, API Key, dan Sign secret bisa diatur dari halaman Profil akun.

Atur Callback

Method

POST

Lyva Indonesia mengirim JSON ke Callback URL yang kamu simpan.

Content Type

application/json

Body harus diverifikasi dari raw JSON asli.

Signature

HMAC SHA256

Gunakan Sign secret dari API credential kamu.

Header Callback

Content-Type: application/json
X-GIMSKU-Api-Id: apk_YOUR_API_ID
X-GIMSKU-Signature: 0f7b...hmac_sha256

X-GIMSKU-Signature dibuat dari HMAC SHA256 raw body callback memakai Sign secret.

Event yang Dikirim

payment_paid - pembayaran/saldo sudah terpotong

fulfillment_processing - pesanan sedang diproses

fulfillment_success - pesanan selesai

fulfillment_failed - pesanan gagal atau perlu bantuan

Contoh Payload Callback

{
  "event": "fulfillment_success",
  "api_id": "apk_YOUR_API_ID",
  "transaction_id": "LYVA17870000001234",
  "product": "5 Diamonds",
  "service_code": "MLBB5",
  "source": "game-feature",
  "total": 1800,
  "payment_status": "paid",
  "fulfillment_status": "success",
  "note": "Pesanan selesai.",
  "updated_at": "2026-07-10T08:00:00.000Z"
}

Contoh Verifikasi Node.js

// Node.js verify callback
const crypto = require("crypto");
const expected = crypto
  .createHmac("sha256", GIMSKU_SIGN_SECRET)
  .update(rawBody)
  .digest("hex");

if (expected !== req.headers["x-gimsku-signature"]) {
  throw new Error("Invalid GIMSKU callback signature");
}

Aturan Response Server Kamu

Balas HTTP 200 atau 2xx jika callback berhasil diterima.

Jika server kamu timeout atau membalas non-2xx, callback akan dicatat sebagai gagal di log API Profil.

Simpan transaction_id sebagai idempotency key supaya update yang sama tidak diproses dua kali.

POST/api/v1/bills/check

Cek Nama PLN & Tagihan

Cek nama pemilik meter PLN, tagihan listrik pascabayar, atau tagihan PDAM. Tidak perlu token provider eksternal — cukup API key Lyva Indonesia.

Request Body (JSON)

Field	Tipe	Wajib	Keterangan
service	string	Ya	`pln-prepaid`, `pln-postpaid`, `pdam`, `internet-tv`
customerNumber	string	Ya	No. meter / ID pelanggan / nomor tagihan
operatorCode	string	Kondisional	Wajib untuk `pdam` / `internet-tv` (lihat endpoint operators)
phone	string	Tidak	No. HP opsional (format 08…)

Contoh cURL

curl -X POST https://lyvaindonesia.com/api/v1/bills/check \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"pln-prepaid","customerNumber":"12345678901"}'

Contoh Response

{
  "result": false,
  "message": "Nomor tidak sesuai",
  "data": {
    "valid": false,
    "service": "pln-prepaid",
    "serviceName": "PLN Prabayar (Cek Nama)",
    "customerNumber": "12345678901",
    "provider": "LYVA"
  }
}

GET/api/v1/bills/services

Daftar layanan tagihan

Daftar service yang bisa dipakai di field service pada endpoint cek tagihan.

curl https://lyvaindonesia.com/api/v1/bills/services \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY"

GET/api/v1/bills/operators?service=pdam

Operator / wilayah

Ambil daftar operator untuk service yang butuh operatorCode (contoh: PDAM 180+ wilayah, Internet/TV).

curl "https://lyvaindonesia.com/api/v1/bills/operators?service=pdam" \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY"

{
  "result": true,
  "message": "OK",
  "data": {
    "service": "pdam",
    "operators": [
      {
        "code": "pdam pam jaya",
        "name": "PAM Jaya"
      },
      {
        "code": "pdam kota bandung",
        "name": "PDAM Kota Bandung (jabar)"
      }
    ],
    "total": 183
  }
}

API Playground

Tes request langsung di browser

API Key Anda

Pilih Game

User ID / Player ID

Zone ID

Response Payload

Masukkan API Key & isi parameter form untuk mencoba menembak API secara langsung.

Snippet Integrasi

Check ID

curl -X POST https://lyvaindonesia.com/api/v1/game-id/check \
  -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \
  -H "X-API-Key: gimsku_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game":"mobile-legends","userId":"1114917746","zoneId":"13486"}'

Daftar Response Status

200 OKValidasi ID Berhasil

400 Bad RequestParameter Kurang

401 UnauthorizedToken API Salah

429 Rate LimitKuota Terlampaui

Daftar Kode & Alias Game

Pencarian parameter game untuk endpoint cek ID

Nama Game	Kode Parameter (`game`)	Server / Zone ID
Mobile Legends: Bang Bang mobile-legends-bang-bangmlbbml	mobile-legends	Wajib (Zone ID)
Free Fire ffgarena-free-firefree-fire-max	free-fire	Tidak Butuh
PUBG Mobile pubgpubgmpubg-mobile-uc	pubg-mobile	Tidak Butuh
Valorant valo	valorant	Tidak Butuh
Honor of Kings hokhonorofkingswangzhe	honor-of-kings	Tidak Butuh
EA Sports FC Mobile fcmobilefcmefootball	fc-mobile	Tidak Butuh
League of Legends: Wild Rift lol-wild-riftwrwildrift	wild-rift	Tidak Butuh
Genshin Impact genshingi	genshin-impact	Wajib (Server)

Menampilkan 1-8 dari 124 game didukung

Catatan Keamanan & Tips Implementasi

Panduan teknis pencegahan rate-limit dan kebocoran token

Proxying Dari Backend

Untuk menghindari pencurian API Key, disarankan melakukan request dari backend server Anda sendiri (NodeJS, Python, PHP, Go) alih-alih mengekspos API Key langsung di HTML/JS client side browser luar.

Pantau Kuota Cek ID

Header X-RateLimit-* hanya muncul untuk endpoint cek ID game. Setelah kuota gratis harian habis, cek ID game otomatis memakai saldo akun sebesar Rp15/request; jika saldo tidak cukup, response menjadi 429 Too Many Requests.

Antisipasi Error Sistem (502)

Server game terkadang mengalami maintenance berkala atau gangguan sementara. Antisipasi kegagalan respons dengan mengimplementasikan retry logic dengan jeda waktu (*exponential backoff*).

Kelola API Key di Profil Kembali ke Beranda

Butuh Bantuan Integrasi API Lyva Indonesia?

Tim developer & customer support Lyva Indonesia siap membantu setup API Key, Whitelist IP, Callback HMAC SHA256, dan pengujian order live 24/7.

Hubungi Support WhatsApp Buat API Key di Profil

Field

Tipe

Wajib

Keterangan

game

string

Kode game dari katalog, misal: mobile-legends atau free-fire

userId

string

ID unik player yang terdaftar di game

zoneId

string

Kondisional

Wajib jika game membutuhkan zona/server ID (contoh: MLBB)

{

"result": true,

"message": "Verifikasi berhasil.",

"data": {

"valid": true,

"game": "free-fire",

"gameName": "Free Fire",

"userId": "225009777",

"nickname": "FRNTL-SHOP",

"country": {

"code": "ID",

"name": "ID"

"provider": "LYVA"

}

{

"result": true,

"message": "OK",

"data": {

"games": [

{

"code": "mobile-legends",

"name": "Mobile Legends: Bang Bang",

"requiresZone": true,

"zoneLabel": "Zone ID"

{

"code": "free-fire",

"name": "Free Fire",

"requiresZone": false

}

"total": 50

}

Parameter

Contoh

Keterangan

source

game-feature / prepaid / premiumisme

Filter sumber produk

mobile legends

Cari nama produk, kategori, atau kode

limit

100

Maksimal 500 item per request

{

"result": true,

"message": "Katalog produk Lyva Indonesia berhasil dimuat.",

"data": [

{

"id": "game-feature:MLBB5",

"source": "game-feature",

"code": "MLBB5",

"product": "Mobile Legends",

"name": "5 Diamonds",

"price": 1800,

"status": "available",

"targetFields": [

{

"key": "data_no",

"label": "User ID",

"required": true

{

"key": "data_zone",

"label": "Server / Zone ID",

"required": true

}

]

}

"meta": {

"total": 1,

"limit": 10,

"offset": 0

}

Field

Wajib

Keterangan

productId

ID dari endpoint products, contoh game-feature:MLBB5

dataNo

User ID, email, nomor HP, atau tujuan sesuai targetFields

dataZone

Kondisional

Wajib jika targetFields produk meminta server/zone

curl -X POST https://lyvaindonesia.com/api/v1/orders \ -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \ -H "X-API-Key: gimsku_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "productId": "game-feature:MLBB5", "dataNo": "12345678", "dataZone": "1234" }'

{

"result": true,

"message": "Pesanan dibuat dan dibayar memakai saldo Lyva Indonesia.",

"data": {

"order": {

"transactionId": "LYVA17870000001234",

"product": "5 Diamonds",

"paymentMethod": "Saldo Lyva Indonesia API",

"paymentStatus": "paid",

"fulfillmentStatus": "processing",

"total": 1800

"wallet": {

"previousBalance": 50000,

"nextBalance": 48200,

"charged": 1800

}

{

"event": "fulfillment_success",

"api_id": "apk_YOUR_API_ID",

"transaction_id": "LYVA17870000001234",

"product": "5 Diamonds",

"service_code": "MLBB5",

"source": "game-feature",

"total": 1800,

"payment_status": "paid",

"fulfillment_status": "success",

"note": "Pesanan selesai.",

"updated_at": "2026-07-10T08:00:00.000Z"

}

// Node.js verify callback const crypto = require("crypto"); const expected = crypto .createHmac("sha256", GIMSKU_SIGN_SECRET) .update(rawBody) .digest("hex"); if (expected !== req.headers["x-gimsku-signature"]) { throw new Error("Invalid GIMSKU callback signature"); }

Field

Tipe

Wajib

Keterangan

service

string

pln-prepaid, pln-postpaid, pdam, internet-tv

customerNumber

string

No. meter / ID pelanggan / nomor tagihan

operatorCode

string

Kondisional

Wajib untuk pdam / internet-tv (lihat endpoint operators)

phone

string

Tidak

No. HP opsional (format 08…)

curl -X POST https://lyvaindonesia.com/api/v1/bills/check \ -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \ -H "X-API-Key: gimsku_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"service":"pln-prepaid","customerNumber":"12345678901"}'

{

"result": false,

"message": "Nomor tidak sesuai",

"data": {

"valid": false,

"service": "pln-prepaid",

"serviceName": "PLN Prabayar (Cek Nama)",

"customerNumber": "12345678901",

"provider": "LYVA"

}

{

"result": true,

"message": "OK",

"data": {

"service": "pdam",

"operators": [

{

"code": "pdam pam jaya",

"name": "PAM Jaya"

{

"code": "pdam kota bandung",

"name": "PDAM Kota Bandung (jabar)"

}

"total": 183

}

curl -X POST https://lyvaindonesia.com/api/v1/game-id/check \ -H "X-GIMSKU-Api-Id: apk_YOUR_API_ID" \ -H "X-API-Key: gimsku_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"game":"mobile-legends","userId":"1114917746","zoneId":"13486"}'

Nama Game

Kode Parameter (game)

Server / Zone ID

Aksi

Mobile Legends: Bang Bang

mobile-legends-bang-bangmlbbml

mobile-legends

Wajib (Zone ID)

Free Fire

ffgarena-free-firefree-fire-max

free-fire

Tidak Butuh

PUBG Mobile

pubgpubgmpubg-mobile-uc

pubg-mobile

Tidak Butuh

Valorant

valo

valorant

Tidak Butuh

Honor of Kings

hokhonorofkingswangzhe

honor-of-kings

Tidak Butuh

EA Sports FC Mobile

fcmobilefcmefootball

fc-mobile

Tidak Butuh

League of Legends: Wild Rift

lol-wild-riftwrwildrift

wild-rift

Tidak Butuh

Genshin Impact

genshingi

genshin-impact

Wajib (Server)