zakkistore-sdk 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  data.tar.gz: d4913d90836c0d62b6bba66b1550e504f517d69b1bb78e061cf1792a81c1d8ae
+  metadata.gz: 8d571e2886f5b7ac3d175c4cc97edcdf9abc319194dbb1d75a8dfb785b12a090
+SHA512:
+  data.tar.gz: 3fe7d945bd168df9d2cb0827216c4b51d8d6709748a84454592544feb5990d3c40d3e5137dbbb172a69933974714203cde3aa64dc2cf62f7f1a1139a1ab0fa42
+  metadata.gz: 7399e7cec6aa598167452c2bc632caddf206a5d93bd02d1982326b35fc6a65657c56e0b8c16b14a31094a174de48a60dca844f7120201c818471688a573ba83f

data/README.md

@@ -0,0 +1,99 @@
+# 💎 Zakkistore SDK for Ruby
+
+**Official B2B Client Library for Zakki Store API Gateway**
+
+Pustaka Ruby resmi untuk memudahkan integrasi layanan Host-to-Host (H2H) prabayar/pascabayar, payment gateway QRIS otomatis, perbankan Virtual Account (VA), Noktel OTP virtual, mining reward, dan gacha koin Zakki Store ke dalam proyek Ruby Anda (Rails, Sinatra, Hanami, bot Telegram/Discord, dll).
+
+---
+
+## 🚀 Instalasi & Inisialisasi
+
+Tambahkan pustaka ini ke dalam `Gemfile` Anda:
+
+```ruby
+gem 'zakkistore-sdk'
+```
+
+Atau instal secara manual via RubyGems:
+
+```bash
+gem install zakkistore-sdk
+```
+
+### Inisialisasi Klien
+
+```ruby
+require 'zakkistore-sdk'
+
+# Inisialisasi klien SDK
+zakki = ZakkiStore.new(
+  "https://qris.zakki.store", # URL API Server
+  "API_TOKEN_ANDA",          # Token API
+  "IBO99",                   # iduser
+  "member@gmail.com",        # email
+  "123456",                  # PIN transaksi (Wajib untuk tabung & tarik)
+  true                       # Aktifkan penarikan saldo VA otomatis ke aplikasi!
+)
+```
+
+---
+
+## 🛠️ 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.
+
+### 💡 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`).
+*   **E-Wallet Bebas Nominal:** Kirim transfer E-Wallet nominal kustom dengan format tujuan `[No_HP].[Nominal]` (Contoh: `08123456789.25000`).
+
+---
+
+## 📑 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.
+
+---
+
+## 🛡️ Protokol Keamanan API
+
+> [!WARNING]
+> **Selalu jalankan SDK ini di sisi backend (Server-side)!**
+> Jangan pernah mengekspos API Token dan PIN Anda langsung di frontend aplikasi / browser klien publik demi mencegah potensi pencurian saldo.

data/lib/zakkistore-sdk.rb

@@ -0,0 +1,293 @@
+require 'net/http'
+require 'json'
+require 'uri'
+
+class ZakkiStore
+  attr_accessor :base_url, :token, :iduser, :email, :pin, :auto_withdraw
+
+  def initialize(base_url = "https://qris.zakki.store", token = nil, iduser = nil, email = nil, pin = nil, auto_withdraw = false)
+    # Smart detection if token is placed in base_url parameter
+    if base_url && !base_url.start_with?("http://") && !base_url.start_with?("https://") && token.nil?
+      token = base_url
+      base_url = "https://qris.zakki.store"
+    end
+
+    raise ArgumentError, "token wajib disertakan dalam konfigurasi SDK." if token.nil? || token.empty?
+    raise ArgumentError, "base_url wajib disertakan dalam konfigurasi SDK." if base_url.nil? || base_url.empty?
+
+    @base_url = base_url.chomp('/')
+    @token = token
+    @iduser = iduser
+    @email = email
+    @pin = pin
+    @auto_withdraw = !!auto_withdraw
+  end
+
+  def enable_auto_withdraw(status)
+    @auto_withdraw = !!status
+  end
+
+  def enableAutoWithdraw(status)
+    enable_auto_withdraw(status)
+  end
+
+  # ==========================================================
+  # --- 1. PAYMENT GATEWAY (QRIS TOPUP) ---
+  # ==========================================================
+
+  def topup(nominal)
+    _request('/topup', 'POST', {
+      "token" => @token,
+      "nominal" => nominal.to_i
+    })
+  end
+
+  def cektopup(idtopup)
+    _request('/cektopup', 'GET', {
+      "idtopup" => 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
+      id_transaksi = nil
+    end
+
+    payload = { "token" => @token }
+    payload["id_transaksi"] = id_transaksi if id_transaksi
+    payload["all"] = true if all_pending
+    _request('/cancel', 'POST', payload)
+  end
+
+  # ==========================================================
+  # --- 2. TRANSAKSI H2H (HOST-TO-HOST) ---
+  # ==========================================================
+
+  def listkode(jenis = nil, product_type = nil)
+    payload = {}
+    payload["jenis"] = jenis if jenis
+    payload["type"] = product_type if product_type
+    _request('/listkode', 'GET', payload)
+  end
+
+  def h2h(kode, tujuan = nil, ref_id = nil)
+    if kode.is_a?(Hash)
+      payload = kode
+      kode = payload[:kode] || payload["kode"]
+      tujuan = payload[:tujuan] || payload["tujuan"]
+      ref_id = payload[:refID] || payload["refID"] || payload[:ref_id] || payload["ref_id"]
+    end
+
+    _request('/h2h', 'POST', {
+      "token" => @token,
+      "kode" => kode,
+      "tujuan" => tujuan,
+      "refID" => ref_id
+    })
+  end
+
+  def cekh2h(id_trx)
+    _request('/cekh2h', 'GET', { "id" => id_trx })
+  end
+
+  def myh2h
+    _request('/myh2h', 'GET', { "token" => @token })
+  end
+
+  # ==========================================================
+  # --- 3. PERBANKAN & TRANSFER SALDO ---
+  # ==========================================================
+
+  def checkbank
+    payload = { "token" => @token }
+    payload["iduser"] = @iduser if @iduser
+    payload["email"] = @email if @email
+
+    bank_res = _request('/checkbank', 'GET', payload)
+
+    if @auto_withdraw && bank_res["data"] && bank_res["data"]["bank_detail"]
+      bank_detail = bank_res["data"]["bank_detail"]
+      balance = (bank_detail["balance"] || 0).to_f
+
+      if balance > 0
+        begin
+          withdraw_res = tarik(balance.to_i)
+          bank_res = _request('/checkbank', 'GET', payload)
+          bank_res["auto_withdraw_executed"] = true
+          bank_res["auto_withdraw_amount"] = balance.to_i
+          bank_res["auto_withdraw_message"] = withdraw_res["message"] || "Auto-withdraw berhasil dijalankan."
+        rescue => err
+          bank_res["auto_withdraw_executed"] = false
+          bank_res["auto_withdraw_error"] = err.message
+        end
+      end
+    end
+
+    bank_res
+  end
+
+  def checkname(number)
+    _request('/checkname', 'GET', { "number" => number.to_s.strip })
+  end
+
+  def transfer(to, amount = nil)
+    if to.is_a?(Hash)
+      payload = to
+      to = payload[:to] || payload["to"]
+      amount = payload[:amount] || payload["amount"]
+    end
+
+    _request('/transfer', 'POST', {
+      "token" => @token,
+      "to" => to,
+      "amount" => amount.to_i
+    })
+  end
+
+  def tabung(jumlah)
+    raise RuntimeError, "[ZakkiStore SDK Error] PIN transaksi diperlukan untuk melakukan transaksi tabung." unless @pin
+    payload = {
+      "token" => @token,
+      "jumlah" => jumlah.to_i,
+      "pin" => @pin
+    }
+    payload["iduser"] = @iduser if @iduser
+    payload["email"] = @email if @email
+    _request('/tabung', 'POST', payload)
+  end
+
+  def tarik(jumlah)
+    raise RuntimeError, "[ZakkiStore SDK Error] PIN transaksi diperlukan untuk melakukan transaksi tarik." unless @pin
+    payload = {
+      "token" => @token,
+      "jumlah" => jumlah.to_i,
+      "pin" => @pin
+    }
+    payload["iduser"] = @iduser if @iduser
+    payload["email"] = @email if @email
+    _request('/tarik', 'POST', payload)
+  end
+
+  def checkmutasi(mutasi_type = "all")
+    payload = {
+      "token" => @token,
+      "type" => mutasi_type
+    }
+    payload["iduser"] = @iduser if @iduser
+    payload["email"] = @email if @email
+    _request('/checkmutasi', 'GET', payload)
+  end
+
+  # ==========================================================
+  # --- 4. NOKTEL MARKETPLACE (OTP VIRTUAL) ---
+  # ==========================================================
+
+  def noktelStok
+    _request('/noktel/stok', 'GET', { "token" => @token })
+  end
+
+  def noktelBuy(category)
+    _request('/noktel/buy', 'POST', {
+      "token" => @token,
+      "category" => category.to_s.strip
+    })
+  end
+
+  def noktelGetOtp(account_id)
+    _request('/noktel/getotp', 'GET', {
+      "token" => @token,
+      "account_id" => account_id.to_s.strip
+    })
+  end
+
+  def noktelCancel(invoice_id)
+    _request('/noktel/cancel', 'POST', {
+      "token" => @token,
+      "invoice_id" => invoice_id.to_s.strip
+    })
+  end
+
+  def noktelHistory
+    _request('/noktel/history', 'GET', { "token" => @token })
+  end
+
+  # ==========================================================
+  # --- 5. REWARD KOMPUTASI & UTILITY ---
+  # ==========================================================
+
+  def cekmining
+    _request('/cekmining', 'GET', { "token" => @token })
+  end
+
+  def mymining
+    _request('/mymining', 'GET', { "token" => @token })
+  end
+
+  def cekgacha
+    _request('/cekgacha', 'GET', { "token" => @token })
+  end
+
+  def whitelistip(ip)
+    _request('/whitelistip', 'POST', {
+      "token" => @token,
+      "ip" => ip.to_s.strip
+    })
+  end
+
+  def delwhitelistip(ip)
+    _request('/delwhitelistip', 'POST', {
+      "token" => @token,
+      "ip" => ip.to_s.strip
+    })
+  end
+
+  def leaderboard(limit = 10, period = "all")
+    _request('/leaderboard', 'GET', {
+      "limit" => limit.to_i,
+      "period" => period.to_s.strip
+    })
+  end
+
+  def status
+    _request('/status', 'GET')
+  end
+
+  private
+
+  def _request(endpoint, method = 'GET', data = nil)
+    uri = URI.parse("#{@base_url}#{endpoint}")
+    
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = true if uri.scheme == 'https'
+
+    headers = { 'Content-Type' => 'application/json' }
+
+    if method.upcase == 'GET'
+      if data && !data.empty?
+        uri.query = URI.encode_www_form(data)
+      end
+      request = Net::HTTP::Get.new(uri.request_uri, headers)
+    else
+      request = Net::HTTP::Post.new(uri.request_uri, headers)
+      request.body = data.to_json if data
+    end
+
+    begin
+      response = http.request(request)
+      res_json = JSON.parse(response.body) rescue { "message" => response.body }
+
+      if response.code.to_i != 200 && response.code.to_i != 201
+        err_msg = res_json["message"] || "HTTP Error! Status: #{response.code}"
+        if response.code.to_i == 403 || err_msg.downcase.include?("ip")
+          err_msg += "\n⚠️ [IP BLOCKED / UNREGISTERED] IP Anda diblokir atau belum terdaftar di whitelist API. Silakan hubungi developer via WhatsApp (https://wa.me/6283844082339) atau Telegram (https://t.me/zakki_store) untuk mendapatkan bantuan."
+        end
+        raise RuntimeError, "[ZakkiStore SDK Error] #{err_msg}"
+      end
+
+      res_json
+    rescue => e
+      raise RuntimeError, "[ZakkiStore SDK Error] Koneksi Gagal: #{e.message}"
+    end
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: zakkistore-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- ZakkiXD
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-06-01 00:00:00.000000000 Z
+dependencies: []
+description: Mempermudah integrasi layanan gerbang pembayaran (Payment Gateway) QRIS dan H2H Zakki Store.
+email:
+- b2b_partner@example.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/zakkistore-sdk.rb
+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: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.22
+signing_key: 
+specification_version: 4
+summary: Official Ruby SDK Client Library for Zakki Store B2B API Gateway
+test_files: []