Nigana Pay
Buka app
Dokumentasi API

Sandbox dan mode demo

Uji seluruh alur tanpa uang sungguhan.

Daftar dokumentasi

Mulai

PengantarQuickstartAutentikasiSandbox dan mode demo

Invoice QRIS

Buat invoiceAmbil, daftar, batalkanSiklus status invoice

Saldo dan notifikasi

Profil, saldo, mutasiWebhook

Referensi

Kode error dan batas lajuContoh kodeFAQChangelog

Mode layanan

Mode ditentukan variabel lingkungan PROVIDER (sandbox atau gateway) dan dikembalikan oleh GET /api/health serta GET /api/me pada field mode, bernilai sandbox, live (untuk PROVIDER=gateway), atau invalid bila salah konfigurasi.

ModePerilaku
sandboxQR bersifat simulasi. Halaman bayar menampilkan tombol simulasi pembayaran. Cocok untuk pengembangan dan praktik.
liveTerhubung ke gateway QRIS sungguhan lewat GATEWAY_URL dan GATEWAY_API_KEY. Tombol simulasi dinonaktifkan.

Simulasi pembayaran

POST/api/pay/{id}/simulate

Tanpa autentikasi, hanya berfungsi bila mode sandbox. Di mode lain jawabannya 403. Endpoint ini memicu alur pelunasan yang sama dengan pembayaran sungguhan, termasuk saldo, mutasi, dan webhook.

curl -X POST https://pay.tokomu.id/api/pay/9f2c1a7b3e5d8a41c0b2/simulate
# {"settled": true}

Mode demo di browser

Tambahkan ?demo=1 pada URL dasbor, misalnya app/welcome.html?demo=1. Seluruh API dipalsukan di browser dengan data contoh, tanpa server.

  • PIN demo: 123456.
  • Token admin demo: demo (di admin.html?demo=1).
  • Data tersimpan di localStorage browser dan dapat direset dengan menghapus data situs.
Mode demo hanya untuk presentasi tampilan. Untuk menguji integrasi API sungguhan, gunakan mode sandbox di server.