Beli Produk PPOB

Endpoint ini digunakan untuk melakukan transaksi pembelian produk PPOB seperti pulsa, paket data, token PLN, voucher game, dan produk digital lainnya. Setiap transaksi memerlukan ID produk detail, nomor pelanggan, dan reff_id unik untuk keperluan pencatatan.

---

🚣️ Endpoint POST

https://sandbox.bisatopup.co.id/api/transaksi

---

🔐 Autentikasi

Setiap permintaan harus menyertakan token autentikasi:

Authorization: Bearer <token>

---

📥 Request Body

{
  "product_id": 27,
  "product_number": "43453454334",
  "reff_id": "1234567890"
}

Parameter

Parameter	Tipe	Wajib	Deskripsi
product_id	integer	Ya	ID dari produk detail (nominal)
product_number	string	Ya	Nomor pelanggan tujuan (HP, meteran, ID game)
reff_id	string	Ya	ID unik referensi transaksi dari sistem Anda

---

📤 Response Sukses

{
  "status": "ok",
  "message": "Pembelian INDOSAT 5.000 Promo ke nomor 0858657881363 sukses. Harga 5895",
  "transaksi": {
    "trans_id": 1714043927,
    "reff_id": "112267",
    "tanggal": "2025-06-23 16:53:50",
    "product_id": 24,
    "admin_fee": null,
    "product_name": "INDOSAT",
    "product_detail": "INDOSAT 5.000 Promo",
    "harga": 5895,
    "kode_unik": null,
    "payment": "E-Wallet",
    "no_pelanggan": "0858657881363",
    "no_hp_pelanggan": null,
    "expired_date": null,
    "note": "Dummy note produk",
    "token": "1111111111111223333212",
    "status": "Completed",
    "status_id": 4,
    "status_color": "#4a90e2",
    "pembayaran": {
      "bank": "E-Wallet",
      "name": null,
      "payment_id": 13,
      "image_url": "https://cdn.bisatopup.co.id/images/wallet.png"
    }
  },
  "response_code": "00"
}

Penjelasan Field Utama

Field	Tipe	Deskripsi
status	string	Status respon (ok jika sukses)
message	string	Informasi ringkas status transaksi
trans_id	integer	ID transaksi yang dikeluarkan oleh sistem
reff_id	string	ID referensi yang dikirim oleh pengguna
product_detail	string	Nama detail produk PPOB
harga	integer	Harga transaksi dalam rupiah
token	string	Token/kode isi ulang (jika berlaku)
status	string	Status transaksi (Completed, dll)

---

❌ Response Gagal

{
  "status": "failed",
  "message": "Transaksi sudah pernah dilakukan, status : Failed.",
  "response_code": "13"
}

Catatan:

• Simpan trans_id dan reff_id untuk kebutuhan pelacakan atau pengecekan ulang.
• Gunakan endpoint Cek Status Transaksi jika belum ada callback setelah beberapa saat.
• Pastikan reff_id unik untuk setiap transaksi agar tidak terjadi duplikasi.

Lanjutkan ke dokumentasi berikutnya untuk mengecek status transaksi dan memproses callback dari sistem.