Nigana Pay
Buka app
Dokumentasi API

Pengantar

Nigana Pay adalah REST API untuk membuat invoice QRIS dinamis dan menerima notifikasi saat lunas.

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
Contoh memakai domain https://pay.tokomu.id. Ganti dengan domain Pages milikmu.

Konsep dasar

  • Merchant adalah akun tokomu. Setiap merchant punya saldo, API key, dan webhook.
  • Invoice adalah satu tagihan dengan nominal tetap. Setiap invoice memiliki QR dan pay_url.
  • Saldo bertambah sebesar amount − fee saat invoice lunas.

Alur integrasi

  1. Buat API key di menu API Key pada dasbor.
  2. Dari server tokomu, panggil POST /api/invoices.
  3. Arahkan pelanggan ke pay_url.
  4. Terima webhook invoice.paid lalu verifikasi tanda tangannya.
  5. Cocokkan status dengan GET /api/invoices/{id}, baru kirim barang atau aktifkan layanan.

Format

  • Base URL: https://pay.tokomu.id/api
  • Request dan respons berformat JSON (Content-Type: application/json).
  • Nominal dalam rupiah, bilangan bulat tanpa desimal.
  • Waktu berupa Unix timestamp dalam detik (UTC).
  • Galat berbentuk { "error": "pesan" } dengan kode HTTP yang sesuai.

Endpoint yang tersedia untuk API key

MetodePathFungsi
POST/api/invoicesBuat invoice
GET/api/invoicesDaftar invoice
GET/api/invoices/{id}Ambil satu invoice
DELETE/api/invoices/{id}Batalkan invoice menunggu
GET/api/meProfil, saldo, batas
GET/api/ledgerMutasi saldo

Endpoint lain (kata sandi, PIN, penarikan, pembuatan API key, dan sebagainya) hanya dapat diakses dari sesi dasbor dan menjawab 403 bila dipanggil dengan API key.