Nominal Produk PPOB
Endpoint ini digunakan untuk mengambil daftar nominal yang tersedia dari produk detail (produk level 2). Biasanya digunakan untuk menampilkan opsi nilai pembelian seperti pulsa 5.000, 10.000, 20.000, dan seterusnya.
Setiap produk level 2 memiliki daftar nominal tersendiri yang dapat bervariasi berdasarkan operator, masa aktif, promo, dan harga jual.
🚣️ Endpoint GET
Section titled “🚣️ Endpoint GET”https://sandbox.bisatopup.co.id/api/product/detail/{product_id}Gantilah {product_id} dengan ID dari produk detail (level 2) yang diperoleh dari endpoint /api/product/daftar/{id}.
Contoh:
https://sandbox.bisatopup.co.id/api/product/detail/11🔐 Autentikasi
Section titled “🔐 Autentikasi”Permintaan ini memerlukan token autentikasi. Tambahkan header berikut:
Authorization: Bearer <token>📤 Response
Section titled “📤 Response”Respons berisi daftar nominal yang tersedia dari suatu produk detail.
Contoh Response
Section titled “Contoh Response”{ "data": { "products": [ { "product_detail_id": 1420, "product_id": 11, "product_code": "SP2", "name": "TELKOMSEL 2.000", "desc": "Masa Aktif 1 hari", "price": 3395, "grup": null, "nominal": 2000, "note": "", "is_active": 1, "is_gangguan": 0, "product_name": "TELKOMSEL", "image_url": "https://cdn.bisatopup.co.id/logo_product/1679968360.png", "parent_id": 1 } ] }}Penjelasan Field:
Section titled “Penjelasan Field:”| Field | Tipe | Deskripsi |
|---|---|---|
product_detail_id | integer | ID unik untuk detail nominal produk |
product_id | integer | ID produk induk (level 2) |
product_code | string | Kode produk yang digunakan saat transaksi |
name | string | Nama lengkap produk termasuk nominal |
desc | string | Deskripsi tambahan seperti masa aktif atau informasi promo |
price | integer | Harga jual dalam satuan rupiah |
grup | string | Kategori tambahan (jika ada) |
nominal | integer | Nilai nominal produk (bisa null jika tidak tersedia eksplisit) |
note | string | Catatan tambahan |
is_active | integer | Status aktif produk (1 = aktif, 0 = tidak aktif) |
is_gangguan | integer | Status gangguan produk (1 = gangguan, 0 = normal) |
product_name | string | Nama dari produk induk |
image_url | string | URL gambar/logo produk |
parent_id | integer | ID dari kategori utama |
🔹 Catatan Penting
Section titled “🔹 Catatan Penting”- Produk nominal dapat muncul lebih dari satu untuk setiap produk, termasuk versi promo.
- Jika
nominalbernilainull, Anda bisa mengekstrak nominal dari fieldnameuntuk ditampilkan. - Gunakan
is_activedanis_gangguanuntuk menyaring produk yang bisa ditransaksikan.
Setelah mendapatkan nominal, Anda dapat melanjutkan ke proses transaksi dengan mengirim product_code pada endpoint pembelian.