Dokumentasi

01 · Mulai berjualan

1. Minta akun kepada pemilik Shiroshop. Akun dibuat oleh pemilik; belum ada pendaftaran mandiri. Kamu akan menerima username dan password portal.
2. Tentukan cara berjualan. Pakai bot Telegram yang dikelola Shiroshop, atau hubungkan aplikasi sendiri melalui API.
3. Tunggu produk dan akses diaktifkan. Pemilik mengatur produk yang boleh dijual beserta komisi atau harga reseller. Akun baru nonaktif secara default.
4. Masuk ke portal. Periksa menu Produk, pastikan harga dan stok sesuai, lalu mulai menjual.

02 · Pilih model transaksi

Model ditentukan pemilik saat akun dibuat dan tidak dapat diganti dari portal. Komisi berupa nominal Rupiah per unit/kategori, bukan persentase. Harga dan komisi pesanan yang sudah dibuat tetap mengikuti nilai saat pesanan tersebut dibuat.

03 · Menggunakan portal

Portal menampilkan hingga 200 pesanan/WD dan 500 mutasi terbaru. Portal bukan halaman checkout pembeli; pembelian dilakukan melalui bot atau aplikasi yang terintegrasi.

Sesi login berlaku sampai 8 jam. Jika lupa password, hubungi pemilik untuk reset. Reset password membatalkan sesi lama. Tombol Keluar mengakhiri sesi yang sedang dipakai.

04 · Memakai bot Telegram reseller

1. Buat bot melalui BotFather, lalu berikan tokennya kepada pemilik Shiroshop melalui jalur privat. Token tidak diperlukan jika kamu memakai aplikasi sendiri dengan API key.
2. Berikan ID Telegram pemilik reseller. Pemilik Shiroshop memasukkan token, identitas toko, ID pemilik, dan mengaktifkan bot melalui panelnya.
3. Buka bot reseller dan tekan Start. Langkah ini juga diperlukan agar bot dapat mengirim notifikasi kepadamu.
4. Pembeli memilih produk → kategori → jumlah → Bayar QRIS. Setelah pembayaran terverifikasi, bot mengirim file berisi produk.
5. Pantau penjualan dan komisi dari bot atau portal.

Bot reseller mendukung QRIS, Binance, saldo IDR/USDT dan pilihan bahasa. Lihat panduan menu pembeli di bawah.

05 · Menarik saldo komisi

1. Masuk ke Saldo & WD. Periksa komisi yang tersedia.
2. Isi nominal Rupiah bulat serta bank/e-wallet, nomor rekening, dan nama pemilik rekening.
3. Konfirmasi pengajuan. Dana langsung berpindah dari komisi tersedia ke WD tertahan.
4. Tunggu pemilik memeriksa dan mentransfer dana. Persetujuan belum berarti dana sudah ditransfer.

06 · Mulai integrasi API

Semua request client dikirim ke satu base URL:

https://shiroshopreseller.abyte.my.id

Minta API key kepada pemilik setelah akun dan produkmu diaktifkan. Key hanya ditampilkan sekali saat dibuat. Key lama langsung tidak berlaku ketika dirotasi atau dicabut.

Gunakan header Authorization: Bearer API_KEY dan Content-Type: application/json. Simpan key di backend bot/website kamu, bukan di JavaScript browser pembeli.

Request pertama: lihat katalog

Contoh Bash/cURL berikut memakai placeholder. Ganti API key dengan milikmu; jangan kirim key melalui chat publik.

BASE='https://shiroshopreseller.abyte.my.id'
API_KEY='GANTI_DENGAN_API_KEY'

curl --fail-with-body "$BASE/v1/products"   -H "Authorization: Bearer $API_KEY"

Contoh response katalog (data ilustrasi):

{
  "products": [{
    "productId": "produk-contoh",
    "categoryId": "paket-contoh",
    "product": "Produk Contoh",
    "category": "Paket 30 Hari",
    "description": "Petunjuk produk",
    "price": 20000,
    "commission": 3000,
    "stock": 12
  }]
}

price adalah harga per unit untuk akunmu. Pada model deposit, nilai ini merupakan harga reseller dan commission bernilai 0. Stok dapat berubah sebelum pesanan dibuat; respons pembuatan pesanan adalah hasil akhirnya.

07 · Alur pesanan API

1. Buat pesanan dengan referensi unik

Ambil ID dari katalog, bukan dari contoh di bawah. Gunakan qty angka bulat 1–20 dan buyerId identitas pembeli di sistemmu. Harga dan komisi dihitung server.

curl --fail-with-body "$BASE/v1/orders"   -H "Authorization: Bearer $API_KEY"   -H 'Content-Type: application/json'   -H 'Idempotency-Key: toko-pesanan-000001'   --data '{"productId":"ID_DARI_KATALOG","categoryId":"ID_DARI_KATALOG","qty":1,"buyerId":"pelanggan-123"}'

Contoh respons model komisi; ID, waktu, dan gambar hanya ilustrasi:

{
  "id": "O_ID_PESANAN",
  "resellerId": "R_ID_RESELLER",
  "reference": "toko-pesanan-000001",
  "buyerId": "pelanggan-123",
  "productId": "produk-contoh",
  "categoryId": "paket-contoh",
  "product": "Produk Contoh",
  "category": "Paket 30 Hari",
  "qty": 1,
  "unitPrice": 20000,
  "amount": 20000,
  "totalAmount": 20100,
  "commission": 3000,
  "mode": "commission",
  "status": "pending",
  "createdAt": 1793600000000,
  "expireAt": 1793603600000,
  "qrImage": "data:image/png;base64,DATA_GAMBAR_DARI_SERVER"
}

Pada model komisi, tampilkan qrImage sebagai gambar, nominal totalAmount, dan batas waktu expireAt. Timestamp menggunakan milidetik Unix. Jangan membuat URL pembayaran sendiri. Pada model deposit, saldo langsung dipotong dan pesanan menjadi paid; tidak ada QRIS.

2. Periksa status pembayaran

# Lihat status yang sudah tersimpan
curl --fail-with-body "$BASE/v1/orders/O_ID_PESANAN"   -H "Authorization: Bearer $API_KEY"

# Minta server memverifikasi pembayaran ke gateway
curl --fail-with-body -X POST "$BASE/v1/orders/O_ID_PESANAN/check"   -H "Authorization: Bearer $API_KEY"   -H 'Content-Type: application/json' --data '{}'

Periksa dengan jeda sekitar 10–15 detik dan berhenti ketika status sudah terminal. GET membaca status tersimpan; POST .../check memverifikasi ke gateway. Jangan menganggap pesanan lunas dari screenshot pembeli atau hanya karena waktu tunggu habis.

3. Ambil produk setelah paid

curl --fail-with-body -X POST "$BASE/v1/orders/O_ID_PESANAN/delivery"   -H "Authorization: Bearer $API_KEY"   -H 'Content-Type: application/json' --data '{}'

Respons berisi order (status delivered) dan array accounts. Contoh struktur kredensial adalah data fiktif:

{
  "order": { "id": "O_ID_PESANAN", "status": "delivered" },
  "accounts": [{
    "username": "CONTOH_USER",
    "password": "CONTOH_PASSWORD",
    "email": "contoh@example.test",
    "deskripsi": "Petunjuk pemakaian"
  }]
}

Objek order sebenarnya juga memuat metadata pesanan. Pemanggilan delivery pertama menyelesaikan serah-terima produk ke aplikasi reseller dan mengkreditkan komisi sekali. Retry menghasilkan produk yang sama; stok dan komisi tidak bertambah lagi. Aplikasi reseller bertanggung jawab meneruskan produk ke pembelinya. Endpoint ini tidak digunakan untuk pesanan bot terkelola, karena bot mengirim file sendiri.

Contoh Node.js di backend reseller

const base = 'https://shiroshopreseller.abyte.my.id';
const key = process.env.SHIRO_RESELLER_API_KEY;

async function shiro(path, options = {}) {
  const response = await fetch(base + path, {
    ...options,
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${key}`,
      ...options.headers
    }
  });
  const data = await response.json();
  if (!response.ok) throw new Error(`${response.status}: ${data.error}`);
  return data;
}

// Simpan reference secara permanen di database tokomu.
// Gunakan reference yang sama apabila request ini perlu diulang.
const order = await shiro('/v1/orders', {
  method: 'POST',
  headers: { 'Idempotency-Key': 'toko-pesanan-000001' },
  body: JSON.stringify({
    productId: 'ID_DARI_KATALOG',
    categoryId: 'ID_DARI_KATALOG',
    qty: 1,
    buyerId: 'pelanggan-123'
  })
});
// Simpan order.id. Tampilkan QRIS jika order.status === 'pending'.
// Periksa pembayaran lalu ambil delivery hanya setelah paid.

Contoh ini tidak otomatis mengulang request atau mengirim produk ke pembeli. Tambahkan penyimpanan referensi, penanganan timeout, dan pengiriman sesuai sistem tokomu. Jangan mencatat API key atau isi accounts ke log umum.

08 · Referensi endpoint

Seluruh path di bawah relatif ke base URL domain reseller. Bearer API key diperlukan kecuali endpoint sesi. Sesi portal juga bisa membaca data akun yang sama.

Tidak tersedia webhook pesanan reseller pada versi ini. Gunakan polling status. Batas umum API adalah 120 request per menit per IP; login maksimal 8 percobaan per 15 menit per IP. Beberapa client pada IP yang sama dapat berbagi batas tersebut. Perhatikan header rate limit dan kurangi frekuensi saat menerima 429.

09 · Status pesanan & error

Format error

{ "error": "Stok tidak cukup" }

10 · Pertanyaan umum

Password portal

Admin Shiroshop dapat mengisi password pilihan sendiri saat menambah reseller atau melalui Reseller > Kelola > Ganti password portal. Gunakan 8-128 karakter tanpa spasi di awal atau akhir. Jika kolom dikosongkan, sistem membuat password otomatis. Penggantian password mengakhiri sesi portal lama.

11 · Channel notifikasi reseller

1. Siapkan channel Telegram milik toko reseller.
2. Jadikan bot reseller admin dengan izin Posting Pesan. Akun Telegram pemilik reseller juga harus menjadi pemilik atau admin channel.
3. Buka portal → Channel notifikasi, atau panel Shiroshop → Reseller → Kelola.
4. Isi @username channel publik atau ID channel privat berawalan -100, aktifkan notifikasi, lalu pilih Periksa & simpan channel.

Fitur memerlukan akun model komisi, token bot, dan ID Telegram pemilik reseller yang sudah diatur admin Shiroshop. Pemeriksaan tidak mengirim pesan percobaan.

Transaksi yang selesai setelah fitur diaktifkan akan menghasilkan rekap dengan nama toko, pembeli tersamarkan, produk, jumlah, total pembayaran, invoice, sisa stok, dan waktu WIB. Komisi, WD, password, serta data akun produk tidak ditampilkan di channel. Transaksi lama tidak dikirim ulang. Status pengiriman tersedia di pengaturan channel.

Menu pembeli: pembayaran, saldo, dan bahasa

Bot reseller menampilkan deskripsi kategori dari Shiroshop, berikut pilihan pembayaran QRIS, saldo IDR, saldo USDT, Binance Pay, dan USDT BEP20 sesuai konfigurasi pusat. Harga USDT mengikuti aturan harga dan kurs Shiroshop. Stok dan harga diperiksa kembali ketika pesanan dibuat.

Gunakan /saldo atau tombol Saldo & Top up untuk melihat saldo pembeli. Saldo IDR dan USDT terpisah per toko reseller, tidak tergabung dengan saldo Shiroshop utama, toko reseller lain, atau komisi reseller. Top up IDR memakai QRIS; top up USDT memakai metode Binance yang aktif. Biaya QRIS tidak masuk saldo; transfer USDT yang cocok, termasuk kode unik, dikreditkan.

Untuk pembayaran Binance, kirim jumlah persis termasuk kode unik, ke UID/alamat dan jaringan yang ditampilkan. Konfirmasi hanya berasal dari riwayat Binance. Pembayaran setelah pesanan kedaluwarsa masuk saldo toko, bukan memesan ulang produk. Jangan mengirim bukti transfer sebagai pengganti verifikasi.

Pilih Bahasa / Language atau kirim /lang untuk mengganti Indonesia/English. Pilihan disimpan per pembeli dan per toko. Deskripsi Inggris memakai terjemahan Shiroshop yang tersedia; jika belum tersedia, teks asli tetap ditampilkan. Pemilik reseller memakai /komisi untuk saldo komisi dan /wd untuk pengajuan penarikan.

Menu menampilkan status memuat dan indikator mengetik. Pemeriksaan klik berjalan terpisah dari pemeriksaan pembayaran, dengan jeda 0,5 detik antarpengecekan; waktu respons tetap bergantung pada Telegram dan jaringan.

Menu bot, pembatalan, dan broadcast

Tombol menu di Telegram memuat perintah /start, /menu, /produk, /pesanan, /saldo dan /lang. Nama produk ditampilkan lengkap di atas tombol bernomor. Tombol Hubungi owner mengikuti username yang diisi di pengaturan reseller.

Pembatalan pembayaran

Pilih Batalkan pembayaran di invoice. Untuk QRIS, permintaan dicatat tetapi kode QR masih dapat dibayar sampai gateway memastikan kedaluwarsa; jangan membayar kode lama. Jika pembayaran sudah masuk, pesanan tetap diproses. Untuk Binance/USDT, invoice dapat ditutup sebelum pembayaran terdeteksi. Dana yang masuk setelah pembatalan dikreditkan ke saldo USDT toko. Pembayaran menggunakan saldo diproses langsung dan tidak memiliki invoice menunggu.

Broadcast oleh pemilik

Pemilik yang ID Telegram-nya terdaftar dapat memilih tombol Broadcast atau mengetik /broadcast, lalu mengirim teks atau foto. Untuk promosi produk, pilih Broadcast produk, pilih produk yang diizinkan, lalu kirim teks atau foto dengan keterangan. Dari portal web reseller, buka menu Broadcast produk, pilih produk, isi teks promosi, lihat pratinjau, lalu konfirmasi pengiriman. Status menampilkan jumlah diproses, terkirim, dan gagal. Foto dapat dikirim lewat bot. Pesan menampilkan harga dan stok serta tombol Beli sekarang. Harga dan stok diperiksa kembali saat pembeli membuka produk. Bot menampilkan pratinjau dan baru mengirim setelah pemilik menekan konfirmasi. Penerima adalah pengguna bot reseller tersebut yang sudah pernah berinteraksi; pengguna dapat berhenti melalui /stopbroadcast. Pemilik mendapat ringkasan terkirim dan gagal. Produk, saldo dan notifikasi transaksi tetap terpisah dari broadcast.