API Produk Digital
Integrasikan toko Anda dengan RYYSENGTOR dan jual produk digital โ lisensi software, akun premium, kode voucher, link download โ langsung ke pelanggan Anda secara otomatis.
Quickstart
Tiga langkah untuk mulai berjualan produk digital via API.
1. Dapatkan API Key
Masuk ke akun reseller Anda โ salin API ID & API Key dari halaman Dashboard.
2. Isi Saldo
Top up saldo reseller. Setiap order akan memotong saldo secara otomatis.
3. Mulai Order
Ambil daftar produk via API, buat order, dan produk langsung diterima.
Base URL
https://ryysengtor.shop/Content-Type: application/x-www-form-urlencoded, kecuali Cashify QRIS yang menggunakan Content-Type: application/json.
Autentikasi
Setiap request wajib menyertakan tiga parameter berikut.
| Parameter | Status | Keterangan |
|---|---|---|
| api_id | Wajib | API ID akun reseller Anda |
| api_key | Wajib | API Key akun reseller Anda |
| signature | Wajib | Hash MD5 dari api_id + api_key (disambung langsung, tanpa spasi) |
Generate signature:
Profile
Mendapatkan profil akun reseller dan saldo saat ini.
โ Respons Sukses
โ Respons Gagal
Service โ Daftar Produk Digital
Mendapatkan seluruh produk digital yang tersedia. Respons diurutkan berdasarkan kategori lalu nama produk.
โ Respons Sukses (array)
Keterangan Field
| Field | Keterangan |
|---|---|
| id | Service ID โ gunakan saat buat order |
| kategori | Kategori produk (Software, Akun, dll) |
| nama | Nama produk |
| harga | Harga dalam Rupiah (sama untuk semua tier) |
| tipe_akses | teks Kode/Lisensi ยท link URL Download ยท drive Google Drive ยท file File ZIP |
| status | aktif = siap dipesan |
Filter berdasarkan kategori:
Order โ Buat Pesanan
Buat pesanan produk digital. Saldo dipotong otomatis dan akses_data (lisensi / link) langsung dikembalikan dalam respons.
| Parameter | Status | Keterangan |
|---|---|---|
| api_id | Wajib | API ID Anda |
| api_key | Wajib | API Key Anda |
| signature | Wajib | md5(api_id + api_key) |
| order_id | Wajib | ID unik dari sistem Anda โ tidak boleh duplikat |
| service_id | Wajib | ID produk dari endpoint /api/service |
akses_data (kode lisensi / link download) sudah ada di dalam respons โ teruskan ke pelanggan Anda seketika.
โ Respons Sukses
โ Respons Gagal
Nilai tipe_akses
| Nilai | Artinya |
|---|---|
| teks | Kode lisensi / serial number โ tampilkan langsung ke pelanggan |
| link | URL download external โ arahkan pelanggan ke URL |
| drive | Link Google Drive โ sama seperti link |
| file | Nama file ZIP di server โ unduh & teruskan ke pelanggan |
Status Pesanan
Cek detail dan status pesanan berdasarkan order_id. Untuk produk digital, status selalu Sukses dan akses_data juga dikembalikan di sini.
| Parameter | Status | Keterangan |
|---|---|---|
| api_id | Wajib | API ID Anda |
| api_key | Wajib | API Key Anda |
| signature | Wajib | md5(api_id + api_key) |
| order_id | Wajib | ID pesanan yang ingin dicek |
โ Respons Sukses
โ Tidak Ditemukan
Payment Gateway โ Cashify QRIS
Integrasikan pembayaran QRIS ke toko Anda agar pelanggan bisa membayar secara otomatis sebelum produk dikirim.
akses_data dikirim ke pelanggan. Semua otomatis.
1. Buat Transaksi QRIS
Header:
Request Body:
Respons:
transactionId untuk polling status. totalAmount = nominal final yang harus dibayar pelanggan (bisa berbeda karena unique code).Render QR ke pelanggan:
2. Polling Status Pembayaran
Header + Body:
| Status Respons | Arti | Tindakan |
|---|---|---|
| pending | Belum dibayar | Lanjut polling (setiap 3 detik) |
| paid / success | Lunas | Panggil /api/order sekarang |
| expired | Kadaluarsa (30 menit) | Buat transaksi QRIS baru |
| failed | Gagal | Beritahu pelanggan, coba lagi |
3. Cara Mendapatkan Kredensial Cashify
- 1Daftar / masuk di cashify.my.id
- 2Buat QR baru โ salin QR ID (field
id) - 3Menu Pengaturan / API โ salin License Key (header
x-license-key) - 4Salin Package ID (default:
com.orderkuota.app)
Alur Integrasi Lengkap
Dari pelanggan klik beli sampai produk diterima โ semuanya otomatis.
Tampilkan Daftar Produk
Panggil POST /api/service โ tampilkan produk beserta harga di toko Anda. Cache respons ini (update setiap 1 jam cukup).
Pelanggan Pilih Produk & Checkout
Simpan service_id yang dipilih dan buat order_id unik di sistem Anda.
Buat Transaksi QRIS untuk Pelanggan
Panggil Cashify POST generate/qris dengan nominal harga produk. Tampilkan gambar QR + nominal + countdown 30 menit ke pelanggan.
Polling Status Pembayaran
Setiap 3 detik panggil Cashify POST check-status. Terus lakukan sampai status = paid atau expired.
Pembayaran Lunas โ Buat Order
Panggil POST /api/order dengan order_id dan service_id. Respons langsung berisi akses_data.
Kirim Produk ke Pelanggan
Ambil akses_data dari respons order dan tampilkan / kirim ke pelanggan via email/WhatsApp. Selesai!
Diagram Alur:
Contoh Kode
Salin dan sesuaikan dengan sistem Anda.
PHP โ Alur Lengkap (buat QRIS โ cek bayar โ order โ kirim produk)
Kode Error
Semua pesan error yang mungkin muncul dan cara mengatasinya.
| Pesan Error | Penyebab | Solusi |
|---|---|---|
| API ID atau API KEY tidak ditemukan | Kredensial kosong | Cek api_id & api_key di dashboard |
| Pengguna...tidak ditemukan | api_id/api_key salah | Salin ulang API ID & Key dari dashboard |
| Signature Tidak Valid | Formula md5 keliru | Pastikan md5(api_id . api_key) tanpa pemisah |
| Saldo anda tidak mencukupi | Balance < harga produk | Top up saldo reseller |
| order_id sudah tersedia | Duplikat order_id | Gunakan order_id baru & unik per transaksi |
| service_id tidak ditemukan atau produk tidak aktif | ID salah / produk dinonaktifkan | Refresh daftar dari /api/service |
| IP tidak ada dalam whitelist | IP server tidak diizinkan | Tambah IP server di pengaturan akun |
| Cashify: expired | QR kadaluarsa 30 menit | Buat transaksi Cashify baru |