search

No results found

API Reference chevron_right Items chevron_right List Items
inventory_2 ITEMS

List Items

Dapatkan daftar semua item/produk yang tersedia untuk dijual. Termasuk informasi harga reseller, stok, dan kategori.

GET /v1/item

filter_list Query Parameters

Parameter Type Description
page integer Optional. Nomor halaman untuk pagination.
per_page integer|string Optional. Jumlah item per halaman (default: 100, max: 500). Gunakan "all" untuk mendapatkan semua item dalam 1 request.
updated_since string Optional. ISO 8601 timestamp. Hanya return item yang diupdate setelah waktu ini. Gunakan nilai server_time dari response sebelumnya.
category string Optional. Filter by category slug.
search string Optional. Cari berdasarkan nama produk.

analytics Response Item Fields

id integer

ID unik item.

name string

Nama item/variant.

price integer

Harga reseller dalam Rupiah.

stock integer

Jumlah stok tersedia.

category string

Nama kategori produk.

order_process string

Tipe pemrosesan item: auto, manual, h2h, atau vip.

h2h_provider string|null

Nama source pemrosesan H2H jika item diproses via host-to-host. Nilai ini bersifat informatif untuk identifikasi internal flow.

provider_meta object|null

Metadata capability tambahan item H2H. Field ini dapat berisi konfigurasi seperti open_denom, min_qty, dan max_qty.

required_fields array|null

Daftar field input yang harus dikirim saat membuat transaksi. Gunakan ini agar integrasi tetap seragam untuk provider lama maupun baru.

validation object

Metadata cek ID. Tampilkan tombol Check hanya jika validation.available bernilai true, lalu panggil POST /v1/item/validate.

schema Provider Contract

Response item diseragamkan dengan empat kunci utama: order_process untuk flow, h2h_provider untuk nama provider, provider_meta untuk capability khusus, required_fields untuk kebutuhan input order, dan validation untuk capability cek ID.

Example Request

# Full sync (pertama kali):
    curl --request GET \
      --url 'https://sekalipay.com/api/v1/item?per_page=all' \
      --header 'X-APIKEY: YOUR_API_KEY'

    # Delta sync (selanjutnya, gunakan server_time dari response sebelumnya):
    curl --request GET \
      --url 'https://sekalipay.com/api/v1/item?per_page=all&updated_since=2026-02-26T14:00:00Z' \
      --header 'X-APIKEY: YOUR_API_KEY'

    # With filters:
    curl --request GET \
      --url 'https://sekalipay.com/api/v1/item?category=1&search=Netflix&page=1&per_page=50' \
      --header 'X-APIKEY: YOUR_API_KEY'

Response Sample

200 OK
{
      "message": "OK",
      "data": [
        {
          "id": 1,
          "name": "Aplikasi Premium",
          "icon": "app-icon.png",
          "products": [
            {
              "id": 10,
              "name": "Gemini Advanced",
              "image": "gemini.png",
              "variants": [
                {
                  "id": 3342,
                  "sku": "GA-1BAB",
                  "name": "12 Bulan",
                  "price": 6000,
                  "order_process": "h2h",
                  "h2h_provider": "h2h",
                  "provider_meta": {
                    "open_denom": true,
                    "min_qty": 10000,
                    "max_qty": 10000000,
                    "step_qty": 1,
                    "qty_label": "Nominal"
                  },
                  "required_fields": [
                    {
                      "key": "note",
                      "label": "User ID",
                      "required": true
                    },
                    {
                      "key": "provider_qty",
                      "label": "Nominal",
                      "required": true,
                      "min": 10000,
                      "max": 10000000
                    }
                  ],
                  "validation": {
                    "available": true,
                    "endpoint": "/api/v1/item/validate",
                    "requires_zone_id": true,
                    "fields": [
                      { "key": "customer_id", "label": "User ID", "required": true },
                      { "key": "zone_id", "label": "Server ID", "required": true }
                    ]
                  },
                  "stock": 50,
                  "updated_at": "2026-02-26T14:01:10.000000Z"
                }
              ]
            }
          ]
        }
      ],
      "meta": {
        "total_items": 2891,
        "is_delta": false
      },
      "server_time": "2026-02-26T22:00:00+07:00"
    }
chat_bubble Feedback