zakkistore-sdk 1.0.0 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  data.tar.gz: d4913d90836c0d62b6bba66b1550e504f517d69b1bb78e061cf1792a81c1d8ae
-  metadata.gz: 8d571e2886f5b7ac3d175c4cc97edcdf9abc319194dbb1d75a8dfb785b12a090
+  data.tar.gz: 470dfdb04248bbe20bb7e46838a678585d42ffa3bc547990cbc11d427abaa2aa
+  metadata.gz: 423c6f48ca67c166533a3a54502ff9b5e1de78a14a943ed371f7c8c67d1c3169
 SHA512:
-  data.tar.gz: 3fe7d945bd168df9d2cb0827216c4b51d8d6709748a84454592544feb5990d3c40d3e5137dbbb172a69933974714203cde3aa64dc2cf62f7f1a1139a1ab0fa42
-  metadata.gz: 7399e7cec6aa598167452c2bc632caddf206a5d93bd02d1982326b35fc6a65657c56e0b8c16b14a31094a174de48a60dca844f7120201c818471688a573ba83f
+  data.tar.gz: 36c811447e39d8e156b00efda1757941d9d35ab4ecd555f3416dee20fe36541932f827a992a7761692cb3bc46d5f83ba0303e05be25190663f967ccf59f1f222
+  metadata.gz: 4b40ee9debc561685e7fecc841ffa2c15f9af237c071638dcf8c25a1f3c623a1190839b6b420467e18e3ee439d27fa601816770af597af6cc37c5f6614871a2d

data/README.md

@@ -41,7 +41,7 @@ zakki = ZakkiStore.new(
 ## 🛠️ Fitur Unggulan
 
 ### 🔄 Auto-Withdraw Saldo VA
-Jika opsi `auto_withdraw: true` diaktifkan, SDK akan memicu penarikan dana VA bank otomatis secara *real-time* menjadi saldo utama aplikasi (BukaOlshop) ketika fungsi `checkbank()` dipanggil.
+Jika opsi `auto_withdraw: true` diaktifkan, SDK akan memicu penarikan dana VA bank otomatis secara *real-time* menjadi saldo utama aplikasi zakki store ketika fungsi `checkbank()` dipanggil.
 
 ### 💡 Dual-Flow Pascabayar & Bebas Nominal
 *   **Pascabayar (PLN/BPJS/PDAM):** Inquiry tagihan terlebih dahulu, lalu bayar dengan format tujuan `[ID_Pelanggan].[Nominal_Tagihan]` (Contoh: `122345678901.150000`).
@@ -49,48 +49,60 @@ Jika opsi `auto_withdraw: true` diaktifkan, SDK akan memicu penarikan dana VA ba
 
 ---
 
-## 📑 Daftar Referensi Metode Lengkap
-
-SDK Ruby ini mendukung secara penuh seluruh **25 fungsi resmi** dengan nama dan perilaku yang konsisten dengan SDK versi Node.js (NPM):
-
-### 1. Payment Gateway (QRIS Top Up)
-*   `zakki.topup(nominal)` — Membuat QRIS dinamis instan dengan nominal kode unik.
-*   `zakki.cektopup(idtopup)` — Cek status pembayaran QRIS.
-*   `zakki.cancel(id_transaksi, all_pending)` — Batalkan transaksi pending (Daftar pending, batal satu, atau batal massal).
-
-### 2. Transaksi H2H
-*   `zakki.listkode(jenis, product_type)` — Katalog kode produk aktif, deskripsi, dan harga.
-*   `zakki.h2h(kode, tujuan, refID)` — Mengirim order transaksi H2H (Mendukung hash argumen).
-*   `zakki.cekh2h(id_trx)` — Cek detail status pengisian, SN, dan harga beli order H2H.
-*   `zakki.myh2h()` — Mengambil 20 riwayat pembelian H2H terupdate.
-
-### 3. Perbankan & Transfer VA
-*   `zakki.checkbank()` — Cek saldo, VA member, mutasi, dan pemicu Auto-Withdraw.
-*   `zakki.checkname(number)` — Verifikasi nama asli pemilik VA Bank Zakki tujuan.
-*   `zakki.transfer(to, amount)` — Transfer saldo antar Virtual Account member Bank Zakki (Mendukung hash argumen).
-*   `zakki.tabung(jumlah)` — Menabung / deposit saldo dari aplikasi utama (BukaOlshop) ke Bank (butuh PIN).
-*   `zakki.tarik(jumlah)` — Menarik dana tabungan ke saldo aplikasi (butuh PIN).
-*   `zakki.checkmutasi(mutasi_type)` — Riwayat mutasi Tarik/Tabung (`tarik`, `tabung`, `all`).
-
-### 4. Noktel Marketplace (OTP Virtual)
-*   `zakki.noktelStok()` — Cek stok nomor virtual yang ready.
-*   `zakki.noktelBuy(category)` — Membeli nomor virtual baru untuk OTP.
-*   `zakki.noktelGetOtp(account_id)` — Menarik kode OTP Telegram secara real-time.
-*   `zakki.noktelCancel(invoice_id)` — Membatalkan nomor yang pending OTP & auto-refund.
-*   `zakki.noktelHistory()` — Mengambil daftar riwayat pembelian Noktel.
-
-### 5. Reward Komputasi & Game
-*   `zakki.cekmining()` — Cek status kesulitan global, block reward, dan miner aktif.
-*   `zakki.mymining()` — Riwayat koin mining SHA256 milik akun Anda.
-*   `zakki.cekgacha()` — Statistik poin, kemenangan, dan keuntungan gacha member.
-
-### 6. Keamanan & Utilitas
-*   `zakki.whitelistip(ip)` — Whitelist IP server Anda untuk otorisasi API H2H.
-*   `zakki.delwhitelistip(ip)` — Hapus IP server dari whitelist.
-*   `zakki.leaderboard(limit, period)` — Mengambil peringkat sultan topup teraktif.
-*   `zakki.status()` — Informasi beban CPU, metrik finansial, dan kesehatan sistem.
+## 📑 Daftar Referensi Metode Lengkap & Struktur Pengelompokan (36 Fungsi Resmi)
+
+Seluruh fungsi yang didukung oleh SDK ini dikelompokkan secara rapi ke dalam 7 kategori layanan utama demi mempermudah pemahaman dan integrasi:
+
+### 1. ⚡ Layanan Payment Gateway (QRIS Topup) — [4 Fungsi]
+*   **`zakki.topup(nominal)`** — Membuat tiket pembayaran QRIS dinamis instan dengan nominal kode unik.
+*   **`zakki.cektopup(idtopup)`** — Mengecek status pembayaran tiket QRIS tertentu secara real-time.
+*   **`zakki.mytopup()`** — Mengambil seluruh riwayat transaksi topup QRIS akun Anda.
+*   **`zakki.cancel(id_transaksi, all_pending)`** — Membatalkan satu atau seluruh tiket topup pending.
+
+### 2. 🏪 Layanan Transaksi Host-to-Host (H2H) — [4 Fungsi]
+*   **`zakki.listkode(jenis, product_type)`** — Mengambil katalog produk prabayar/pascabayar aktif beserta daftar harga beli.
+*   **`zakki.h2h(kode, tujuan, refID)`** — Mengirimkan order transaksi H2H (pulsa, paket data, PLN kustom, dll).
+*   **`zakki.cekh2h(id_trx)`** — Mengecek status transaksi, Serial Number (SN), dan harga beli riil dari order H2H.
+*   **`zakki.myh2h()`** — Mengambil 20 riwayat transaksi H2H terupdate milik akun Anda.
+
+### 3. 🏦 Layanan Perbankan & Transfer Saldo VA — [8 Fungsi]
+*   **`zakki.checkbank()`** — Memeriksa detail Virtual Account (VA), saldo bank VA, serta memicu Auto-Withdraw jika diaktifkan.
+*   **`zakki.checkname(number)`** — Memverifikasi nama asli pemilik rekening Virtual Account tujuan sebelum melakukan transfer.
+*   **`zakki.transfer(to, amount)`** — Mengirimkan saldo antar-VA member secara instan dan bebas biaya admin.
+*   **`zakki.tabung(jumlah)`** — Menyetorkan saldo aktif aplikasi ke rekening bank Virtual Account terhubung Anda.
+*   **`zakki.tarik(jumlah)`** — Menarik dana dari bank Virtual Account ke saldo aktif aplikasi Zakki Store Anda.
+*   **`zakki.checkmutasi(mutasi_type)`** — Melihat riwayat mutasi tabung/tarik saldo bank VA (`all`, `tarik`, `tabung`).
+*   **`zakki.checktransfer(idtransfer)`** — Mengecek status pengiriman dana transfer tertentu secara detail.
+*   **`zakki.mytransfer(type)`** — Mengambil riwayat pengiriman dan penerimaan transfer saldo (`all`, `kirim`, `terima`).
+
+### 4. 📱 Layanan Noktel Marketplace (OTP Virtual) — [5 Fungsi]
+*   **`zakki.noktelStok()`** — Memeriksa ketersediaan stok nomor virtual aktif per kategori layanan/aplikasi.
+*   **`zakki.noktelBuy(category)`** — Membeli nomor virtual baru untuk penerimaan kode verifikasi/OTP.
+*   **`zakki.noktelGetOtp(account_id)`** — Mengambil kode verifikasi/OTP yang masuk ke nomor virtual secara real-time.
+*   **`zakki.noktelCancel(invoice_id)`** — Membatalkan order nomor virtual yang pending OTP dan memicu auto-refund saldo.
+*   **`zakki.noktelHistory()`** — Mengambil daftar riwayat lengkap pemesanan nomor virtual.
+
+### 5. ⛏️ Layanan Reward Komputasi SHA-256 (Mining) & Game — [5 Fungsi]
+*   **`zakki.miningStart()`** — Meminta challenge penambangan SHA-256 serta target kesulitan (difficulty) dari server.
+*   **`zakki.miningSubmit(nonce, signature)`** — Mengirimkan hasil kerja hashing SHA-256 (Proof-of-Work) untuk mendapatkan koin.
+*   **`zakki.cekmining(idmining)`** — Mengecek status audit dan persetujuan dari blok mining yang telah Anda selesaikan.
+*   **`zakki.mymining()`** — Melihat riwayat penambangan koin dan total reward hashing akun Anda.
+*   **`zakki.cekgacha()`** — Mengecek jumlah tiket gacha, riwayat kemenangan, dan detail koin keberuntungan Anda.
+
+### 6. 🔒 Layanan Keamanan IP & Utilitas — [6 Fungsi]
+*   **`zakki.whitelistip(ip)`** — Mendaftarkan IP server/host Anda agar diizinkan melakukan transaksi H2H via API (Maksimal 3 IP).
+*   **`zakki.delwhitelistip(ip)`** — Menghapus alamat IP terdaftar dari whitelist API.
+*   **`zakki.cekmyip()`** — Mendeteksi alamat IP publik host/server Anda saat ini yang terbaca oleh sistem.
+*   **`zakki.cekip(ip)`** — Mengecek detail status IP whitelisting tertentu.
+*   **`zakki.leaderboard(limit, period)`** — Melihat daftar Sultan topup teraktif secara global.
+*   **`zakki.status()`** — Memeriksa beban CPU server, statistik finansial global, dan kesehatan sistem.
+
+### 7. 🔗 Layanan Webhook Callback & Notifikasi Bot — [4 Fungsi]
+*   **`zakki.setcallback(site)`** — Memasang URL callback real-time untuk menerima laporan status transaksi H2H.
+*   **`zakki.delcallback()`** — Menghapus URL callback yang terpasang di sistem.
+*   **`zakki.setnotifbot(telegramId)`** — Memasang ID Telegram Anda untuk menerima notifikasi otomatis transaksi sukses/gagal.
+*   **`zakki.delnotifbot()`** — Menonaktifkan bot notifikasi Telegram.
 
----
 
 ## 🛡️ Protokol Keamanan API
 

data/lib/zakkistore-sdk.rb

@@ -216,18 +216,45 @@ class ZakkiStore
   # --- 5. REWARD KOMPUTASI & UTILITY ---
   # ==========================================================
 
-  def cekmining
-    _request('/cekmining', 'GET', { "token" => @token })
+  def cekmining(idmining)
+    raise ArgumentError, "Parameter idmining wajib diisi." if idmining.nil? || idmining.empty?
+    _request('/cekmining', 'GET', { "idmining" => idmining.to_s.strip })
   end
 
   def mymining
     _request('/mymining', 'GET', { "token" => @token })
   end
 
+  def mining_start
+    _request('/mining/start', 'GET', { "token" => @token })
+  end
+
+  def miningStart
+    mining_start
+  end
+
+  def mining_submit(nonce, signature)
+    raise ArgumentError, "Parameter nonce wajib disertakan." if nonce.nil?
+    raise ArgumentError, "Parameter signature wajib disertakan." if signature.nil? || signature.empty?
+    _request('/mining/submit', 'POST', {
+      "token" => @token,
+      "nonce" => nonce,
+      "signature" => signature
+    })
+  end
+
+  def miningSubmit(nonce, signature)
+    mining_submit(nonce, signature)
+  end
+
   def cekgacha
     _request('/cekgacha', 'GET', { "token" => @token })
   end
 
+  # ==========================================================
+  # --- 6. UTILITY & SECURITY ---
+  # ==========================================================
+
   def whitelistip(ip)
     _request('/whitelistip', 'POST', {
       "token" => @token,
@@ -253,6 +280,91 @@ class ZakkiStore
     _request('/status', 'GET')
   end
 
+  # ==========================================================
+  # --- 7. METODE INTEGRASI BARU ---
+  # ==========================================================
+
+  def set_callback(site)
+    _request('/setcallback', 'GET', {
+      "token" => @token,
+      "site" => site.to_s.strip
+    })
+  end
+
+  def setcallback(site)
+    set_callback(site)
+  end
+
+  def del_callback
+    _request('/delcallback', 'GET', { "token" => @token })
+  end
+
+  def delcallback
+    del_callback
+  end
+
+  def set_notif_bot(telegram_id)
+    _request('/setnotifbot', 'GET', {
+      "token" => @token,
+      "id" => telegram_id.to_s.strip
+    })
+  end
+
+  def setnotifbot(telegram_id)
+    set_notif_bot(telegram_id)
+  end
+
+  def del_notif_bot
+    _request('/delnotifbot', 'GET', { "token" => @token })
+  end
+
+  def delnotifbot
+    del_notif_bot
+  end
+
+  def check_transfer(idtransfer)
+    _request('/checktransfer', 'GET', { "idtransfer" => idtransfer.to_s.strip })
+  end
+
+  def checktransfer(idtransfer)
+    check_transfer(idtransfer)
+  end
+
+  def my_transfer(transfer_type = "all")
+    _request('/mytransfer', 'GET', {
+      "token" => @token,
+      "type" => transfer_type.to_s.strip
+    })
+  end
+
+  def mytransfer(transfer_type = "all")
+    my_transfer(transfer_type)
+  end
+
+  def my_topup
+    _request('/mytopup', 'GET', { "token" => @token })
+  end
+
+  def mytopup
+    my_topup
+  end
+
+  def cek_my_ip
+    _request('/cekmyip', 'GET')
+  end
+
+  def cekmyip
+    cek_my_ip
+  end
+
+  def cek_ip(ip)
+    _request('/cekip', 'GET', { "ip" => ip.to_s.strip })
+  end
+
+  def cekip(ip)
+    cek_ip(ip)
+  end
+
   private
 
   def _request(endpoint, method = 'GET', data = nil)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zakkistore-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.4
 platform: ruby
 authors:
 - ZakkiXD
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-06-02 00:00:00.000000000 Z
 dependencies: []
 description: Mempermudah integrasi layanan gerbang pembayaran (Payment Gateway) QRIS dan H2H Zakki Store.
 email: