✨ Pengantar

Selamat datang di Dokumentasi API Resmi **Inkonter H2H Engine**. API ini menggunakan arsitektur RESTful murni dengan format respons berbasis **JSON**. Anda dapat mengintegrasikan API ini ke aplikasi kasir, web toko online, bot Telegram, atau server PPOB Anda sendiri.

Base URL Produksi
https://server.inkonter.com

🔒 Autentikasi JWT

Setiap permintaan ke API dilindungi oleh gembok **JSON Web Token (JWT)** demi menjaga keamanan saldo lokal Anda. Klien wajib menyertakan token rahasia yang didapatkan dari admin pada komponen HTTP Header Authorization.

Authorization: Bearer MASUKKAN_TOKEN_JWT_RAHASIA_ANDA

GET Cek Saldo Lokal Agen

Digunakan untuk mengambil info sisa saldo riil Anda yang terdaftar di database server kami.

Endpoint URL
/api/user/saldo
Contoh Request (cURL)
curl -X GET https://server.inkonter.com/api/user/saldo \
  -H "Authorization: Bearer TOKEN_ANDA"
Contoh Respons Sukses (JSON)
{
  "status": "sukses",
  "saldoLokal": 50000
}

POST Eksekusi Transaksi H2H

Gunakan rute ini untuk menembak pembelian pulsa, kuota data, e-wallet, atau voucher game.

Endpoint URL
/api/transaksi
JSON Body Parameter
{
  "kodeProduk": "SKU_PRODUK_PROD",
  "tujuan": "NOMOR_HP_PELANGGAN"
}
Struktur Parameter Tabel
Field Tipe Keterangan
kodeProduk String Kode SKU produk aktif (contoh: idyp115hr)
tujuan String Nomor Handphone, No Meteran, atau ID Game Pelanggan
Contoh Respons Sukses Diterima
{
  "status": "sukses",
  "pesan": "Pesanan Diteruskan ke Supplier"
}

📞 Callback Status (Webhook Klien)

Sistem kami mendukung pengiriman sinyal **Webhook** otomatis langsung ke server Anda sesaat setelah status transaksi berubah dari PENDING menjadi SUKSES atau GAGAL. Hubungi admin untuk mendaftarkan URL Callback aplikasi Anda.