Request Config
Dokumentasi & Panduan
Panduan lengkap integrasi API. Gunakan Method POST dan format Body JSON. Pastikan Anda memiliki akun OrderKuota yang aktif sebelum memulai.
MODULE 01 Authentication
1. Request OTP (Login)
Langkah pertama. Gunakan endpoint ini untuk memicu pengiriman kode OTP ke Email terdaftar.
POST /api/auth/login
Parameters
- username Username terdaftar.
- password Kata sandi akun OrderKuota.
Response Example
{
"status": true,
"message": "Success",
"data": {
"success": true,
"results": {
"otp": "email",
"otp_value": "user************mail.com"
}
}
}
2. Verify OTP (Get Token)
Tukar kode OTP yang diterima di Email menjadi Auth Token. Token ini wajib disimpan untuk akses API lainnya.
POST /api/auth/verify
Parameters
- username username yang sama.
- otp Kode 6 digit dari Email.
Response Example
{
"status": true,
"message": "Success",
"data": {
"success": true,
"results": {
"otp": "",
"id": "123456",
"name": "demouser",
"username": "demouser",
"balance": "500000",
"token": "123456:aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890"
}
}
}
MODULE 02 QRIS Payment
3. Cek Mutasi QRIS
Mengambil 4 transaksi QRIS terakhir yang masuk (Status: IN). Berguna untuk verifikasi pembayaran otomatis.
POST /api/qris/mutasi
Parameters
- auth_username Username Login.
- auth_token Token dari hasil Verify OTP.
Response Example
{
"status": true,
"data": {
"qris_history": {
"total": 50,
"page": 1,
"results": [
{
"id": 123456789,
"kredit": "10.000",
"saldo_akhir": "100.000",
"keterangan": "NOBU / JOHN DOE",
"tanggal": "24/01/2026 18:23",
"status": "IN",
"brand": { "name": "GoPay" }
}
]
},
"account": {
"username": "demouser",
"balance": 500000,
"qris_balance": 100000,
"qris_name": "TOKO DEMO"
}
}
}
4. Cek Mutasi Detail
Mengambil semua transaksi dengan filter lengkap: tanggal, keterangan, jumlah, dan pagination.
POST /api/qris/mutasi-detail
Parameters
- auth_username Username Login.
- auth_token Token dari hasil Verify OTP.
- page Halaman (default: 1).
- start_date Filter dari tanggal (YYYY-MM-DD).
- end_date Filter sampai tanggal (YYYY-MM-DD).
- keterangan Filter source (GOPAY, OVO, DANA).
- jumlah Filter nominal.
Response Example
{
"status": true,
"data": {
"success": true,
"total": 20,
"all_in": [...],
"all_out": [...],
"results": [...],
"pagination": {
"current_page": "1",
"has_more": true
}
}
}
5. Cek Saldo
Melihat saldo utama dan saldo QRIS dari akun OrderKuota.
POST /api/qris/balance
Parameters
- auth_username Username Login.
- auth_token Token dari hasil Verify OTP.
Response Example
{
"status": true,
"data": {
"success": true,
"balance": 500000,
"qris_balance": 100000,
"name": "Nama Toko",
"username": "demouser"
}
}
7. Decode QRIS dari Foto
Upload foto QRIS untuk mendapatkan raw string-nya. Berguna untuk convert static QRIS fisik ke digital.
POST /api/qris/decode
Parameters
- image File gambar QRIS (JPG/PNG, max 5MB). Gunakan multipart/form-data.
Response Example
{
"status": true,
"message": "Success",
"data": {
"qris_string": "00020101021126...",
"filename": "qris.jpg",
"size": 245678
}
}
8. Generate Dynamic QRIS
Membuat kode QRIS baru dengan nominal yang sudah tertanam (Static to Dynamic). Output berupa base64 image.
POST /api/qris/decode
Parameters
- base_string String text dari QRIS Toko Asli Anda (bisa didapat dari scan QRIS toko pakai aplikasi scanner).
- amount Nominal Rupiah (Int).
Response Example
{
"status": true,
"message": "Success",
"data": {
"original_string": "00020101021126...",
"amount": 50000,
"dynamic_string": "00020101021226...",
"qr_image": "data:image/png;base64,iVBORw0KG..."
}
}