ahmadzakiyox GitHub avatar

gopay-api-gateaway

ahmadzakiyox

A self-hosted Node.js API gateway for GoPay/GoFood merchants that enables dynamic QRIS generation, real-time payment checking, and auto-refresh token management via OTP login.

Stars

107

7-day growth

No data

Forks

37

Open issues

0

License

MIT

Last updated

2026-07-25

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a complete, self-hosted payment gateway for Indonesian GoBiz merchants with OTP-based login, automatic token refresh, and a QRIS EMVCo parser for generating custom nominal QR codes — all without relying on official GoPay APIs or third-party services.

Who it is for

  • Indonesian GoPay/GoFood merchants who want to integrate dynamic QRIS payments into their online store
  • Developers building payment systems for e-commerce platforms (PHP/Laravel/Node.js) needing a self-hosted solution
  • VPS or cPanel hosting users looking for a ready-to-deploy Node.js payment gateway
  • Users familiar with Indonesian payment ecosystems (QRIS, GoPay) who prefer data sovereignty

Use cases

  • Generate a unique QRIS code for each customer order with a fixed amount and 5-minute expiry
  • Automatically verify incoming payments by matching amount and transaction ID to prevent duplicate claims
  • Retrieve transaction history for reconciliation or reporting in a specified time range
  • Integrate the gateway into existing web stores via simple GET/POST calls with API key authentication

Strengths

  • One-time OTP login with automatic token refresh every 6 hours, eliminating manual re-authentication
  • Unique trx_id per generated QRIS prevents double-claiming even if two payments have the same amount
  • Supports multiple deployment environments: VPS, cPanel, Docker, and Pterodactyl with detailed guides
  • Public payment status endpoint that can be used in frontend UI without exposing the API key

Considerations

  • Requires a 24/7 VPS or similar persistent storage hosting – does not work on serverless platforms like Render Free or Vercel
  • Not an official GoPay product; aggressive polling may lead to account restrictions, and use is at own risk
  • Only compatible with GoPay/GoFood merchant accounts; merchant ID and static QRIS must be obtained from the GoBiz app

README quick start

GoPay Merchant Gateway

 

API Gateway self-hosted berbasis Node.js untuk otomatisasi cek transaksi dan cetak QRIS dinamis dari akun GoPay / GoFood Merchant kamu.


[!NOTE] 💬 HUBUNGI OWNER & BERGABUNG CHANNEL:

[!TIP] 📣 PENGUMUMAN & UPDATE TERBARU: Sistem Login OTP Terminal & Auto-Refresh Token Gateway ini sekarang menggunakan sistem autentikasi OTP Terminal (node login.js). Kamu tidak perlu lagi copy-paste cookie browser atau memasukkan password. Cukup masukkan nomor HP GoBiz & kode OTP 1 kali saja — token akan tersimpan dan otomatis di-refresh oleh server di background setiap 6 jam tanpa perlu login ulang!

[!CAUTION] 🚨 PERSYARATAN DEPLOYMENT (VPS / cPanel / Pterodactyl Panel) Gateway ini dapat di-deploy di VPS, cPanel Hosting, maupun Pterodactyl Panel (Node.js Egg v18.x/v20.x) yang memiliki penyimpanan permanen 24/7. DILARANG MENGGUNAKAN HOSTING SERVERLESS GRATISAN (seperti Render Free, Vercel, Netlify) karena container akan sleep dan menghapus file sesi (.GOPAY_SESI_JANGAN_DIHAPUS.json), yang mengakibatkan sesi hangus dan harus login OTP ulang.

[!WARNING] ⚠️ DISCLAIMER PROYEK TIDAK RESMI: Project ini tidak berafiliasi dengan PT GoTo Gojek Tokopedia Tbk / GoPay. Gunakan dengan bijak. Polling yang terlalu agresif bisa memicu pembatasan akun. Risiko ditanggung pengguna sepenuhnya. Seluruh data berjalan 100% aman di server Anda sendiri tanpa dikirim ke pihak ketiga.


✨ Fitur Utama

  • 🔐 Login OTP Terminal — Login resmi via SMS/WA (node login.js) menggunakan nomor HP GoBiz.
  • 🔄 Auto-Refresh Token (Set-and-Forget) — Token diperbarui otomatis di background. Login cukup 1 kali saja.
  • 🧾 QRIS Dinamis (EMVCo) — Generate QRIS nominal custom dari QRIS statis merchant secara lokal dengan parser EMVCo presisi tinggi (CRC16).
  • 📱 Halaman Checkout QRIS Interaktif — UI web modern siap pakai dengan timer hitung mundur 5 menit, tombol cek manual anti-banned, & auto-polling opsional (8s).
  • Cek Pembayaran Real-Time — Cocokkan nominal + waktu transaksi secara otomatis. Setiap payment memiliki trx_id unik sehingga **dua payment nominal sama tidak akan saling kl

Description

API Gateway mandiri (Autonomous) berkinerja tinggi untuk memantau mutasi transaksi GoPay Merchant dan men-generate QRIS Dinamis (EMVCo) secara otomatis.

Related repositories

Similar projects matched by category, topics, and programming language.

react
Featured
react GitHub avatar

react

React is a JavaScript library for building user interfaces with declarative, component-based, and cross-platform design.

Web DevelopmentFrontend Frameworks
246,741
tandpfun
Featured
tandpfun GitHub avatar

wardrobe

A GPT‑image powered app that extracts individual garment cutouts from photos, organizes them into a digital wardrobe, and generates modeled outfit previews.

JavaScript
1,570
mshumer
Featured
mshumer GitHub avatar

Claude-of-Duty

A browser-based first-person shooter built entirely with procedural generation and orchestrated AI agents, featuring 55k lines of Three.js/WebGL2 code and no art assets.

AI & Machine LearningAI Agents
1,234