SDK PHP · Laravel · CodeIgniter 4

Pasang QRIS otomatis di aplikasi PHP-mu, tanpa payment gateway

SDK PHP 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 · 36 KB · PHP 7.4+ · butuh ekstensi cURL dan JSON

Contoh singkat

require __DIR__ . '/notivgo-php/autoload.php';

$notivgo = new NotivGo\Client(getenv('NOTIVGO_API_KEY'));

// 1. Buat QR bernominal + pesanan yang dipantau
$qr = $notivgo->generate([
    'order_ref'    => 'INV-1001',
    'amount'       => 150000,
    'create_order' => true,
    'expires_in'   => 1800,
]);
echo $qr['qris_payload'];   // jadikan gambar QR di halamanmu

// 2. Tanyakan statusnya (ulangi tiap beberapa detik, atau lewat cron)
if ($notivgo->isPaid('INV-1001')) {
    // tandai pesanan lunas di sistemmu
}

Yang ada di dalamnya

• Klien API: buat QR bernominal; buat, baca, batalkan, dan daftar pesanan.
• Verifikasi tanda tangan webhook (HMAC) dalam satu baris, termasuk balasan yang benar saat jam server meleset.
• Integrasi Laravel: service provider, facade NotivGo, dan middleware notivgo.signature.
• Contoh siap salin untuk PHP polos, Laravel, dan CodeIgniter 4.
• Tanpa dependensi tambahan: cukup PHP 7.4 ke atas dengan cURL. Bisa dipakai tanpa Composer.

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. Unduh berkas zip dari halaman ini, lalu ekstrak. Hasilnya satu folder notivgo-php.
2. Salin folder itu ke proyekmu, lalu muat dengan require 'notivgo-php/autoload.php'; — atau daftarkan foldernya sebagai repositori path di Composer.
3. Simpan kunci API dari portal NotivGo (Pengaturan → Developer → Kunci API) di variabel lingkungan NOTIVGO_API_KEY, jangan di dalam kode.
4. Ikuti README di dalam zip. Contoh PHP polos, Laravel, dan CodeIgniter 4 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, misalnya dengan menambah 1–3 digit unik. 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-php.zip · versi 0.2.0 · sha256 b9740441d371b8cb02c69fb1c524819b3b237b898535967e0ae8f9bc884db760 · Lisensi MIT