Nigana Pay
Buka app
Dokumentasi API

Autentikasi

Server-ke-server memakai header X-API-Key. Dasbor memakai cookie sesi.

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

Header X-API-Key

Sertakan API key di setiap permintaan:

X-API-Key: ngp_xxxxxxxxxxxxxxxx
  • Key berawalan ngp_. Yang tersimpan hanya hash SHA-256, sehingga key tidak bisa dilihat lagi setelah dibuat.
  • Satu akun dapat memiliki sampai 10 key aktif. Cabut key lewat dasbor kapan saja, efeknya seketika.
  • Tiap key memberi akses ke endpoint invoice, GET /api/me, dan GET /api/ledger.
Jangan menaruh API key di aplikasi mobile, JavaScript browser, atau repositori publik. Panggil Nigana Pay dari server milikmu.

Respons autentikasi

KodeArti
401API key tidak ada, salah, atau sudah dicabut
403Endpoint hanya untuk sesi dasbor
429Terlalu banyak API key salah dari IP yang sama (20 kegagalan per 10 menit)

Sesi dasbor

Dasbor memakai cookie HttpOnly; Secure; SameSite=Strict yang berlaku 7 hari. Permintaan pengubah dari sesi harus berasal dari origin yang sama. Kamu tidak perlu mengurus ini bila hanya memakai API key.

Cek cepat

curl https://pay.tokomu.id/api/me -H "X-API-Key: ngp_xxxxxxxxxxxxxxxx"