Panduan kriskris.

Lima bab dari konek GoBiz sampai callback. Ikuti berurutan atau lompat ke bab yang Anda butuhkan.

1. Konek GoBiz

Setiap merchant terhubung ke satu outlet GoBiz milik Anda. Uang pelanggan masuk ke rekening outlet itu.

  1. 1Buka halaman merchantMasuk ke dashboard, pilih merchant, buka tab GoBiz.
  2. 2Login akun GoBiz outletMasukkan nomor dan OTP outlet yang dipakai kasir.
  3. 3Pilih outletSatu merchant memakai satu outlet. Ganti kapan saja dari tab yang sama.

2. Terima bayar

Buat tagihan dari dashboard dalam tiga langkah. Cocok untuk kasir warung, toko, dan jasa.

  1. 1Buat tagihanIsi nominal dan label, misal Rp86.500 untuk Order 231.
  2. 2Tunjukkan QR ke pelangganSatu kode QRIS per tagihan, nominal sudah pasti.
  3. 3Status berubah lunas sendiriSistem mencocokkan pembayaran dalam hitungan detik.

3. Deposit

Deposit adalah saldo bersama untuk membayar langganan semua merchant di akun Anda.

  1. 1Buka halaman depositTekan Isi saldo, pilih nominal mulai Rp10.000.
  2. 2Bayar QR top upScan kode yang tampil sebelum kedaluwarsa 15 menit.
  3. 3Saldo terpakai otomatisTiap periode, sistem memotong sesuai paket tiap merchant.

4. API

Buat tagihan dari kode program. Contoh memakai path relatif dan host generik milik-Anda. Ganti api.milik-Anda dengan host milik Anda.

  1. 1Buat API keyDari tab Umum merchant. Key tampil sekali, simpan di server Anda.
  2. 2Kirim POST buat tagihanEndpoint relatif ke host milik-Anda, otentikasi header X-API-Key.

Permintaan

POST /api/v1/external/invoices
Host: api.milik-Anda
X-API-Key: MASUKKAN_KUNCI_ANDA
Content-Type: application/json

{
  "amount": 86500,
  "label": "Order 231"
}

Contoh curl

BASE_URL="ganti-dengan-host-milik-Anda"
curl -X POST "$BASE_URL/api/v1/external/invoices" \
  -H "X-API-Key: MASUKKAN_KUNCI_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"amount": 86500, "label": "Order 231"}'

Respons 201

{
  "ok": true,
  "data": {
    "id": "inv-8f3k2a",
    "status": "pending",
    "amount": 86500,
    "label": "Order 231",
    "qr_payload": "00020101021226610018ID.CO.QRIS.WWW01189360091100023456070215000000000023456070303UMI5204481453031505405865005802ID5914Warung Barokah6007Jakarta61051014062070703A016304A3F2",
    "expires_at": "2026-10-20T10:45:00Z"
  }
}

Tampilkan qr_payload sebagai kode QR ke pelanggan. Cek status berkala lewat GET /api/v1/external/invoices/inv-8f3k2a atau tunggu callback lunas.

5. Callback

Tiap tagihan lunas atau kedaluwarsa, server kami POST JSON ke callback URL merchant Anda.

  1. 1Set callback URLDari tab Umum merchant, isi alamat webhook di server Anda.
  2. 2Simpan secret sekali-tampilPakai untuk verifikasi tanda tangan tiap request.
  3. 3Kirim test.pingTekan tombol tes. Server Anda harus balas 2xx dalam 10 detik.

Contoh request invoice.paid

POST /webhook/kriskris
X-Kriskris-Event: invoice.paid
X-Kriskris-Delivery: 9f2c1a40-7b1e-4c9a-8d3f-2e6a5b4c7d81
X-Kriskris-Signature: 4f7a9c1e2b6d48f0a3c5e7d9b1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e
Content-Type: application/json

{
  "event": "invoice.paid",
  "delivery_id": "9f2c1a40-7b1e-4c9a-8d3f-2e6a5b4c7d81",
  "invoice_id": "inv-8f3k2a",
  "merchant_id": "m-7d2q",
  "amount": 86500,
  "label": "Order 231",
  "status": "paid",
  "paid_at": "2026-10-20T10:32:11Z"
}

Contoh request test.ping

POST /webhook/kriskris
X-Kriskris-Event: test.ping
X-Kriskris-Delivery: 1a2b3c40-9d8e-4f7a-8b6c-5d4e3f2a1b09

{
  "event": "test.ping",
  "delivery_id": "1a2b3c40-9d8e-4f7a-8b6c-5d4e3f2a1b09",
  "merchant_id": "m-7d2q",
  "ts": "2026-10-20T10:30:00Z"
}

Balas 2xx secepatnya. Di luar itu kami antre ulang dengan jeda mundur sampai batas coba habis.