zakkistore-sdk 1.0.1 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  data.tar.gz: e69cf6aec6b0fe0d8534b9e48e7860b10e6cb80605ff4cbc0e5da1f7b6a27a8c
-  metadata.gz: 071755f8feb2fd496baa625abb5f5bdeb54cd223960a87c6a5d28a08b560f641
+  metadata.gz: 709a243e825cb66c17e979ea0f2131f4aecf2d1e3be7b8f52e693ab9f3c10a89
+  data.tar.gz: 59b37c51e5f059085af21320d1f752eca8e8cde7478ff5a5addc30c87b2fc7ee
 SHA512:
-  data.tar.gz: 5322c4a9e8845b8c799a2dc6bf8a40645af69cef1bcc8e060b08a1caf9bd7d740071bdfb27487ae8762d4aaab3c570eef38cf0af9aca9eee7e169e90207ba3f9
-  metadata.gz: f6bdbeda4f33bf66e6ff36161dee0dcacbef62c1553575b39e0fbf60fea285adb3597409835e5fac5872f566bcfa23785ad82fbe4b782e8a742689280348e560
+  metadata.gz: 534fc99b3d3c697103940174451c984d1de0fd1c40a94191c35ce6fff16c13d071ab901252d9016503e11e0b05a327f8590f443b8264d8e36277db63d7831147
+  data.tar.gz: 5dcd139fa48eb64c69f5234c0aefee004b0db6acdf78539a121a147a30a1aed7e233bd54e3751c44029ef326ba407e592b482c3cd30bc637fcdf33e790b97ecb

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,61 @@ 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 (37 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) — [5 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.cektopup2(idtopup)`** — Mendapatkan URL gambar struk digital dinamis (hologram receipt) berformat PNG.
+*   **`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

@@ -48,6 +48,10 @@ class ZakkiStore
     })
   end
 
+  def cektopup2(idtopup)
+    "#{@base_url}/cektopup2?idtopup=#{URI.encode_www_form_component(idtopup)}"
+  end
+
   def cancel(id_transaksi = nil, all_pending = false)
     if id_transaksi.is_a?(TrueClass) || id_transaksi.is_a?(FalseClass)
       all_pending = id_transaksi
@@ -216,18 +220,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 +284,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,18 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: zakkistore-sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.5
 platform: ruby
 authors:
 - ZakkiXD
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-01 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies: []
-description: Mempermudah integrasi layanan gerbang pembayaran (Payment Gateway) QRIS dan H2H Zakki Store.
-email:
-- b2b_partner@example.com
+description: Mempermudah integrasi layanan gerbang pembayaran (Payment Gateway) QRIS
+  dan H2H Zakki Store.
+email: b2b_partner@example.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -22,10 +22,8 @@ files:
 homepage: https://github.com/MrLow12/zakkistore-sdk-ruby
 licenses:
 - MIT
-metadata:
-  homepage_uri: https://github.com/MrLow12/zakkistore-sdk-ruby
-  source_code_uri: https://github.com/MrLow12/zakkistore-sdk-ruby
-post_install_message: 
+metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -40,8 +38,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
-signing_key: 
+rubygems_version: 3.4.20
+signing_key:
 specification_version: 4
 summary: Official Ruby SDK Client Library for Zakki Store B2B API Gateway
 test_files: []