Dokumentasi API

Ikhtisar

Base URL: https://pay.instanlive.id/api/v1. Semua permintaan & respons memakai JSON. Setiap respons memuat field ok (boolean).

Buat Transaksi

Contoh

curl -X POST https://pay.instanlive.id/api/v1/transaction/create \
  -H 'X-Api-Key: sk_test_xxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{"ref_id":"ORDER-123","amount":25000}'

Respons

{
  "ok": true,
  "data": {
    "txn_id": 12,
    "ref_id": "ORDER-123",
    "mode": "sandbox",
    "amount": 25000,
    "unique_amount": 25017,   // nominal yang HARUS dibayar
    "fee": 175,
    "net_amount": 24825,      // yang dikreditkan ke saldo
    "qris_string": "00020101021226...",
    "payment_url": "https://pay.instanlive.id/pay/xxxxxxxx",
    "status": "pending",
    "expired_in_minutes": 15,
    "simulate_url": "/api/v1/sandbox/pay/12"  // hanya sandbox
  }
}

Cara termudah: arahkan pelanggan ke payment_url (halaman bayar siap pakai). Atau render qris_string sebagai QR sendiri; pelanggan membayar sebesar unique_amount.

Cek Status

Panggil berkala dari halaman pembayaran (mis. tiap 3–5 detik). Untuk mode live, panggilan ini juga memicu pencocokan mutasi. Batas 300 permintaan/menit per API key (HTTP 429 bila terlampaui) — polling tiap 3–5 detik aman.

{
  "ok": true,
  "data": { "txn_id": 12, "status": "paid", "paid_at": "2026-08-17T01:29:49Z", ... }
}

Nilai status: pending, paid, expired, cancelled, refunded.

Daftar Transaksi

Mode (live/sandbox) mengikuti prefix API key. Respons: data berisi array transaksi + page, limit, count.

Refund

Refund transaksi berstatus paid: saldo dipotong sebesar net_amount, status berubah refunded, dan callback dikirim.

Simulasi Pembayaran SANDBOX

Hanya dengan key sk_test_. Menandai transaksi sandbox menjadi paid dan memicu callback — untuk menguji integrasi & webhook tanpa uang nyata.

curl -X POST https://pay.instanlive.id/api/v1/sandbox/pay/12 -H 'X-Api-Key: sk_test_xxxxxxxxxxxxxxxx'

Callback (Webhook)

Saat transaksi lunas/refund, kami kirim POST JSON ke callback URL Anda. Bila gagal, dikirim ulang otomatis dengan jeda bertahap.

{
  "txn_id": 12,
  "ref_id": "ORDER-123",
  "status": "paid",
  "amount": 25000,
  "net_amount": 24825,
  "is_sandbox": false,
  "paid_at": "2026-08-17T01:29:49Z",
  "signature": "9f2c…"
}

Verifikasi signature

Hitung HMAC-SHA256 dari payload TANPA field signature, dengan key diurut menaik, memakai API key Anda (sesuai mode). Bandingkan dengan field signature.

$data = json_decode(file_get_contents('php://input'), true);
$sig = $data['signature']; unset($data['signature']);
ksort($data);
$calc = hash_hmac('sha256', json_encode($data, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), $API_KEY);
if (hash_equals($calc, $sig)) { /* valid */ }

const crypto = require('crypto');
const { signature, ...data } = req.body;
const sorted = Object.keys(data).sort().reduce((o,k)=>(o[k]=data[k],o),{});
const calc = crypto.createHmac('sha256', API_KEY)
  .update(JSON.stringify(sorted)).digest('hex');
if (calc === signature) { /* valid */ }

Balas HTTP 200 untuk menandai diterima. Non-2xx akan dicoba ulang & tercatat di log callback.

Kode Error

Panduan Uji Sandbox

1. Gunakan sandbox key (sk_test_…) dari dashboard.
2. Buat transaksi via create.
3. Panggil sandbox/pay untuk menandai lunas → status jadi paid, callback terkirim, saldo sandbox bertambah.
4. Setelah cocok, ganti key ke sk_live_… tanpa mengubah kode.