PANDUAN PENGEMBANG REST API
Pengenalan & Autentikasi
Selamat datang di dokumentasi resmi OpiPay API. Pelajari cara menghubungkan aplikasi web, kasir (POS), dan bot toko Anda secara otomatis.
Autentikasi Header API Key
Semua request API memerlukan header otentikasi X-API-KEY.
Setiap permintaan ke API OpiPay wajib menyertakan Kunci Rahasia (*Secret API Key*) pada HTTP Request Header X-API-KEY.
X-API-KEY: QP-Key-YOUR_SECRET_KEYWajib
Sertakan header ini pada permintaan POST /api/qris/create dan POST /api/qris/status.
Sistem Kode Unik Nomimal Transaksi
Pencegahan kolisi antrian pembayaran secara cerdas.
Untuk mengidentifikasi pembayaran yang masuk di mutasi bank secara otomatis, OpiPay menggenerasi kode unik acak yang ditambahkan pada nominal dasar (base_amount + unique_code = total_amount):
Nominal <= Rp 50.000
Kode Unik 2 Digit (0 - 99)
Contoh: Rp 25.000 + 43 = Rp 25.043
Nominal > Rp 50.000
Kode Unik 3 Digit (100 - 999)
Contoh: Rp 150.000 + 705 = Rp 150.705