Dokumentasi API

Integrasikan layanan SMM dan PPOB SoloSmartPedia langsung ke dalam sistem atau aplikasi Anda dengan RESTful API yang cepat dan stabil.

API Version
v1.0
Format
JSON
Daftar Isi
Pendahuluan
Autentikasi
Akun & Saldo
Layanan
Daftar Layanan
Transaksi Prabayar
Transaksi Pascabayar
Transaksi SMM
Cek ID PLN
Referensi
Kode Respons
Butuh Bantuan Integrasi?
Tim IT kami siap membantu Anda 24/7.
Hubungi Kami

Mulai Integrasi

REST API SoloSmartPedia dirancang untuk memudahkan developer dalam menghubungkan sistem mereka dengan layanan PPOB dan SMM kami. Semua respons dienkapsulasi dalam format JSON yang standar.

Base URL: Semua endpoint dalam dokumentasi ini merujuk pada URL dasar:
https://solosmartpedia.com/api/v1
Dapatkan API Key

Untuk dapat mengakses API, Anda harus memiliki akun dan meng-generate API Key di pengaturan profil.

  1. Daftar akun di SoloSmartPedia
  2. Masuk ke menu Profil > Pengaturan API
  3. Masukkan IP Address server Anda ke dalam daftar Whitelist
  4. Salin API Key Anda

Autentikasi & Keamanan

Demi keamanan, SoloSmartPedia menerapkan dua lapis verifikasi untuk setiap request API.

1. API Key Parameter

Setiap request wajib menyertakan parameter api_key baik di body (POST) maupun di URL (GET).

2. IP Whitelist

Hanya IP Address yang telah Anda daftarkan di dashboard yang dapat melakukan request menggunakan API Key Anda.

Peringatan Keamanan
Jangan pernah mengekspos API Key Anda di sisi client (seperti javascript frontend, aplikasi mobile tanpa enkripsi). Lakukan request selalu melalui backend server Anda.
GET

Cek Profil Akun

Mengambil data profil beserta sisa saldo akun Anda.

GET https://solosmartpedia.com/api/v1/profile?api_key={api_key}
Response (200 OK) application/json 
{
  "status": true,
  "data": {
    "username": "user123",
    "name": "John Doe",
    "email": "john@example.com",
    "balance": 1500000,
    "tier": "gold",
    "status": "active"
  }
}
GET

Cek Saldo Saja

Endpoint ringan untuk mengecek nominal saldo secara cepat.

GET https://solosmartpedia.com/api/v1/balance?api_key={api_key}
Response (200 OK) 
{
  "status": true,
  "data": {
    "balance": 1500000
  }
}
GET

Daftar Layanan

Mengambil daftar layanan beserta harga yang sudah disesuaikan dengan tier akun Anda.

GET https://solosmartpedia.com/api/v1/services/prepaid
GET https://solosmartpedia.com/api/v1/services/postpaid
GET https://solosmartpedia.com/api/v1/services/socialmedia
Query Parameters
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
category Opsional Filter layanan berdasarkan kategori
POST

Buat Pesanan Prabayar

POST https://solosmartpedia.com/api/v1/order/prepaid
Body Parameters
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
service_id Wajib ID layanan prabayar (didapat dari daftar layanan)
target Wajib Nomor HP, ID Pelanggan, atau ID Game
pin Wajib PIN Transaksi Akun Anda (6 digit)
Response Success (200 OK) 
{
  "status": true,
  "message": "Pesanan berhasil dibuat",
  "data": {
    "order_id": "TRX-12345",
    "service_name": "Telkomsel 10K",
    "target": "081234567890",
    "price": 10250,
    "status": "Pending"
  }
}
GET

Status & Riwayat Prabayar

GET https://solosmartpedia.com/api/v1/order/prepaid/status?api_key=...&order_id=...
GET https://solosmartpedia.com/api/v1/order/prepaid/history?api_key=...&limit=20
POST

Buat Pesanan Pascabayar (Bayar Tagihan)

POST https://solosmartpedia.com/api/v1/order/postpaid
Body Parameters
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
service_id Wajib ID layanan pascabayar
target Wajib Nomor pelanggan / No. Tagihan
pin Wajib PIN Transaksi Akun Anda (6 digit)
Penting: Endpoint ini akan langsung melakukan pengecekan tagihan dan memotong saldo jika tagihan valid.
GET

Status & Riwayat Pascabayar

GET https://solosmartpedia.com/api/v1/order/postpaid/status?api_key=...&order_id=...
GET https://solosmartpedia.com/api/v1/order/postpaid/history?api_key=...&limit=20
POST

Buat Pesanan Social Media

POST https://solosmartpedia.com/api/v1/order/socialmedia
Body Parameters
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
service_id Wajib ID layanan socmed
target Wajib Target (URL/Username)
quantity Wajib Jumlah pesanan
pin Wajib PIN Transaksi (6 digit)
custom_comments Opsional Komentar khusus jika layanan custom comments
custom_link Opsional Link khusus jika layanan membutuhkan custom link
POST

Ajukan Refill Pesanan

POST https://solosmartpedia.com/api/v1/order/socialmedia/refill
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
order_id Wajib ID Pesanan (dari status)

*Refill hanya berlaku untuk layanan yang berlogo ♻️ (support refill) dan orderan yang sudah berstatus Success lebih dari 2 hari.

GET

Status & Riwayat Socmed

GET https://solosmartpedia.com/api/v1/order/socialmedia/status?api_key=...&order_id=...
GET https://solosmartpedia.com/api/v1/order/socialmedia/history?api_key=...&limit=20
GET https://solosmartpedia.com/api/v1/order/socialmedia/refill/history?api_key=...&limit=20
POST

Cek ID Pelanggan PLN Prabayar

POST https://solosmartpedia.com/api/v1/inquiry/pln
Body Parameters
Parameter Wajib Deskripsi
api_key Wajib API Key akun Anda
target Wajib Nomor Meter / ID Pelanggan PLN

Kode Respons HTTP

Kode Status Deskripsi
200 OK Request berhasil diproses. Saldo dipotong (jika order)
400 Bad Request Parameter tidak valid, tidak lengkap, atau format salah
401 Unauthorized API Key tidak valid, tidak aktif, IP belum diwhitelist, atau PIN salah
402 Payment Required Saldo Anda tidak mencukupi untuk melakukan transaksi ini
500 Server Error Terjadi kendala teknis pada server kami atau provider