QRIS-OrderKuota

API Mutasi QRIS + Telegram Bot untuk OrderKuota. Proyek ini meniru request aplikasi Android (signature + fingerprint) agar bisa mengambil mutasi QRIS dari OrderKuota dan menyajikannya lewat endpoint HTTP serta bot Telegram.

Fitur

Modul	Fitur Utama	Detail
mutasi.php	Proxy API Mutasi	HMAC-SHA256 signature, device fingerprint deterministik, parsing error, rate limit handling
bot.php	Telegram Bot	Login, OTP, cek saldo, mutasi, session management
Security	Validasi & proteksi	Validasi input JSON, error handling, logging terkontrol

Struktur Proyek

Path	Deskripsi
mutasi.php	Endpoint API untuk ambil mutasi QRIS dari OrderKuota
generate-token/bot.php	Telegram bot webhook handler
.env	Konfigurasi bot (token & webhook URL)
docs/banner.svg	Banner dokumentasi

Kebutuhan

• PHP 7.4+ (disarankan 8.1+)
• Ekstensi PHP: curl, json, mbstring
• Nginx/Apache (untuk HTTPS webhook Telegram)

Konfigurasi Environment

Buat file .env di root project:

TELEGRAM_BOT_TOKEN=ISI_TOKEN_BOT
WEBHOOK_URL=https://subdomain.domain.com/generate-token/bot.php
OWNER_CHAT_ID=123456789
PROXY_URL=http://User-001:Pass-001@127.0.0.1:3128

Endpoint

Endpoint	Method	Deskripsi
/mutasi.php	POST	Ambil data mutasi QRIS
/generate-token/bot.php	POST	Webhook Telegram

Request Example (Mutasi)

curl -s -X POST https://subdomain.domain.com/mutasi.php \
  -H "Content-Type: application/json" \
  -d '{"auth_token":"USERID:TOKEN","auth_username":"USERNAME"}'

Perintah Bot

Command	Fungsi
/start	Bantuan & petunjuk penggunaan
/login	Login ke OrderKuota
/otp	Verifikasi OTP
/saldo	Cek saldo QRIS
/mutasi	Lihat mutasi QRIS
/logout	Hapus session

Deploy Singkat (VPS / CyberPanel)

1. Upload file ke document root subdomain.
2. Pastikan .env tersedia dan berisi token bot + webhook URL.
3. Set webhook Telegram:

curl -s "https://api.telegram.org/botTELEGRAM_BOT_TOKEN/setWebhook?url=https://subdomain.domain.com/generate-token/bot.php"

Catatan Keamanan

• Disarankan mengaktifkan verifikasi SSL di mutasi.php:
  • CURLOPT_SSL_VERIFYPEER => true
  • CURLOPT_SSL_VERIFYHOST => 2
• Jangan commit file .env ke GitHub.
• Batasi akses endpoint jika memungkinkan (API key / IP whitelist).

Disclaimer

Gunakan proyek ini sesuai kebijakan dan ketentuan layanan OrderKuota. Pengembang tidak bertanggung jawab atas penyalahgunaan.

Donasi

Kalau bermanfaat, kamu bisa support lewat BuyMeACoffee: https://buymeacoffee.com/aliahmadnawawi