# Waroengkuy Reseller API v1

Terakhir diperbarui 2 November 2026 (lihat Riwayat perubahan). Dokumentasi web: https://waroengkuy.com/reseller/docs · Markdown: https://waroengkuy.com/reseller/docs.md

API server-ke-server untuk reseller Waroengkuy: cek saldo, daftar produk (harga reseller, stok, foto, deskripsi), beli akun digital pakai saldo deposit (akun langsung ada di respons), isi saldo lewat QRIS, mutasi saldo, kupon & statistik web toko, produk sendiri, dan jasa sosmed.

## Daftar isi

- Quickstart (5 menit)
- Dasar
- Alur yang disarankan
- ref_id (anti dobel)
- GET /balance
- GET /products
- POST /orders
- POST /invites
- GET /orders/{id}  ·  /orders?ref_id=…
- POST /orders/{id}/cancel
- POST /orders/{ref}/bazar-access
- GET /orders
- POST /deposits
- GET /deposits/{id}
- GET /mutations
- GET /coupons
- POST /coupons
- PUT /coupons/{id}
- DELETE /coupons/{id}
- GET /store/orders
- GET /store/stats
- GET /own-products
- POST /own-products/stock
- GET /smm/services
- POST /smm/orders
- GET /smm/orders
- GET /ppob/products
- POST /ppob/orders
- GET /ppob/orders/{id}  ·  /ppob/orders?ref_id=…
- GET /ppob/orders
- Kode error
- Contoh kode
- Riwayat perubahan

## Quickstart (5 menit)

1. **Buat API key** — Panel reseller → Pengaturan → API → “Buat API key”. Membuat ulang = key lama langsung mati. Key (`wrk_` + 40 karakter hex) hanya tampil sekali — simpan di env server, mis. `WRK_KEY`. Jangan taruh di aplikasi/HTML publik.
2. **Tes koneksi** — Harus `"ok": true` dan menampilkan saldomu.

   ```bash
   curl https://waroengkuy.com/api/reseller/v1/balance -H "Authorization: Bearer $WRK_KEY"
   ```
3. **Ambil katalog** — Catat `variant_id`, `price` (harga reseller-mu) & `stock`.

   ```bash
   curl https://waroengkuy.com/api/reseller/v1/products -H "Authorization: Bearer $WRK_KEY"
   ```
4. **Isi saldo (bila perlu)** — Bayar QRIS dari `qr_url`, lalu cek `GET /deposits/{id}` sampai `credited: true`.

   ```bash
   curl -X POST https://waroengkuy.com/api/reseller/v1/deposits -H "Authorization: Bearer $WRK_KEY" -H "Content-Type: application/json" -d '{"amount": 10000}'
   ```
5. **Beli** — `ref_id` = nomor transaksi unik di sistemmu. Akun ada di `order.accounts`. Timeout? Kirim ulang dengan `ref_id` yang SAMA.

   ```bash
   curl -X POST https://waroengkuy.com/api/reseller/v1/orders -H "Authorization: Bearer $WRK_KEY" -H "Content-Type: application/json" -d '{"variant_id": 8, "qty": 1, "ref_id": "TES-0001"}'
   ```

## Dasar

- Base URL: `https://waroengkuy.com/api/reseller/v1`
- Auth: header `Authorization: Bearer wrk_…` (atau `X-API-Key: wrk_…`). Format key: `wrk_` + 40 karakter hex huruf kecil. Buat/cabut key di panel reseller → Pengaturan → API.
- Body POST/PUT: JSON (`Content-Type: application/json`); `application/x-www-form-urlencoded` juga diterima. Body harus objek JSON — selain itu 400 `invalid_request`.
- Respons selalu JSON dengan `ok` true/false. Gagal → `error` (pesan utk manusia) + `code` (utk program) + field tambahan sesuai kasus. Path tak dikenal → 404 `not_found` + `endpoints` (daftar endpoint).
- Nominal = Rupiah (integer, tanpa desimal). Waktu = ISO-8601 UTC. ID = string berisi angka. Angka pecahan (mis. `qty: 2.9`) dibulatkan ke bawah.
- Batas per key per menit: 120 baca (GET), 60 tulis (`POST /orders`, batal, `/invites`, kupon, stok, `/smm/orders`), 10 `POST /deposits`, 30 Bazar Access; plus 180 permintaan/menit per IP. Lewat batas → HTTP 429 `rate_limited` + header `retry-after: 60`.
- Paginasi (`/orders`, `/mutations`, `/store/orders`): `limit` dijepit ke 1–100 (kosong/bukan angka → 20); halaman berikut = `before_id` dari `next_before_id` (null = habis).
- Key hanya untuk SERVER — jangan taruh di aplikasi mobile/HTML publik. Isi whitelist IP bila server-mu ber-IP tetap (IP lain → 403 `ip_not_allowed`).

## Alur yang disarankan

1. `GET /products` → simpan daftar varian, harga, stok, foto & deskripsi (cache 1–5 menit; jangan dipanggil tiap pembeli).
2. Pembeli bayar ke kamu → `POST /orders` dengan `ref_id` = nomor transaksi di sistemmu → kirim `order.accounts` ke pembeli.
3. Timeout / koneksi putus? Kirim ULANG `POST /orders` dengan `ref_id` yang SAMA (atau `GET /orders?ref_id=…`). Jangan buat ref_id baru.
4. `code: insufficient_balance` → `POST /deposits` (isi saldo QRIS) → cek `GET /deposits/{id}` tiap 5–10 detik sampai `credited: true`.
5. Rekap keuangan → `GET /mutations` (semua uang masuk/keluar saldo).
6. Tanpa saldo? `POST /orders` + `"payment": "qris"` → tampilkan `order.payment.qr_url` ke pembeli → `GET /orders/{id}` tiap 5–10 detik sampai status bukan `pending`. Pembeli batal? `POST /orders/{id}/cancel` (akun yang ditahan langsung dilepas).
7. Produk `type: manual` (undangan/akses diproses admin): kirim `data` (mis. `{"Email": "…"}`) saat order, ATAU setelah lunas status `need_data` → kirim `POST /invites` dengan `claim_code` + `data`.

## ref_id (anti dobel) — WAJIB dibaca

Setiap `POST /orders` WAJIB membawa `ref_id` unik (1–64 karakter: huruf, angka, `. _ : -`). Mengirim ulang dengan ref_id yang sama mengembalikan order yang SAMA (`"duplicate": true`) — saldo tidak terpotong dua kali. Ini cara aman menangani timeout.

## Endpoint

### GET /balance — Cek saldo

Saldo deposit saat ini + identitas reseller pemilik key, link grup reseller, dan promo bonus isi saldo (bila ada). Cocok sebagai tes koneksi.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/balance -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "reseller": { "id": 12, "name": "Toko Budi", "balance": 150000 },
  "group": {
    "joined": null, "tgJoined": true, "tgLinked": true, "syncedAt": null, "checking": false,
    "wa": "https://chat.whatsapp.com/…", "tg": "https://t.me/…"
  },
  "bonus": { "pct": 5, "min": 100000, "max": 50000, "until": "2026-10-31T16:59:59Z" }
}
```

**Field penting**

- `reseller.balance` — Saldo deposit (Rp) — dipakai POST /orders.
- `group` — Grup reseller: `wa` / `tg` = link undangan grup WhatsApp / Telegram. `joined` (WA) selalu null — grup WA hanya link, tidak dicek. `tgJoined` = sudah di grup Telegram (null = belum diketahui), `tgLinked` = akun Telegram sudah ditautkan. `group` = null untuk reseller di luar toko pusat.
- `bonus` — Hanya muncul saat ada promo bonus isi saldo: `pct` (% bonus), `min` (isi minimal agar dapat bonus), `max` (batas bonus Rp, 0 = tanpa batas), `until` (berakhir; null = tanpa batas waktu).

### GET /products — Daftar produk: harga, stok, foto & deskripsi

Satu baris per VARIAN yang bisa dibeli via API: produk otomatis dari stok pusat + produk manual. Kelompokkan dengan product_id.

- Hanya katalog pusat: varian khusus pembeli biasa tidak ikut, dan produk milikmu sendiri (stok sendiri) TIDAK muncul di sini — lihat `GET /own-products`. Harga sudah termasuk promo yang sedang berjalan.
- `image` = URL foto persegi 1:1 (WebP) siap unggah ke marketplace/katalog; `image_original` = file asli. Keduanya URL publik — boleh langsung dipakai di tokomu (hotlink) atau diunduh sekali lalu disimpan. Nilai `v` berubah bila foto diganti admin.
- `description` = deskripsi produk; `variant_description` = detail varian. Teks biasa dengan bagian opsional `## Syarat & Ketentuan` dan `## Catatan` (format Markdown ringan).
- `type: manual` = undangan/akses diproses admin pusat (mis. ChatGPT invite): `stock` null (tak terbatas), qty selalu 1, wajib isi `required_fields` (lewat `data` di POST /orders atau POST /invites). Kabar selesai/ditolak: GET /orders/{id}; ditolak → dana otomatis kembali ke saldo.
- `no_warranty: true` = produk TANPA GARANSI (akun bisa backfree/berkendala kapan saja, tanpa penggantian maupun pengembalian dana). POST /orders varian ini WAJIB menyertakan `accept_no_warranty: true` — sampaikan risikonya ke pelangganmu.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/products -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "items": [
    {
      "variant_id": "8",
      "product_id": "4",
      "product": "Meitu",
      "variant": "7 Hari",
      "category": "Akun Premium",
      "price": 8500,
      "normal_price": 10000,
      "stock": 80,
      "image": "https://waroengkuy.com/api/store-image/4?v=1727600000&sq=1",
      "image_original": "https://waroengkuy.com/api/store-image/4?v=1727600000",
      "description": "Akun Meitu VIP untuk edit foto tanpa watermark.\n\n## Syarat & Ketentuan\n- Jangan ganti password",
      "variant_description": "Masa aktif 7 hari sejak login pertama.",
      "variant_group": null,
      "type": "auto",
      "warranty_days": 7,
      "no_warranty": false
    }
  ]
}
```

**Field penting**

- `variant_id` — ID yang dipakai saat membeli (POST /orders).
- `product_id / product / variant` — ID & nama produk, nama varian.
- `category` — Kategori produk (boleh null).
- `price` — Harga RESELLER per akun (yang dipotong dari saldo).
- `normal_price` — Harga toko biasa (utk acuan harga jualmu).
- `stock` — Jumlah akun tersedia sekarang (null = produk manual, tak terbatas).
- `variant_group` — Label kelompok varian (mis. "Android" / "iOS") untuk menyusun pilihan di tokomu; null bila tak dikelompokkan.
- `type / required_fields` — auto · manual. Manual: daftar field yang wajib diisi (mis. ["Email"]).
- `image / image_original` — URL foto persegi 1:1 / foto asli; null bila belum ada foto.
- `description / variant_description` — Deskripsi produk / detail varian; null bila kosong.
- `warranty_days / no_warranty` — Garansi varian (hari; 0 = tanpa garansi; null = belum diatur). no_warranty true → POST /orders wajib `accept_no_warranty: true`.

### POST /orders — Beli: pakai saldo (akun langsung di respons) atau QRIS

Saldo: atomik — saldo terpotong, stok diambil, data akun dikembalikan di respons yang sama, atau tidak terjadi apa pun. QRIS (`payment: qris`): order `pending` + `order.payment` (QR) → polling GET /orders/{id}; akun ditahan 30 menit selama menunggu bayar.

- Urutan pengecekan (yang pertama gagal yang dikembalikan): (1) `variant_id`, `qty`, `ref_id`, `payment` valid → (2) `ref_id` sudah pernah dipakai → order lama dikembalikan (`duplicate: true`) tanpa cek lainnya → (3) varian ada & dijual ke reseller (404 `not_found` · 403 `buyer_only` · 400 `tier_direct_only`) → (4) persetujuan `accept_no_warranty` → (5) produk manual: qty 1, slot undangan penuh (409 `out_of_stock`), isian `data` → (6) `max_price` → (7) SALDO → (8) STOK. Jadi saldo 0 + stok 0 menghasilkan 402 `insufficient_balance`, bukan 409 `out_of_stock`. Untuk `payment: qris` langkah 7 diganti: total minimal, batas order menunggu bayar (429), lalu stok.
- `qty` pecahan dibulatkan ke bawah (`2.9` → 2); hasil di luar 1–50 → 400. Produk manual selalu `qty` 1. QRIS: maks 10 akun per order dan total minimal Rp1.000 (400 `min_total`).
- Respons order SALDO otomatis tidak membawa `order.type`; `GET /orders/{id}` membawanya.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `variant_id` | string | number | ya | variant_id dari GET /products. |
| `qty` | integer | tidak | 1–50 akun (default 1). |
| `ref_id` | string | ya | Nomor transaksi unik di sistemmu (anti dobel, lihat ref_id). |
| `max_price` | integer | tidak | Tolak (409 price_changed) bila harga per akun naik di atas angka ini. |
| `payment` | string | tidak | saldo (default) · qris = tanpa saldo, bayar QRIS (maks 10 akun, maks 20 order menunggu bayar). |
| `customer_email` | string | tidak | Produk manual yang cuma minta email: email pelangganmu (pengganti data, label field apa pun). |
| `data` | object | tidak | Produk manual: isian required_fields, mis. {"Email": "pembeli@gmail.com"}. Boleh dikosongkan → kirim belakangan lewat POST /invites. |
| `accept_no_warranty` | boolean | tidak | WAJIB `true` untuk varian `no_warranty` (GET /products): menyetujui risiko produk TANPA GARANSI — akun bisa backfree/berkendala kapan saja, tanpa penggantian maupun pengembalian dana. Tanpa ini → 400 no_warranty_ack_required. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/orders \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"variant_id": 8, "qty": 1, "ref_id": "INV-0001", "max_price": 8500}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": {
    "id": "3656",
    "ref": "WEBWRG755651774121",
    "ref_id": "INV-0001",
    "status": "success",
    "product": "Meitu — 7 Hari",
    "qty": 1,
    "price": 8500,
    "total": 8500,
    "paid_with": "saldo",
    "created_at": "2026-09-24T15:29:49.693Z",
    "accounts": ["Email : contoh@meitu.id\nPassword : rahasia123"],
    "note": "Catatan penggunaan dari admin (bisa kosong)"
  },
  "balance": 141500
}
```

**Field penting**

- `order.id` — ID order di Waroengkuy (pakai utk GET /orders/{id}).
- `order.ref` — Nomor pesanan Waroengkuy (tampil di invoice/WA).
- `order.ref_id` — ref_id milikmu yang dikirim saat membeli.
- `order.status` — success (terkirim / selesai diproses) · processing (lunas, sedang dikirim / diproses admin) · pending (menunggu bayar QRIS) · need_data (manual: lunas, menunggu data undangan) · refunded (manual: ditolak admin, dana kembali ke saldo) · expired · cancelled.
- `order.type` — auto (akun dari stok) · manual (diproses admin pusat: tanpa accounts; note = pesan admin / alasan ditolak).
- `order.price / total` — Harga per akun & total yang dipotong dari saldo.
- `order.paid_with` — saldo (API/web pakai saldo) · qris (QRIS: API payment=qris / belanja web) · site (pesanan web tokomu).
- `order.payment` — Hanya saat pending: { qris, amount (sudah + kode unik), expires_at, pay_url, qr_url } — tampilkan qr_url/qris ke pembeli.
- `order.data / claim_code` — Manual: data undangan yang terkirim; claim_code (WK-XXXXX-XXXXX) muncul saat status need_data → dipakai POST /invites.
- `order.accounts` — Array data akun (satu string per akun, baris dipisah \n). Hanya pada order lunas.
- `order.note` — Catatan penggunaan dari admin utk produk itu (boleh kosong).
- `balance` — Sisa saldo setelah order.
- `duplicate` — true bila ref_id sudah pernah dipakai — order lama dikembalikan, saldo tidak dipotong lagi.

**Contoh gagal**

- Saldo kurang (HTTP 402):

```json
{ "ok": false, "error": "Saldo tidak cukup: perlu Rp8.500, saldo Rp2.000.", "code": "insufficient_balance", "balance": 2000, "total": 8500 }
```

- Stok kurang (HTTP 409):

```json
{ "ok": false, "error": "Stok tidak cukup (tersedia 0).", "code": "out_of_stock", "stock": 0 }
```

- Harga naik di atas max_price (HTTP 409):

```json
{ "ok": false, "error": "Harga sekarang Rp9.000, di atas max_price Rp8.500.", "code": "price_changed", "price": 9000 }
```

- ref_id tidak valid (HTTP 400):

```json
{ "ok": false, "error": "ref_id wajib: 1–64 karakter (huruf, angka, . _ : -), unik per order.", "code": "invalid_request" }
```

- Data manual salah (HTTP 400):

```json
{ "ok": false, "error": "Email harus email yang valid.", "code": "invalid_request", "required_fields": ["Email"] }
```

- Produk tanpa garansi belum disetujui (HTTP 400):

```json
{ "ok": false, "error": "Produk TANPA GARANSI (ChatGPT — Invite 1 Bulan) — centang persetujuan risiko dulu: …", "code": "no_warranty_ack_required", "noWarranty": ["46"] }
```

- Terlalu banyak QRIS menunggu (HTTP 429):

```json
{ "ok": false, "error": "Masih ada 20 order QRIS menunggu bayar — bayar atau tunggu kedaluwarsa dulu.", "code": "too_many_pending" }
```

- QRIS di bawah minimal (HTTP 400):

```json
{ "ok": false, "error": "Minimal pembelian QRIS Rp1.000 — tambah Rp500 lagi.", "code": "min_total", "min_total": 1000 }
```

- Terlalu sering batal (HTTP 429):

```json
{ "ok": false, "error": "Terlalu banyak order QRIS dibatalkan — coba lagi dalam 1 jam.", "code": "too_many_cancels" }
```

### POST /invites — Kirim data undangan (produk manual yang sudah lunas)

Order manual yang lunas TANPA data berstatus `need_data` dan membawa `claim_code`. Kirim kode itu + data undangan → order masuk antrean proses admin pusat (status `processing`). Kode berlaku sekali.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `claim_code` | string | ya | order.claim_code dari GET /orders/{id} (format WK-XXXXX-XXXXX). |
| `data` | object | ya | Isian required_fields produk, mis. {"Email": "pembeli@gmail.com"}. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/invites \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"claim_code": "WK-7KQ2M-PX9TA", "data": {"Email": "pembeli@gmail.com"}}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": {
    "id": "3701", "ref": "WEBWRG812233445566", "ref_id": "INV-0002", "status": "processing",
    "product": "ChatGPT — Invite 1 Bulan - No Garansi", "qty": 1, "price": 50000, "total": 50000,
    "paid_with": "qris", "type": "manual", "created_at": "2026-10-02T03:10:00.000Z",
    "accounts": [], "note": "", "data": { "Email": "pembeli@gmail.com" }
  }
}
```

**Contoh gagal**

- Kode salah / sudah dipakai (HTTP 404):

```json
{ "ok": false, "error": "Kode klaim tidak ditemukan atau sudah dipakai.", "code": "invalid_claim" }
```

- Data kurang (HTTP 400):

```json
{ "ok": false, "error": "Isi dulu: Email.", "code": "invalid_request", "required_fields": ["Email"] }
```

### GET /orders/{id}  ·  /orders?ref_id=… — Lihat ulang satu order + akunnya

Ambil kembali order (termasuk data akun) memakai id Waroengkuy atau ref_id milikmu. Bentuk `order` sama dengan POST /orders (+ `type`, dan `payment` selama `pending`).

- Order QRIS yang masih `pending` dicek ke gateway saat dibaca: sudah dibayar → langsung diproses; lewat batas bayar → `expired` dan akun yang ditahan dilepas. Jadi endpoint ini juga yang dipakai untuk polling.

**Parameter (query)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `id` | path | tidak | order.id dari respons beli (angka; bukan nomor WEBWRG — untuk itu pakai ref_id). |
| `ref_id` | query | tidak | ref_id milikmu (alternatif id). |

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/orders?ref_id=INV-0001" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": {
    "id": "3656",
    "ref": "WEBWRG755651774121",
    "ref_id": "INV-0001",
    "status": "success",
    "product": "Meitu — 7 Hari",
    "qty": 1,
    "price": 8500,
    "total": 8500,
    "paid_with": "saldo",
    "created_at": "2026-09-24T15:29:49.693Z",
    "accounts": ["Email : contoh@meitu.id\nPassword : rahasia123"],
    "note": "Catatan penggunaan dari admin (bisa kosong)"
  }
}
```

**Contoh gagal**

- Tidak ditemukan (HTTP 404):

```json
{ "ok": false, "error": "Order tidak ditemukan.", "code": "not_found" }
```

### POST /orders/{id}/cancel — Batalkan order QRIS yang belum dibayar

Membatalkan tagihan QRIS (payment: qris) yang masih `pending` dan melepas akun yang ditahan. Dicek ke gateway dulu: kalau ternyata pembeli SUDAH membayar, order tidak dibatalkan — respons berisi order yang sudah lunas (`cancelled: false`).

- Hanya order QRIS milikmu. Order pakai saldo (langsung lunas) & pesanan web toko tidak bisa dibatalkan lewat sini. Tanpa dibatalkan, order QRIS kedaluwarsa sendiri setelah 30 menit.

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/orders/3702/cancel -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "cancelled": true,
  "order": { "id": "3702", "ref": "WEBWRG812233445599", "ref_id": "INV-0003", "status": "cancelled", "product": "Meitu — 7 Hari", "qty": 1, "price": 8500, "total": 8500, "paid_with": "qris", "type": "auto", "created_at": "2026-10-02T04:00:00.000Z", "accounts": [], "note": "" }
}
```

**Field penting**

- `cancelled` — true = dibatalkan. false = ternyata sudah dibayar (lihat order.status).

**Contoh gagal**

- Sudah lunas / kedaluwarsa (HTTP 409):

```json
{ "ok": false, "error": "Order berstatus paid — hanya order yang menunggu bayar yang bisa dibatalkan.", "code": "not_cancellable", "order": { "id": "3702", "status": "success" } }
```

- Gateway sibuk (HTTP 502):

```json
{ "ok": false, "error": "Gateway pembayaran tak terjangkau — coba lagi sebentar (order tetap aman).", "code": "gateway_error" }
```

### POST /orders/{ref}/bazar-access — Bazar Access — kode akses Netflix

Ambil kode akses Netflix untuk akun pesananmu: `signin` (kode masuk), `verify` (kode verifikasi 6 digit), `household` (konfirmasi rumah/perangkat), atau `reset` (link reset password — HANYA varian Private). `{ref}` = nomor pesanan `WEBWRG…` atau `ref_id` milikmu.

- Kode ditarik dari email akun secara real-time, jadi PICU DULU di Netflix: `signin`/`verify` = coba login; `reset` = minta reset di netflix.com/loginhelp (pakai VPN negara akun); `household` = minta konfirmasi household. Belum ada email pemicu → `code: no_code`.
- Hanya pesanan Netflix milikmu yang sudah lunas. `reset` hanya varian Private, maks 1× per 24 jam per pesanan. Dibatasi 30 permintaan/menit per API key (tiap permintaan = akses nyata ke sistem) — jangan polling rapat.
- `{ref}` diawali `WEBWRG` dicari sebagai nomor pesanan; selain itu sebagai `ref_id`. Pesanan lewat masa aktif paket → 410 `expired`.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `kind` | string | tidak | signin (default) · verify · household · reset. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/orders/WEBWRG812233445599/bazar-access -H "Authorization: Bearer wrk_KEY_KAMU" -d '{"kind":"signin"}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "kind": "signin",
  "otp": "5607",
  "link": null
}
```

**Field penting**

- `otp` — Kode (signin/verify). null untuk reset/household.
- `link` — Link (reset/household). null untuk signin/verify.

**Contoh gagal**

- Belum ada kode — picu dulu di Netflix (HTTP 409):

```json
{ "ok": false, "error": "Belum ada kode baru di akun. Coba login dulu di Netflix…", "code": "no_code" }
```

- Reset bukan varian Private (HTTP 403):

```json
{ "ok": false, "error": "Reset password hanya untuk pesanan Netflix varian Private.", "code": "private_only" }
```

- Bukan pesanan Netflix (HTTP 409):

```json
{ "ok": false, "error": "Bazar Access hanya untuk pesanan Netflix.", "code": "not_netflix" }
```

- Masa aktif habis (HTTP 410):

```json
{ "ok": false, "error": "Masa aktif pesanan sudah habis.", "code": "expired" }
```

- Reset sudah dipakai hari ini (HTTP 429):

```json
{ "ok": false, "error": "Reset hanya bisa 1× per 24 jam untuk tiap pesanan. Coba lagi besok.", "code": "reset_limit" }
```

### GET /orders — Riwayat order

Terbaru dulu, TANPA data akun (pakai GET /orders/{id} utk akunnya). Termasuk pesanan web tokomu (`paid_with: site`).

**Parameter (query)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `limit` | integer | tidak | 1–100 (default 20); di luar rentang dijepit ke 1 / 100. |
| `before_id` | string | tidak | Halaman berikut = nilai next_before_id dari respons sebelumnya. |

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/orders?limit=20" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "orders": [
    {
      "id": "3656", "ref": "WEBWRG755651774121", "ref_id": "INV-0001", "status": "success",
      "product": "Meitu — 7 Hari", "qty": 1, "price": 8500, "total": 8500,
      "paid_with": "saldo", "created_at": "2026-09-24T15:29:49.693Z"
    }
  ],
  "next_before_id": null
}
```

**Field penting**

- `next_before_id` — null = tidak ada halaman berikutnya.
- `fee` — Hanya pesanan web toko: biaya pemrosesan/platform.

### POST /deposits — Isi saldo lewat QRIS

Membuat tagihan QRIS. Bayar PERSIS `amount` (sudah termasuk kode unik kecil yang ikut masuk saldo). Berlaku 30 menit; maks 3 QRIS aktif.

- Tampilkan gambar `qr_url` (PNG) ke dirimu/pembayar, atau buka `pay_url`. Bisa juga render sendiri dari string `qris`.
- Bila ada promo bonus isi saldo, bonus masuk otomatis saat lunas (terlihat di GET /mutations sebagai `bonus`).

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `amount` | integer | ya | Rp10.000 – Rp10.000.000. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/deposits \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100000}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "deposit": {
    "id": "3701", "status": "pending", "amount": 100137, "base_amount": 100000,
    "qris": "00020101021226…", "expires_at": "2026-09-24T16:10:00Z",
    "pay_url": "https://waroengpay.com/pay/WRG-…", "qr_url": "https://waroengpay.com/pay/WRG-…/qr.png"
  }
}
```

**Contoh gagal**

- Sudah 3 QRIS aktif (HTTP 429):

```json
{ "ok": false, "error": "Masih ada 3 QRIS isi saldo aktif — bayar atau tunggu kedaluwarsa dulu.", "code": "too_many_pending" }
```

### GET /deposits/{id} — Status isi saldo

Saldo masuk otomatis ±1 menit setelah bayar; `credited: true` = sudah masuk. Cek tiap 5–10 detik, jangan lebih cepat.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/deposits/3701 -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "deposit": {
    "id": "3701", "status": "paid", "amount": 100137, "base_amount": 100000,
    "credited": true, "expires_at": "2026-09-24T16:10:00Z", "paid_at": "2026-09-24T15:42:11Z"
  },
  "balance": 250137
}
```

**Field penting**

- `deposit.status` — pending · paid · expired · cancelled.
- `deposit.credited` — true = sudah masuk saldo (termasuk bonus bila ada).

### GET /mutations — Mutasi saldo

Semua uang masuk/keluar saldo, terbaru dulu. Paginasi sama dengan GET /orders.

**Parameter (query)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `limit` | integer | tidak | 1–100 (default 20); di luar rentang dijepit ke 1 / 100. |
| `before_id` | string | tidak | next_before_id dari halaman sebelumnya. |

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/mutations?limit=20" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "mutations": [
    { "id": "88", "kind": "order", "amount": -8500, "balance_after": 141500, "payment_id": "3656",
      "note": "Meitu — 7 Hari · WEBWRG755651774121", "created_at": "2026-09-24T15:29:49.693Z" }
  ],
  "next_before_id": null
}
```

**Field penting**

- `kind` — topup (isi saldo) · bonus (bonus isi saldo) · order (pembelian) · refund (pengembalian) · late (modal ditahan ulang) · adjust (penyesuaian admin).
- `amount` — Bertanda: + masuk, − keluar.

### GET /coupons — Daftar kupon web toko

Semua kupon web tokomu + pemakaian. Potongan kupon diambil dari marginmu (bukan dari pusat).

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/coupons -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "coupons": [
    { "id": "41", "code": "HEMAT10", "kind": "pct", "value": 10, "max_disc": 5000, "min_order": 20000, "quota": 100, "per_wa": 1,
      "product_ids": [], "starts_at": null, "ends_at": "2026-10-31T16:59:59Z", "enabled": true, "auto_after": false,
      "used": 12, "pending": 1, "disc_total": 41500, "revenue": 398000, "text": "Diskon 10% maks Rp5.000 · min Rp20.000" }
  ],
  "max": 50
}
```

### POST /coupons — Buat kupon

Membuat kupon baru untuk web tokomu. Kode unik (huruf/angka 3–20, otomatis huruf besar).

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `code` | string | ya | 3–20 huruf/angka tanpa spasi. |
| `kind` | string | ya | `pct` (persen) atau `amount` (potongan Rupiah). |
| `value` | integer | ya | pct: 1–90 · amount: Rp100–Rp1.000.000. |
| `max_disc` | integer | tidak | Batas potongan untuk pct (0 = tanpa batas). |
| `min_order` | integer | tidak | Minimal belanja (Rp). |
| `quota` | integer | tidak | Total pemakaian maksimal (0 = tanpa batas). |
| `per_wa` | integer | tidak | Maks pemakaian per nomor WA pembeli (default 1, 0 = bebas). |
| `product_ids` | string[] | tidak | Batasi ke produk tertentu (id dari GET /products). Kosong = semua. |
| `starts_at / ends_at` | ISO-8601 | tidak | Masa berlaku (opsional). |
| `enabled` | boolean | tidak | Default true. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/coupons \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"code": "HEMAT10", "kind": "pct", "value": 10, "max_disc": 5000, "min_order": 20000, "quota": 100}'
```

**Contoh respons (200)**

```json
{ "ok": true, "id": "41" }
```

**Contoh gagal**

- Kode sudah dipakai (HTTP 409):

```json
{ "ok": false, "error": "Kode HEMAT10 sudah dipakai kupon lain.", "code": "conflict" }
```

- Nilai tidak valid (HTTP 400):

```json
{ "ok": false, "error": "Diskon 1–90%.", "code": "invalid_request" }
```

### PUT /coupons/{id} — Ubah kupon

Mengganti isi kupon. Kirim objek LENGKAP (field yang tidak dikirim kembali ke nilai bawaan, mis. `enabled` = true). Matikan kupon: `"enabled": false`.

**Contoh request**

```bash
curl -X PUT https://waroengkuy.com/api/reseller/v1/coupons/41 \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"code": "HEMAT10", "kind": "pct", "value": 15, "max_disc": 7000, "enabled": true}'
```

**Contoh respons (200)**

```json
{ "ok": true, "id": "41" }
```

### DELETE /coupons/{id} — Hapus kupon

Menghapus kupon. Pesanan lama yang memakai kupon ini tetap tercatat.

**Contoh request**

```bash
curl -X DELETE https://waroengkuy.com/api/reseller/v1/coupons/41 -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{ "ok": true }
```

### GET /store/orders — Pesanan web tokomu

Pesanan pembeli di web tokomu (bukan order API-mu), terbaru dulu, dengan laba per pesanan. Paginasi sama dengan GET /orders.

**Parameter (query)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `limit` | integer | tidak | 1–100 (default 20); di luar rentang dijepit ke 1 / 100. |
| `before_id` | string | tidak | next_before_id dari halaman sebelumnya. |

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/store/orders?limit=20" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "orders": [
    { "id": "5120", "ref": "WEBWRG812345678901", "status": "success", "product": "Netflix — 1 Bulan · Sharing", "qty": 1,
      "sell": 30000, "cost": 25000, "fee": 0, "profit": 5000, "buyer": "62812****7890",
      "created_at": "2026-10-09T08:01:12Z", "paid_at": "2026-10-09T08:02:03Z", "mode": "deposit",
      "wa": "6281234567890", "accounts": ["Email : contoh@netflix.id\nPassword : rahasia123"] }
  ],
  "next_before_id": null
}
```

**Field penting**

- `status` — Sama dengan order.status di POST /orders (success · processing · pending · need_data · refunded · expired · cancelled).
- `sell / cost / fee / profit` — Harga jual ke pembeli, modal ke pusat, biaya pemrosesan, laba (0 bila belum lunas).
- `mode` — deposit · split · central (mode bayar web toko saat pesanan dibuat).
- `wa / accounts` — Hanya pesanan lunas: nomor WA pembeli utuh + data akun (kosong untuk produk manual yang belum berisi akun) — untuk kirim ulang sendiri.
- `coupon / items / claims / manual` — Opsional: kupon yang dipakai `{code, disc}`, isi keranjang `[{t, q}]`, klaim garansi `{live, total}`, `manual: true` untuk produk proses-manual.

### GET /store/stats — Statistik web toko

Ringkasan penjualan web tokomu per hari: pesanan, omzet, laba, checkout & kunjungan, produk terlaris.

**Parameter (query)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `days` | integer | tidak | 7 · 30 (default) · 90. Nilai lain (mis. 14) diperlakukan sebagai 30. |

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/store/stats?days=30" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "stats": {
    "days": 30,
    "totals": { "orders": 42, "revenue": 1260000, "profit": 210000, "checkouts": 61, "views": 1830 },
    "series": [{ "day": "2026-10-09", "orders": 3, "revenue": 90000, "profit": 15000, "checkouts": 4, "views": 77 }],
    "top": [{ "product": "Netflix — 1 Bulan · Sharing", "units": 12, "orders": 12, "revenue": 360000, "profit": 60000 }]
  }
}
```

### GET /own-products — Produk milikmu (stok sendiri)

Produk yang kamu jual dengan stok sendiri di web toko, lengkap dengan varian (`variant_id`), harga, stok & status tinjauan. Butuh akun reseller (masuk email/Google) dan fitur produk sendiri yang sudah diaktifkan admin — tanpa itu 403 `forbidden`.

- Syarat: (1) API key milik reseller yang punya akun (masuk dengan email/Google), dan (2) fitur produk sendiri sudah diaktifkan admin. Tanpa salah satunya → 403 `forbidden`.
- Produk sendiri hanya dijual di web tokomu dan TIDAK muncul di `GET /products` (katalog pusat). Membuat/mengubah produk tetap dari panel; API hanya membaca daftar & menambah stok.
- Produk yang masih `pending` diperiksa ulang tiap daftar dibuka; yang belum lolos membawa `checks`.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/own-products -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "products": [
    { "product_id": "251", "title": "Voucher WiFi B-Link", "description": "…", "enabled": true,
      "review_status": "approved", "review_note": null, "image": "https://…", "images": [], "fields": ["Email"],
      "variants": [{ "variant_id": "903", "label": "30 Hari · 115 GB", "price": 45000, "original": 0, "stock": 8, "used": 31,
        "fee": 2250, "manual": false, "description": "" }] }
  ],
  "quota": 10, "used": 1,
  "fee": { "pct": 5, "min": 500, "min_price": 1500 },
  "autoApprove": true
}
```

**Field penting**

- `review_status` — pending = menunggu tinjauan · approved = lolos; catatan admin di review_note. Hanya approved yang tampil di web toko.
- `variants[].stock / used` — Baris stok tersedia / sudah terpakai.
- `variants[].fee` — Biaya platform per unit untuk harga varian itu = max(fee.min, ceil(price × fee.pct%)).
- `variants[].manual` — true = varian kamu proses sendiri (tanpa stok).
- `quota / used` — Batas jumlah produk sendiri / yang sudah dibuat.

**Contoh gagal**

- Belum memenuhi syarat (HTTP 403):

```json
{ "ok": false, "error": "Produk sendiri belum diaktifkan untuk akunmu - hubungi admin.", "code": "forbidden" }
```

### POST /own-products/stock — Tambah stok produk milikmu

Menambah baris stok (satu akun/kode per baris) ke varian produk milikmu; terkirim otomatis ke pembeli. Syarat sama dengan GET /own-products.

- Tiap baris di-trim, baris kosong dibuang, dan hanya 500 baris pertama yang disimpan (sisanya diabaikan tanpa error) — cek `added`. Tidak ada cek duplikat: kirim ulang = stok ganda.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `variant_id` | string | ya | Dari GET /own-products. |
| `lines` | string[] | ya | Satu akun per elemen (atau `text` berisi baris dipisah newline). |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/own-products/stock \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"variant_id": "903", "lines": ["KODE-AAA-111", "KODE-BBB-222"]}'
```

**Contoh respons (200)**

```json
{ "ok": true, "added": 2 }
```

**Contoh gagal**

- Tanpa baris (HTTP 400):

```json
{ "ok": false, "error": "Tempel minimal satu baris stok.", "code": "invalid_request" }
```

- Varian bukan milikmu (HTTP 404):

```json
{ "ok": false, "error": "Varian tidak ditemukan.", "code": "not_found" }
```

### GET /smm/services — Layanan jasa sosmed

Daftar layanan jasa sosmed (followers, likes, views…) dengan harga MODAL-mu per 1.000. Cache 5–15 menit di sisimu.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/smm/services -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "services": [
    { "service": 20001234, "name": "Instagram Followers Indonesia", "category": "Instagram Followers", "platform": "INSTAGRAM",
      "min": 100, "max": 10000, "refill": true, "unitRate": 18500 }
  ],
  "enabled": true
}
```

**Field penting**

- `unitRate` — Harga modal per 1.000 (Rp). Total = ceil(qty/1000 × unitRate) dibulatkan ke Rp100.

### POST /smm/orders — Pesan jasa sosmed (potong saldo)

Memesan layanan sosmed memakai saldo. `ref_id` mencegah order dobel saat kirim ulang (sama seperti POST /orders).

- Hanya untuk reseller toko pusat (selain itu 403 `not_available`). `ref_id` opsional, tapi TANPA `ref_id` kirim ulang = order baru — selalu isi.
- `qty` di luar min–max layanan atau link tidak valid → 400 `invalid_request`; layanan mati → 404 `not_found`; saldo kurang → 402 `insufficient_balance`.
- Respons `duplicate: true` membawa `order` ringkas `{ id, ref_code, delivery_status, smm_order }` (bentuknya beda dengan order baru) — pakai `id` lalu cek di GET /smm/orders.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `service` | integer | ya | Dari GET /smm/services. |
| `link` | string | ya | Tautan profil/postingan target (akun harus publik). |
| `qty` | integer | ya | Antara min–max layanan. |
| `ref_id` | string | tidak | Nomor transaksi unik di sistemmu (1–64 karakter: huruf, angka, `. _ : -`; tidak boleh diawali `reorder:`). |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/smm/orders \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"service": 20001234, "link": "https://instagram.com/akunpembeli", "qty": 1000, "ref_id": "INV-7781"}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": { "id": "5233", "ref": "WEBWRG…", "product": "Instagram Followers Indonesia", "qty": 1000, "total": 18500,
    "link": "https://instagram.com/akunpembeli", "delivery_status": "ordered", "panel_order": "4129", "message": "" },
  "balance": 131500
}
```

**Field penting**

- `duplicate` — true = ref_id sudah pernah dipakai → order lama dikembalikan, saldo tidak dipotong lagi.

### GET /smm/orders — Riwayat jasa sosmed

30 pesanan jasa sosmed terbaru (via saldo) beserta status panel & pengembalian dana.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/smm/orders -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "orders": [
    { "id": "5233", "ref": "WEBWRG…", "product": "Instagram Followers Indonesia", "qty": 1000, "total": 18500,
      "link": "https://instagram.com/akunpembeli", "panel_order": "4129", "delivery_status": "ordered", "refunded": 0 }
  ]
}
```

### GET /ppob/products — PPOB: daftar nominal (pulsa, e-wallet, token, game, voucher)

Semua nominal PPOB toko pusat dengan harga yang dipotong dari saldomu, jenis tujuan, dan status tersedia. Cache 5–10 menit di sisimu.

- `target` = jenis tujuan yang wajib dikirim saat order: `phone` (nomor HP 08…), `customer_id` (ID pelanggan/ID game, lihat `target_label`), `none` (voucher/kode — tanpa tujuan).
- `available: false` = sementara tidak dijual (dijeda, harga modal naik, atau kategori belum dibuka) — jangan tawarkan ke pelangganmu.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/ppob/products -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "open": true,
  "service_fee": 0,
  "items": [
    { "variant_id": 812, "product": "Pulsa Telkomsel", "label": "10.000", "category": "pulsa", "target": "phone", "target_label": "Nomor HP", "price": 10450, "available": true },
    { "variant_id": 901, "product": "Token PLN", "label": "20.000", "category": "token_pln", "target": "customer_id", "target_label": "ID Pelanggan / Nomor Meter", "price": 20900, "available": true }
  ]
}
```

**Field penting**

- `price` — Rp yang dipotong dari saldo per transaksi (sudah termasuk biaya layanan).
- `open` — false = PPOB sedang ditutup (semua `available` false).

### POST /ppob/orders — PPOB: isi pulsa / e-wallet / token / game (potong saldo)

Membeli satu nominal PPOB memakai saldo. Pesanan langsung diproses; cek hasilnya di GET /ppob/orders/{id}. Gagal = saldo kembali otomatis.

- Wajib `ref_id` unik per transaksi: kirim ulang dengan `ref_id` sama (mis. saat timeout) mengembalikan pesanan yang SAMA tanpa memotong saldo lagi (`duplicate: true`).
- Status awal biasanya `processing`; umumnya `success` (+ `sn`) dalam beberapa menit. `review` = sedang dicek admin (maks 1×24 jam). `failed` = saldo dikembalikan otomatis (`refunded: true`, tercatat di GET /mutations).
- Tujuan salah (nomor/ID valid tapi milik orang lain) tidak bisa ditarik — validasi di sistemmu sebelum memanggil API.
- Voucher (`target: none`): `target` boleh dikosongkan; nomor kontak transaksi = nomor WhatsApp profil reseller-mu.

**Parameter (body)**

| Nama | Tipe | Wajib | Keterangan |
|---|---|---|---|
| `variant_id` | integer | ya | Dari GET /ppob/products. |
| `target` | string | ya | Nomor HP 08… (`phone`) atau ID pelanggan/ID game (`customer_id`). Kosong untuk voucher. |
| `ref_id` | string | ya | Nomor transaksi unik di sistemmu (1–64 karakter: huruf, angka, `. _ : -`). |
| `max_price` | integer | tidak | Tolak (409 `price_changed`) bila harga sekarang di atas angka ini. |

**Contoh request**

```bash
curl -X POST https://waroengkuy.com/api/reseller/v1/ppob/orders \
  -H "Authorization: Bearer wrk_KEY_KAMU" \
  -H "Content-Type: application/json" \
  -d '{"variant_id": 812, "target": "081234567890", "ref_id": "TRX-10293", "max_price": 11000}'
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": { "id": 7311, "ref": "WEBWRG…", "ref_id": "TRX-10293", "product": "Pulsa Telkomsel — 10.000", "target": "081234567890",
    "price": 10450, "status": "processing", "sn": null, "message": null, "refunded": false, "created_at": "2026-11-02T03:12:44Z" },
  "balance": 189550
}
```

**Field penting**

- `status` — `processing` · `success` · `failed` · `review`.
- `sn` — Serial number / token listrik / kode voucher saat `success`.
- `refunded` — true = saldo sudah dikembalikan (pesanan `failed`).

### GET /ppob/orders/{id}  ·  /ppob/orders?ref_id=… — PPOB: status satu pesanan

Ambil status terbaru (poll tiap 10–30 detik sampai `success`/`failed`). Bisa pakai id dari respons order atau `ref_id`-mu.

**Contoh request**

```bash
curl https://waroengkuy.com/api/reseller/v1/ppob/orders/7311 -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{
  "ok": true,
  "order": { "id": 7311, "ref": "WEBWRG…", "ref_id": "TRX-10293", "product": "Pulsa Telkomsel — 10.000", "target": "081234567890",
    "price": 10450, "status": "success", "sn": "0417XXXXXXXXXXXX", "message": null, "refunded": false, "created_at": "2026-11-02T03:12:44Z" }
}
```

### GET /ppob/orders — PPOB: riwayat

Pesanan PPOB terbaru (bawaan 20, maks 100) — terbaru dulu. Halaman berikutnya: `before_id` = id terkecil di halaman ini.

**Contoh request**

```bash
curl "https://waroengkuy.com/api/reseller/v1/ppob/orders?limit=20" -H "Authorization: Bearer wrk_KEY_KAMU"
```

**Contoh respons (200)**

```json
{ "ok": true, "orders": [ { "id": 7311, "status": "success", "sn": "0417…", "price": 10450, "target": "081234567890", "ref_id": "TRX-10293" } ] }
```

## Kode error

| HTTP | code | Arti |
|---|---|---|
| 400 | `invalid_request` | Parameter salah/kurang (mis. ref_id kosong, qty di luar 1–50, amount di luar batas, body bukan JSON). |
| 400 | `no_warranty_ack_required` | Varian TANPA GARANSI (no_warranty) — kirim ulang dengan accept_no_warranty: true. |
| 400 | `min_total` | Order QRIS di bawah Rp1.000 — respons memuat min_total (dan min_qty bila menambah qty cukup). |
| 400 | `tier_direct_only` | Varian berharga per umur akun — tidak dijual lewat API, beli langsung di toko utama. |
| 401 | `unauthorized` | API key kosong, format salah, dicabut, atau reseller tidak aktif. |
| 402 | `insufficient_balance` | Saldo kurang — respons memuat balance & total. |
| 403 | `ip_not_allowed` | IP server tidak ada di whitelist. |
| 403 | `buyer_only` | Varian khusus pembeli biasa (tak dijual ke reseller). |
| 403 | `forbidden` | Fitur belum aktif untuk akunmu (mis. produk sendiri butuh akun email/Google + diaktifkan admin). |
| 403 | `not_available` | Jasa sosmed hanya untuk reseller toko pusat. |
| 403 | `private_only` | Bazar Access reset hanya untuk Netflix varian Private. |
| 404 | `not_found` | Produk/order/kupon/varian/endpoint tidak ada. |
| 404 | `invalid_claim` | claim_code salah atau sudah dipakai (409 bila terpakai bersamaan). |
| 409 | `out_of_stock` | Stok kurang dari qty (atau slot undangan produk manual penuh) — respons memuat stock tersedia. |
| 409 | `price_changed` | Harga sekarang di atas max_price — respons memuat price terbaru. |
| 409 | `conflict` | Bentrok data web toko (mis. kode kupon sudah dipakai). |
| 409 | `not_cancellable` | Order bukan QRIS yang menunggu bayar — respons memuat order terkini. |
| 409 | `not_netflix · not_ready · no_code` | Bazar Access: bukan pesanan Netflix · data akun belum siap · belum ada kode baru (picu dulu di Netflix). |
| 410 | `expired` | Bazar Access: masa aktif pesanan habis. |
| 429 | `rate_limited` | Terlalu cepat — tunggu sesuai header retry-after (60 detik). |
| 429 | `reset_limit` | Bazar Access reset sudah dipakai dalam 24 jam terakhir. |
| 429 | `too_many_pending` | QRIS menunggu bayar sudah penuh (isi saldo: 3 aktif · order: 20 order / 20 akun tertahan). |
| 429 | `too_many_cancels` | 10 order QRIS atau lebih dibatalkan dalam 1 jam — tunggu sebentar. |
| 502 | `upstream_error / gateway_error` | Gangguan sementara — ulangi (order: dengan ref_id yang sama). |
| 503 | `unavailable` | API sedang tidak tersedia — ulangi nanti. |

## Contoh kode

### Node.js (fetch)

```js
const API = "https://waroengkuy.com/api/reseller/v1";
const headers = { Authorization: "Bearer " + process.env.WRK_KEY, "Content-Type": "application/json" };

// 1) Katalog (cache 1–5 menit)
const { items } = await (await fetch(API + "/products", { headers })).json();

// 2) Beli — ref_id = nomor invoice di sistemmu (kirim ulang dgn ref_id sama bila timeout)
const res = await fetch(API + "/orders", {
  method: "POST", headers,
  body: JSON.stringify({ variant_id: items[0].variant_id, qty: 1, ref_id: invoiceNo }),
});
const j = await res.json();
if (j.ok) kirimKePembeli(j.order.accounts);
else if (j.code === "insufficient_balance") alertAdmin("Isi saldo dulu");
```

### PHP (cURL)

```php
$ch = curl_init("https://waroengkuy.com/api/reseller/v1/orders");
curl_setopt_array($ch, [
  CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("WRK_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["variant_id" => 8, "qty" => 1, "ref_id" => $invoiceNo]),
]);
$j = json_decode(curl_exec($ch), true);
if ($j["ok"] ?? false) { $akun = $j["order"]["accounts"]; }
```

### Python (requests)

```python
import os, requests
API = "https://waroengkuy.com/api/reseller/v1"
H = {"Authorization": f"Bearer {os.environ['WRK_KEY']}"}

produk = requests.get(f"{API}/products", headers=H, timeout=30).json()["items"]
r = requests.post(f"{API}/orders", headers=H, timeout=30,
                  json={"variant_id": produk[0]["variant_id"], "qty": 1, "ref_id": invoice_no}).json()
if r["ok"]:
    kirim_ke_pembeli(r["order"]["accounts"])
elif r.get("code") == "insufficient_balance":
    print("Isi saldo dulu")
```

## Riwayat perubahan

Terbaru di atas. Tanggal WIB. Kategori: Baru · Diubah · Diperbaiki · Usang.

### 2 November 2026

- **Baru** — PPOB lewat API: `GET /ppob/products` (pulsa, e-wallet, token PLN, game, voucher + harga & jenis tujuan), `POST /ppob/orders` (potong saldo, idempoten per `ref_id`), `GET /ppob/orders` & `GET /ppob/orders/{id}` (status `processing` · `success` + SN · `failed` + saldo kembali otomatis).

### 28 Oktober 2026

- **Diperbaiki** — `GET /own-products` & `POST /own-products/stock` kini bisa dipakai lewat API key (sebelumnya selalu 403 `forbidden`). Syarat tetap: akun reseller masuk email/Google + produk sendiri diaktifkan admin.
- **Diperbaiki** — Error kupon, pesanan/statistik web toko & produk sendiri kini selalu membawa `code` (`invalid_request` · `not_found` · `forbidden` · `conflict`).
- **Diperbaiki** — 401 untuk key yang formatnya salah kini berpesan "Format API key salah" (bukan "API key wajib").
- **Diubah** — `GET /balance` → `group.joined` (grup WA) selalu `null`: grup WA hanya link, keanggotaan tidak dicek lagi. Yang dicek hanya Telegram (`group.tgJoined`).
- **Baru** — Dokumentasi: objek `group` & `bonus` di `GET /balance`, field `variant_group` di `GET /products`, `max` kupon (50), kode `forbidden`/`conflict`/`min_total`/`tier_direct_only`, urutan pengecekan `POST /orders`, batas & pembulatan parameter, Quickstart, daftar isi, dan riwayat perubahan ini.
- **Usang** — Kode error `manual_product` dihapus dari dokumentasi — server tidak pernah mengirimnya.

### 24 Oktober 2026

- **Baru** — `POST /orders/{ref}/bazar-access` — kode akses Netflix (`signin` · `verify` · `household` · `reset`), maks 30 permintaan/menit per key.
- **Baru** — Bazar Access: pesanan lewat masa aktif → 410 `expired`; `reset` maks 1× per 24 jam per pesanan → 429 `reset_limit`.

### 9 Oktober 2026

- **Baru** — Web toko lewat API: `GET/POST /coupons`, `PUT/DELETE /coupons/{id}`, `GET /store/orders`, `GET /store/stats`.
- **Baru** — Produk sendiri: `GET /own-products`, `POST /own-products/stock`.
- **Baru** — Jasa sosmed: `GET /smm/services`, `POST /smm/orders`, `GET /smm/orders`.

### 5 Oktober 2026

- **Baru** — Varian TANPA GARANSI: `warranty_days` & `no_warranty` di `GET /products`; `POST /orders` wajib `accept_no_warranty: true` → selain itu 400 `no_warranty_ack_required`.
- **Baru** — `variant_group` di `GET /products` (label kelompok varian; baru didokumentasikan 28 Okt 2026).
- **Baru** — Varian berharga per umur akun ditolak via API → 400 `tier_direct_only` (beli langsung di toko utama).

### 2 Oktober 2026

- **Baru** — `POST /orders` + `"payment": "qris"` (beli tanpa saldo, polling `GET /orders/{id}`) dan `POST /orders/{id}/cancel`.
- **Baru** — Produk manual (`type: manual`, `required_fields`): isi `data`/`customer_email` saat order, atau `POST /invites` dengan `claim_code` setelah status `need_data`.

### 30 September 2026

- **Baru** — `GET /products` membawa `image`, `image_original`, `description`, `variant_description`; dokumentasi Markdown `/reseller/docs.md` untuk AI agent.

### 24 September 2026

- **Baru** — Rilis API v1: `GET /balance`, `GET /products`, `POST /orders` (saldo, idempoten per `ref_id`), `GET /orders`, `GET /orders/{id}`, `POST /deposits`, `GET /deposits/{id}`, `GET /mutations`.
