SDK Node.js · JavaScript · TypeScript

Pasang QRIS otomatis di aplikasi Node.js-mu, tanpa payment gateway

SDK Node.js NotivGo membungkus API NotivGo menjadi beberapa baris kode: buat QR bernominal dari QRIS tokomu sendiri, lalu tanyakan status pesanan sampai lunas. Uang pembeli masuk langsung ke rekeningmu. NotivGo bukan payment gateway: uang pembeli tidak lewat NotivGo.

Versi 0.2.0 · 37 KB · Node.js 18+ · tanpa dependensi

npm install https://notivgo.com/unduh/notivgo-0.2.0.tgz

Contoh singkat

import { Client, orderState } from 'notivgo';

const notivgo = new Client(process.env.NOTIVGO_API_KEY);

// 1. Buat QR bernominal + pesanan yang dipantau
const qr = await notivgo.generate({
  order_ref: 'INV-1001',
  amount: 150000,
  create_order: true,
  expires_in: 1800,
});
console.log(qr.qris_payload);   // jadikan gambar QR di halamanmu

// 2. Tanyakan statusnya (ulangi tiap beberapa detik)
const pesanan = await notivgo.getOrder('INV-1001');
if (orderState(pesanan, 150000) === 'paid') {
  // tandai pesanan lunas di sistemmu
}

Contoh di atas memakai ES Modules. Di CommonJS, ganti baris pertama dengan const { Client, orderState } = require('notivgo');

Yang ada di dalamnya

• Klien API: buat QR bernominal; buat, baca, batalkan, dan daftar pesanan.
• Pembantu kode unik: memilih nominal yang belum dipakai pesanan lain, supaya pembayaran dikenali otomatis.
• Verifikasi tanda tangan webhook (HMAC) dalam satu baris, termasuk balasan yang benar saat jam server meleset.
• Contoh siap salin: penerima webhook untuk Node.js polos dan Express.
• Contoh bot Telegram jualan otomatis untuk produk digital.
• Tanpa dependensi: cukup Node.js 18 ke atas. Bisa dipakai dari CommonJS, ES Modules, dan TypeScript.

Contoh bot Telegram jualan otomatis

Di dalam paket ada contoh bot Telegram untuk menjual produk digital seperti voucher, kode lisensi, atau tautan unduhan. Pembeli memilih produk di obrolan, bot mengirim kode QR dengan nominal unik, dan sesudah pembayaran terbaca bot mengirim barangnya ke obrolan itu.

1. Buat bot di Telegram lewat @BotFather, lalu salin tokennya.
2. Pasang SDK, lalu buat folder toko: node node_modules/notivgo/contoh/bot-telegram/bot.js --buat toko
3. Isi setelan.json (token bot dan kunci API NotivGo), daftar produk di produk.json, dan stok di folder stok.
4. Jalankan: node node_modules/notivgo/contoh/bot-telegram/bot.js --toko toko

Barang hanya dikirim bila pesanan lunas dengan nominal yang tepat. Pesanan yang perlu diperiksa dikabarkan ke obrolan admin. Panduan lengkapnya ada di README contoh itu.

Yang perlu disiapkan

• Akun NotivGo dan kunci API dari portal.
• QRIS toko yang sudah disimpan di portal NotivGo.
• HP Android dengan aplikasi NotivGo, yang menerima notifikasi bank atau e-wallet toko.
• Pencocokan Pembayaran menyala dan Paket App Pembayaran (atau masa cobanya) aktif.

Cara pasang

1. Di folder proyekmu, jalankan npm install https://notivgo.com/unduh/notivgo-0.2.0.tgz
2. Simpan kunci API dari portal NotivGo (Pengaturan → Developer → Kunci API) di variabel lingkungan NOTIVGO_API_KEY, jangan di dalam kode.
3. Muat SDK dengan require('notivgo') atau import dari 'notivgo'. Tipe TypeScript sudah ikut di dalam paket.
4. Ikuti README di node_modules/notivgo. Contoh siap salin ada di folder contoh.

Yang perlu kamu tahu

• SDK ini alat bantu mencocokkan pembayaran, bukan penjamin pembayaran. Keputusan akhir dan pemeriksaan mutasi tetap di tanganmu.
• Bedakan nominal tiap pesanan yang masih terbuka dengan kode unik; pembantunya sudah ada di SDK. Dua pesanan bernominal sama tidak dilunaskan otomatis; keduanya ditandai perlu ditinjau di portal.
• Selalu isi batas waktu (expires_in) supaya pesanan lama tidak tercocokkan dengan uang masuk yang datang jauh kemudian.
• Jangan mengirim nama, alamat, email, atau nomor HP pembeli di order_ref maupun note. NotivGo hanya butuh nomor pesanan dan nominal.

Tanya jawab

Berkas: notivgo-0.2.0.tgz · sha256 938106e19f5716275bc703d3cbb223d9b0cfeeab11ad31b2a6068543d8807b77 · Lisensi MIT