Dokumentasi Teknis API & OtomaX H2H Center

Alamat Base URL Endpoint

Seluruh endpoint transaksi berjalan di atas base URL utama gateway. Untuk integrasi REST API, seluruh payload dikirim dengan metode POST dan header wajib Content-Type: application/json. Untuk modul OtomaX, request dikirim menggunakan metode HTTP GET dengan query parameter.

Otentikasi Kredensial & Signature

Sistem kami membedakan autentikasi sesuai dengan jalur yang Anda gunakan agar kompatibel dengan software server pulsa maupun backend website:

Ketentuan IP Server Whitelist

Sebagai perlindungan mutlak terhadap saldo akun Anda, sistem gateway backend memvalidasi IP pemanggil. Seluruh request dari API JSON maupun OtomaX hanya dilayani jika berasal dari IP publik yang telah didaftarkan di menu Integrasi dashboard.

Mengambil nominal saldo aktif yang tersedia pada akun reseller Anda secara real-time.

{
  "member_code": "doMS1FCRBgbH",
  "api_key": "apikeyxxxxxxxxxxxx",
  "sign": "38a4b2c1e7f9a8d2e5b1c4f6a7d9e8b0"
}

{
  "status": true,
  "msg": "Berhasil cek Saldo",
  "data": {
    "balance": 1500000
  }
}

Membuat tiket deposit saldo mitra melalui transfer bank dengan nominal acak unik otomatis.

{
  "member_code": "doMS1FCRBgbH",
  "api_key": "apikeyxxxxxxxxxxxx",
  "amount": 100000,
  "method": "BCA",
  "sign": "a91b2c3d4e5f60718293a4b5c6d7e8f9"
}

{
  "status": true,
  "msg": "Berhasil Topup Saldo",
  "data": {
    "invoice": "DEP20261021142551205",
    "bank": "BANK BCA",
    "amount": 100312,
    "norek": "1234567890",
    "an": "PT GATEWAY INDONESIA",
    "date_create": "2026-10-21T07:25:51.000Z"
  }
}

Mengambil katalog produk digital, kode SKU, brand, kategori, dan harga sesuai tier akun Anda.

{
  "member_code": "doMS1FCRBgbH",
  "api_key": "apikeyxxxxxxxxxxxx",
  "sign": "f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3"
}

{
  "status": true,
  "msg": "Berhasil mendapatkan data layanan",
  "data": [
    {
      "product": "Free Fire 5 Diamond",
      "category": "Games",
      "brand": "Free Fire",
      "type": "Diamonds",
      "price": 825,
      "code": "FF5",
      "status": "On"
    }
  ]
}

Mengeksekusi transaksi pembelian atau topup dengan proteksi race-condition dan validasi 3 lapis.

{
  "member_code": "doMS1FCRBgbH",
  "api_key": "apikeyxxxxxxxxxxxx",
  "ref_id": "ORDER-20261021001",
  "code": "FF5",
  "user_id": "662444522",
  "zone_id": "1",
  "sign": "2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f"
}

{
  "status": true,
  "msg": "Pesanan berhasil! Pesanan sedang diproses",
  "data": {
    "ref_id": "ORDER-20261021001",
    "product": "Free Fire 5 Diamond",
    "user_id": "662444522",
    "zone_id": "1",
    "status": "Processing",
    "note": "Pesanan sedang di proses."
  }
}

Mengecek status terkini transaksi beserta serial number (SN) berdasarkan ref_id pesanan.

{
  "member_code": "doMS1FCRBgbH",
  "api_key": "apikeyxxxxxxxxxxxx",
  "ref_id": "ORDER-20261021001",
  "sign": "d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0"
}

{
  "status": true,
  "msg": "Detail transaksi berhasil didapatkan",
  "data": {
    "ref_id": "ORDER-20261021001",
    "product": "Free Fire 5 Diamond",
    "user_id": "662444522",
    "zone_id": "",
    "status": "Success",
    "note": "kipli tzy/662444522/Free Fire 5 Diamond SN: 639012391"
  }
}

Daftar Respon Gagal (API JSON)

Format respon JSON standar yang dikembalikan oleh backend saat validasi payload gagal atau sistem menolak request.

{
  "status": false,
  "msg": "Api Key dan Member Code tidak boleh kosong"
}

{
  "status": false,
  "msg": "Api Key dan Member Code tidak valid"
}

{
  "status": false,
  "msg": "Signature Tidak Valid."
}

{
  "status": false,
  "msg": "ref_id sudah tersedia pada sistem kami"
}

{
  "status": false,
  "msg": "code tidak ditemukan atau sedang gangguan"
}

{
  "status": false,
  "msg": "Saldo anda tidak mencukupi"
}

{
  "status": false,
  "msg": "ref_id tidak ditemukan"
}

{
  "status": false,
  "msg": "Stok produk habis / tidak mencukupi"
}

{
  "status": false,
  "msg": "IP Anda tidak kami kenali: 125.1.xxxxxx"
}

Modul Standar OtomaX IP GET (membercode, pin, password)

Jalur transaksi untuk software server pulsa seperti OtomaX, IRS, Flash Machine, dll. Menggunakan autentikasi membercode + pin + password tanpa JSON, dengan balasan baris teks biasa (plaintext). Mendukung auto-inquiry status transaksi secara aman dan idempotent berdasarkan ref_id.

Format Respon Gagal IP / OtomaX

Balasan baris teks dari endpoint IP jika kredensial OtomaX salah, parameter tidak lengkap, atau transaksi ditolak.

GAGAL. Parameter tidak lengkap (membercode, pin, password, ref_id, produk, tujuan wajib diisi)

GAGAL. Member tidak valid

GAGAL. PIN atau Password OtomaX tidak valid

GAGAL. Kredensial PIN & Password OtomaX belum diatur di akun Anda

GAGAL. Produk tidak ditemukan atau tidak tersedia

GAGAL. Saldo tidak cukup

#Request TRX #TRX7536011291065731020. REFID#TRX99201. GAGAL, SN:Invalid ID. Harga:825. Saldo:1499175. KP:FF5.662444 Tanggal:21/10/2026 14.55.56

Webhook POST Callback (Real-Time)

Gateway mengirimkan notifikasi HTTP POST ke URL Webhook Anda saat status transaksi dari upstream berubah.

{
  "status": "Success",
  "message": "Transaksi Berhasil",
  "sn": "kipli tzy/662444522/Free Fire 5 Diamond",
  "ref_id": "ORDER-20261021001",
  "order_id": "API4092128335991436281",
  "produk": "FF5",
  "sisa_saldo": 1499175,
  "price": 825
}

{
  "status": "Cancelled",
  "message": "Transaksi Gagal",
  "sn": "Invalid ID",
  "ref_id": "ORDER-20261021001",
  "order_id": "API4092128335991436281",
  "produk": "FF5",
  "sisa_saldo": 1500000,
  "price": 825
}

Report Transaksi IP / OtomaX (GET Callback)

Report dikirim via HTTP GET request ke URL Report IP yang Anda konfigurasikan di menu Integrasi.