MRXPANEL / Developer API

MRXPANEL CORE · JSON V1 + SMM V2

Pusat API MRXPANEL

Hubungkan website SMM atau sistem reseller ke layanan MRXPANEL. Kelola API Key, cek saldo, buat pesanan, dan pantau status secara otomatis.

API SMM STANDAR · KOMPATIBILITAS AWAL

API Standar SMM — URL & API Key

Jika website SMM Anda memiliki menu Providers → Add Provider, masukkan URL API berikut bersama API Key dari akun MRXPANEL Anda.

https://api.mrxpanel.com/api/v2

Pengaturan provider: API URL sesuai alamat di atas · API Key dari menu di bawah · Metode POST · Format application/x-www-form-urlencoded · Mata uang IDR.

Action	Fungsi	Respons standar
`services`	Daftar layanan Default, harga per 1.000, dan batas minimum–maksimum yang mengikuti rute provider aktif	Array layanan
`balance`	Cek saldo MRXPANEL	`{"balance":"25000.00","currency":"IDR"}`
`add`	Buat pesanan dengan `service`, `link`, `quantity`	`{"order":12345}`
`status`	Cek satu pesanan melalui `order` atau hingga 100 pesanan melalui `orders`. Biaya status memperhitungkan refund yang sudah tercatat di wallet	Status, charge, start_count, remains

Contoh membuat pesanan SMM (memakai saldo)

Sebelum mengirim: aktifkan izin orders:create secara sengaja pada API Key, gunakan ID layanan yang benar-benar muncul dalam daftar services, dan pastikan jumlahnya memenuhi batas layanan. Pembuatan pesanan dapat mengurangi saldo MRXPANEL.

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=add" \
  --data-urlencode "service=ID_LAYANAN_VALID" \
  --data-urlencode "link=https://www.instagram.com/p/CONTOH/" \
  --data-urlencode "quantity=100" \
  --data-urlencode "request_id=website-ANDA-INV-00001"

request_id bersifat opsional, tetapi sangat dianjurkan untuk sistem reseller yang mendukungnya. Simpan satu ID yang tetap untuk satu pesanan; gunakan ID berbeda hanya untuk pesanan yang memang baru. Jangan mengulang permintaan otomatis saat koneksi timeout: cek riwayat pesanan dan gunakan action=status setelah memperoleh nomor pesanan. Untuk panel tanpa request_id, pencegahan pengulangan identik hanya berlaku dalam jendela 30 detik. Contoh di atas tidak menjalankan pesanan hingga Anda sendiri memakainya dengan key, layanan, dan target yang valid.

Aturan saat koneksi terputus: jangan mengirim action=add otomatis berkali-kali ketika hasilnya belum pasti. Periksa daftar pesanan dan saldo MRXPANEL dahulu. Jika pesanan tercatat, gunakan nomor order tersebut untuk memeriksa status. Jangan membuat request_id baru untuk kiriman pesanan pelanggan yang sama. request_id stabil bisa melindungi permintaan berulang yang sama; jika isinya berubah, gunakan ID baru hanya untuk pesanan berbeda.

Identitas order reseller (API V11): request_id dan client_request_id adalah dua nama untuk identitas pesanan yang sama pada API SMM V2. Sebaiknya kirim satu saja. Bila keduanya dikirim dan nilainya berbeda, API mengembalikan HTTP 400 sebelum order dibuat atau saldo dipotong. Bila ID yang sama digunakan untuk layanan, target, jumlah, atau website API yang berbeda, API mengembalikan HTTP 409. Jangan mengubah ID untuk mencoba mengatasi timeout: HTTP 503 dapat terjadi setelah order berhasil dibuat; periksa riwayat pesanan dan saldo, kemudian cek status bila nomor order sudah ada. Jangan kirim ulang action=add secara otomatis.

Contoh membaca status satu pesanan

Bila action=add telah mengembalikan {"order":12345}, simpan nomor itu di database reseller, lalu periksa status dengan aksi baca-saja:

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=status" \
  --data-urlencode "order=12345"

Parameter request_id mendukung huruf, angka, garis bawah (_), titik dua (:), dan tanda hubung (-) hingga 150 karakter. Gunakan satu ID stabil untuk satu pesanan reseller. Tanpa request_id, perlindungan pengiriman identik hanya selama 30 detik; lewat dari itu, pengiriman ulang dapat menghasilkan pesanan dan pemotongan saldo baru.

Jika aplikasi reseller mempunyai retry otomatis untuk request POST, nonaktifkan retry otomatis pada aksi add atau wajibkan pengecekan riwayat terlebih dahulu. Contoh permintaan di halaman ini tidak dijalankan otomatis; hanya kirim setelah pelanggan benar-benar memesan.

Pemeriksaan kelayakan Refill / Cancel (tanpa mengirim tindakan)

API menyediakan action=action_check untuk memeriksa pesanan milik akun sendiri sebelum mengajukan refill atau cancel. Fitur ini membutuhkan izin orders:read dan tidak menghubungi provider.

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=action_check" \
  --data-urlencode "order=12345" \
  --data-urlencode "type=refill"

Ubah type=cancel untuk memeriksa pembatalan. Respons meliputi eligible, status, action_status, provider_contacted:false dan request_submitted:false. Ini bukan endpoint pengajuan refill/cancel; jangan tampilkan kepada pelanggan sebagai tindakan berhasil.

Pengajuan refill dan cancel — antrean peninjauan

Status penting: MRXPANEL mencatat permintaan refill/cancel untuk ditinjau. Pengiriman otomatis ke provider belum tersedia (pengiriman manual oleh Super Admin setelah persetujuan dan konfirmasi terpisah sudah tersedia). Nomor yang diberikan adalah nomor permintaan, bukan bukti refill atau pembatalan sudah berhasil.

API Key wajib mempunyai izin orders:create untuk mengajukan, dan orders:read untuk memeriksa status. Hanya pesanan milik akun dan yang memenuhi syarat yang diterima. Permintaan ulang tindakan yang sama memakai nomor antrean yang sama.

Action	Parameter	Respons
`refill`	`order=12345` atau `orders=12345,12346`	Nomor refill, status Pending
`refill_status`	`refill=77` atau `refills=77,78`	Pending / In progress / Completed / Rejected
`cancel`	`orders=12345,12346`	Nomor permintaan atau alasan tidak memenuhi syarat

Contoh pengajuan refill

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=refill" \
  --data-urlencode "order=12345"

Contoh pemeriksaan status refill

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=refill_status" \
  --data-urlencode "refill=77"

Status Pending berarti menunggu peninjauan. Bila pesanan tidak layak, API mengembalikan error. Pembatalan tidak otomatis membatalkan pesanan atau memberikan refund. Maksimum 100 nomor tiap permintaan massal.

Contoh status banyak pesanan

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=status" \
  --data-urlencode "orders=12345,12346"

Contoh pengecekan saldo (POST)

curl -X POST "https://api.mrxpanel.com/api/v2" \
  --data-urlencode "key=API_KEY_ANDA" \
  --data-urlencode "action=balance"

Status massal hingga 100 nomor pesanan tersedia. Antrean permintaan refill/cancel tersedia, tetapi pengiriman otomatis ke provider belum diaktifkan; Super Admin dapat melakukan pengiriman manual dengan konfirmasi dan penguncian satu kali. Komentar custom dan polling belum tersedia. Flag refill/cancel pada katalog tetap nonaktif sampai alur eksekusi provider lulus pengujian.

Untuk pesanan, sistem tidak melakukan retry otomatis. Jika panel tidak mengirim request_id, MRXPANEL mencegah pesanan identik dari reseller yang sama dibuat lebih dari sekali dalam jendela 30 detik. Pengiriman ulang setelah 30 detik dapat membuat pesanan baru; gunakan request_id tetap untuk setiap pesanan jika panel mendukungnya. request_id yang dipakai lagi untuk pesanan berbeda akan ditolak. Gunakan parameter opsional request_id yang unik dan tetap untuk pesanan yang sama apabila software panel mendukungnya. Bila respons pesanan tidak jelas, periksa riwayat sebelum mengirim ulang.

UJI KONEKSI API · BACA SAJA

Uji Koneksi Website Reseller

Gunakan API Key milik akun Anda untuk memeriksa daftar layanan dan izin cek saldo. Pengujian ini tidak membuat pesanan, tidak mengirim refill/cancel, serta tidak mengubah saldo atau API Key.

Pengujian dijalankan dari browser Anda ke domain resmi api.mrxpanel.com hanya setelah tombol ditekan. Key tidak disimpan di localStorage, cookies, atau halaman hasil. Gunakan perangkat pribadi terpercaya, dan jangan pernah menaruh API Key di JavaScript publik website reseller. Dibutuhkan izin services:read dan balance:read.

Kelola API Key

Gunakan akun member MRXPANEL yang sama. API Key hanya boleh disimpan di server website Anda, bukan JavaScript publik.

API JSON V1 — Integrasi Kustom

Untuk pengembang yang membutuhkan format JSON MRXPANEL V1, gunakan HTTPS dan header Authorization: Bearer API_KEY_ANDA.

Butuh format SMM standar? Gunakan https://api.mrxpanel.com/api/v2 seperti dijelaskan di atas. Endpoint JSON V1 di bawah tetap tersedia untuk integrasi lanjutan.

Base URL

https://api.mrxpanel.com/v1/

Kegunaan	Metode	Endpoint
Daftar layanan dan harga	GET	`services`
Cek saldo IDR	GET	`balance`
Buat pesanan	POST	`orders`
Status pesanan	GET	`orders/status?id=UUID_PESANAN`

Kode service harus berasal dari katalog API, bukan ditebak dari ID publik. Harga, min, dan max mengikuti respons katalog.

Contoh Integrasi

1 · Ambil daftar layanan

curl "https://api.mrxpanel.com/v1/services" \
  -H "Authorization: Bearer API_KEY_ANDA"

2 · Cek saldo

curl "https://api.mrxpanel.com/v1/balance" \
  -H "Authorization: Bearer API_KEY_ANDA"

3 · Pesan layanan (menggunakan saldo)

curl -X POST \
  "https://api.mrxpanel.com/v1/orders" \
  -H "Authorization: Bearer API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reseller-order-001" \
  -d '{"service":"KODE_LAYANAN","target":"https://contoh.com/post","quantity":1000,"client_request_id":"reseller-order-001"}'

4 · Periksa pesanan

curl "https://api.mrxpanel.com/v1/orders/status?id=UUID_PESANAN" \
  -H "Authorization: Bearer API_KEY_ANDA"

Simpan client_request_id unik untuk setiap pesanan dan gunakan kembali untuk pengecekan/retry yang memang aman. Jangan mengirim pesanan baru ketika respons transaksi sebelumnya belum diketahui.

Bantuan Integrasi

Untuk panel SMM yang mendukung provider API standar, gunakan URL https://api.mrxpanel.com/api/v2 dan API Key dari akun Anda. Jika menu provider tidak mendukung IDR atau memiliki format khusus, hubungi support MRXPANEL. Jangan pernah mengirimkan API Key lengkap melalui chat.

Kembali ke Member