Dokumentasi REST API YNA-PREM

Selamat datang di dokumentasi REST API resmi YNA-PREM. Layanan API ini memungkinkan developer (Bot WhatsApp, Bot Telegram, Web Store, atau Aplikasi Custom) membuat dan memverifikasi pesanan Alight Motion Premium secara instan 24 jam nonstop.

Base URL API

https://prem.ynastore.my.id/api/v1

Autentikasi Header

Seluruh endpoint /api/v1/* dilindungi API key pribadi milik akun kamu. Sertakan API key di setiap request melalui header X-Api-Key:

X-Api-Key: yna-premxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Format Response & Error

Semua response API dikembalikan dalam format objek JSON standar:

{
  "status": "success",
  "message": "Order berhasil dibuat & magic link sudah dikirim.",
  "data": { ... }
}

Rate Limit & Keamanan

Setiap API Key dibatasi kuota standar untuk menjaga kestabilan server bagi semua developer. Jika melebihi batas, server mengembalikan response HTTP 429 Too Many Requests.

1. POST /am/create (Order Satuan)

Membuat pesanan akun Alight Motion Premium satuan dan mengirimkan magic link ke email tujuan.

curl -X POST https://prem.ynastore.my.id/api/v1/am/create \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "customer@gmail.com"}'

{
  "status": "success",
  "message": "Order berhasil dibuat & magic link verifikasi sudah dikirim ke email tujuan.",
  "data": {
    "order_id": "ord_a1b2c3d4e5f6",
    "status": "menunggu_verifikasi_user",
    "email_target": "customer@gmail.com",
    "payment_method": "saldo",
    "amount_charged": 1500,
    "created_at": "2026-08-30T04:10:00.000Z"
  }
}

2. POST /am/verify (Submit Verifikasi)

Menyelesaikan proses aktivasi akun Alight Motion Pro dengan mengirimkan tautan magic link dari email.

curl -X POST https://prem.ynastore.my.id/api/v1/am/verify \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "ord_a1b2c3d4e5f6",
    "rawUrl": "https://alightcreative.com/auth_action/?token=..."
  }'

{
  "status": "success",
  "message": "Alight Motion Premium berhasil diaktifkan ke email tujuan.",
  "data": {
    "order_id": "ord_a1b2c3d4e5f6",
    "status": "sukses",
    "email_target": "customer@gmail.com",
    "payment_method": "saldo",
    "amount_charged": 1500,
    "updated_at": "2026-08-30T04:10:09.000Z"
  }
}

3. GET /am/status/:order_id (Cek Status Order)

Mengecek status terkini dari pesanan satuan secara real-time.

curl -X GET https://prem.ynastore.my.id/api/v1/am/status/ord_a1b2c3d4e5f6 \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "status": "success",
  "message": "Status order berhasil diambil.",
  "data": {
    "order_id": "ord_a1b2c3d4e5f6",
    "status": "sukses",
    "email_target": "customer@gmail.com",
    "amount_charged": 1500,
    "created_at": "2026-08-30T04:10:00.000Z"
  }
}

4. POST /am/bulk (Create Order Massal 1 - 50 Akun)

Membuat banyak akun Alight Motion Pro sekaligus secara 100% otomatis (auto create email @prem.ynastore.my.id, auto aktivasi 1 tahun, auto refund jika ada yang gagal).

curl -X POST https://prem.ynastore.my.id/api/v1/am/bulk \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 5}'

{
  "status": "success",
  "message": "Pembuatan akun massal selesai (5/5 akun berhasil dibuat).",
  "data": {
    "order_id": "BULK-1787954900-A8B9",
    "payment_type": "plan",
    "total_requested": 5,
    "success_count": 5,
    "failed_count": 0,
    "accounts": [
      {
        "email": "am.yna8910ab@prem.ynastore.my.id",
        "login_url": "https://mail.ynastore.my.id/inbox?email=am.yna8910ab%40prem.ynastore.my.id",
        "status": "SUCCESS",
        "activated_at": "2026-08-30T05:30:00.000Z"
      }
    ]
  }
}

5. GET /am/bulk/:order_id (Detail Order Massal)

Mengambil rincian seluruh daftar email dan tautan login dari pesanan massal.

curl -X GET https://prem.ynastore.my.id/api/v1/am/bulk/BULK-1787954900-A8B9 \
  -H "X-Api-Key: YOUR_API_KEY"

POST /api/v1/getcontact

Melakukan pengecekan identitas nomor telepon secara lengkap dan real-time: seluruh daftar tagar GetContact, nama kontak utama, operator seluler, tipe kartu, wilayah asal registrasi HLR, dan skor spam.

Headers Wajib

Request Body (JSON)

Contoh Request (cURL & Node.js)

curl -X POST https://prem.ynastore.my.id/api/v1/getcontact \
  -H "X-Api-Key: yna-premo2awilCjrSYBrwG7" \
  -H "Content-Type: application/json" \
  -d '{"phone": "083138675899"}'

const axios = require('axios');

async function cekGetContact(nomorTarget) {
  try {
    const res = await axios.post('https://prem.ynastore.my.id/api/v1/getcontact', {
      phone: nomorTarget
    }, {
      headers: {
        'X-Api-Key': 'yna-premo2awilCjrSYBrwG7',
        'Content-Type': 'application/json'
      }
    });

    console.log("Status:", res.data.message);
    console.log("Nama Utama:", res.data.data.data.name);
    console.log("Total Tagar:", res.data.data.data.total_tags);
    console.log("Laporan Teks:", res.data.data.formatted_report);
  } catch (err) {
    console.error("Gagal:", err.response?.data || err.message);
  }
}

cekGetContact('083138675899');

const res = await fetch('https://prem.ynastore.my.id/api/v1/getcontact', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'yna-premo2awilCjrSYBrwG7',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ phone: '083138675899' })
});

const data = await res.json();
console.log(data);

Contoh Response Sukses (200 OK)

{
  "status": "success",
  "message": "Data GetContact & HLR berhasil diambil.",
  "data": {
    "order_id": "GC-9F2B4D1C",
    "amount_charged": 1000,
    "remaining_saldo": 12327924,
    "data": {
      "phone": "+6283138675899",
      "name": "Yuna",
      "operator": "AXIS (XL Axiata)",
      "card": "AXIS Prabayar",
      "region": "Sumatera (Riau / Sumut / Sumbar / Aceh)",
      "score": "0% (100% Aman & Terpercaya)",
      "total_tags": 47,
      "tags": [
        "Yuna",
        "Yna Store",
        "Tabayyuna",
        "Sewa Bot"
      ],
      "checked_at": "31 Agustus 2026, 14:20 WIB",
      "from_cache": false
    },
    "formatted_report": "╭───❖ *GETCONTACT REPORT* ❖───╮\n│ 📅 *Waktu Cek*   : 31 Agustus 2026, 14:20 WIB\n│ ⚡ *Status Data* : Terverifikasi\n├────────────────────────────\n│ 👤 *Nama Utama*  : *Yuna*\n│ 📞 *Nomor Target*: *+6283138675899*\n│ 📶 *Operator*    : *AXIS (XL Axiata)* (AXIS Prabayar)\n│ 📍 *Wilayah HLR* : *Sumatera (Riau / Sumut / Sumbar / Aceh)*\n│ 🛡️ *Status Spam* : *0% (100% Aman & Terpercaya)*\n│ 🏷️ *Total Tagar* : *47* Tagar Terdaftar\n├────────────────────────────\n│ 📋 *DAFTAR LENGKAP SEMUA TAGAR:*\n│ [01] Yuna\n│ [02] Yna Store\n│ [03] Tabayyuna\n│ [04] Sewa Bot\n╰────────────────────────────╯\n👑 *Official by:* YNA STORE • https://ynastore.my.id"
  }
}

Contoh Response Saldo Tidak Cukup (402 Payment Required)

{
  "status": "error",
  "code": "INSUFFICIENT_SALDO",
  "message": "Saldo YNA PREM tidak mencukupi untuk melakukan pengecekan nomor (Biaya: Rp 1.000, Saldo saat ini: Rp 0). Silakan deposit saldo terlebih dahulu.",
  "data": {
    "current_saldo": 0,
    "required_saldo": 1000
  }
}

GET /api/v1/getcontact/info

Mengecek status ketersediaan dan detail harga layanan GetContact & HLR Intelligence.

Contoh Response Sukses (200 OK)

{
  "status": "success",
  "message": "Layanan GetContact Lookup Aktif.",
  "data": {
    "service": "GetContact Tagar & HLR Intelligence",
    "price_per_lookup": 1000,
    "payment_type": "saldo_yna_prem",
    "description": "Menampilkan seluruh daftar tagar real-time, nama kontak utama, operator, wilayah asal registrasi HLR, dan skor spam."
  }
}

PLUGIN Contoh Integrasi Bot WhatsApp (Baileys / Node.js)

Kode siap pakai untuk dipasang pada bot WhatsApp kamu. Menggunakan endpoint resmi YNA PREM dengan saldo akun otomatis:

/**
 * Plugin Bot WhatsApp: Cek GetContact via YNA PREM API
 */
const axios = require('axios');

const YNAPREM_API_KEY = "MASUKKAN_APIKEY_YNA_PREM_KAMU";

async function handleGetContact(sock, remoteJid, message, targetNumber) {
  await sock.sendMessage(remoteJid, { react: { text: "⏳", key: message.key } });

  try {
    const response = await axios.post('https://prem.ynastore.my.id/api/v1/getcontact', {
      phone: targetNumber
    }, {
      headers: {
        'X-Api-Key': YNAPREM_API_KEY,
        'Content-Type': 'application/json'
      }
    });

    const data = response.data.data;
    await sock.sendMessage(remoteJid, { react: { text: "✅", key: message.key } });

    // Kirim laporan yang sudah terformat rapi
    await sock.sendMessage(remoteJid, {
      text: data.formatted_report
    }, { quoted: message });

  } catch (err) {
    await sock.sendMessage(remoteJid, { react: { text: "❌", key: message.key } });
    const errMsg = err.response?.data?.message || err.message || "Gagal cek GetContact.";
    await sock.sendMessage(remoteJid, {
      text: "❌ *Pengecekan Gagal:*\n" + errMsg
    }, { quoted: message });
  }
}

module.exports = { handleGetContact };

6. GET /account/balance (Cek Saldo & Limit Plan)

Mengecek saldo aktif dan sisa limit harian Paket Plan kamu saat ini.

curl -X GET https://prem.ynastore.my.id/api/v1/account/balance \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "status": "success",
  "message": "Saldo berhasil diambil.",
  "data": {
    "saldo": 50000,
    "saldo_hold": 0,
    "total": 50000
  }
}

7. GET /account/history (Riwayat Transaksi)

Mengambil daftar riwayat seluruh transaksi dan pesanan akun kamu.

curl -X GET "https://prem.ynastore.my.id/api/v1/account/history?page=1&limit=10" \
  -H "X-Api-Key: YOUR_API_KEY"

Contoh Alur Integrasi Bot WhatsApp Reseller

Berikut alur implementasi rekomendasi untuk bot WhatsApp toko Anda:

1. Buyer memesan via chat WA dan memasukkan email mereka.
2. Bot memanggil POST /api/v1/am/create dengan parameter email.
3. Bot menginstruksikan buyer untuk mengecek inbox/spam email dan menyalin link tombol aktivasi.
4. Buyer mengirimkan link verifikasi ke bot WhatsApp.
5. Bot memanggil POST /api/v1/am/verify dengan order_id dan rawUrl.
6. Bot memberitahu buyer bahwa akun Alight Motion Pro 1 Tahun sudah aktif!