gitwtfhub

wtf is gobiz-payment-v2?

rzkyyds/gobiz-payment-v2 — explained in plain English

Analysis updated 2026-05-18

17TypeScriptAudience · developerComplexity · 4/5Setup · hard

TL;DR

An unofficial QRIS payment gateway on Cloudflare Workers that detects GoPay and GoBiz payments via careful API polling, with a local React dashboard.

Mindmap

mindmap
  root((GoBiz Payment v2))
    What it does
      QRIS invoice generation
      GoBiz payment detection
      Webhook on paid
    Tech stack
      Cloudflare Workers
      Durable Objects
      React dashboard
    Use cases
      Merchant QRIS checkout
      On-demand polling
      Payment history dashboard
    Audience
      Indonesian merchants
      Backend developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Accept QRIS payments for an Indonesian merchant account without an official SDK

REASON 2

Auto-detect paid invoices by polling GoBiz payment history only when needed

REASON 3

Generate a unique-amount QRIS invoice and webhook customers on payment

REASON 4

Manage payment settings and history through a local dashboard

What's in the stack?

TypeScriptCloudflare WorkersDurable ObjectsReact

How it stacks up

rzkyyds/gobiz-payment-v25uck1ess/ciceroaaglexx/mcp-man
Stars171717
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardeasy
Complexity4/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Uses an unofficial internal GoBiz/GoPay API, automating login risks the merchant account being banned.

Wtf does this do

GoBiz Payment v2 is a payment gateway for Indonesia's QRIS payment system, built to run on Cloudflare Workers. It is based on an earlier project called gobiz-payment and works by watching a merchant's GoBiz or GoPay account through the same internal API the official app uses, rather than through any officially supported integration. The README is explicit that this is not an official Gojek or GoPay library, that automating login and polling this internal API carries a real risk of the account being banned or blocked, and that using it is entirely the user's own responsibility. The system is built around a Cloudflare Worker that exposes a REST API for creating payments, checking settings, and testing webhooks, backed by a Durable Object that stores invoices, session tokens, and settings, and manages an on demand alarm that only runs while there is an unpaid invoice waiting. When a customer starts a payment, the system generates a QRIS code and a unique expected amount without calling GoBiz at all. Only once an invoice is pending does it start checking GoBiz's payment history periodically, roughly every fifteen seconds with some added randomness, to look for a matching paid transaction, if there is nothing pending, no polling happens at all, which the project frames as its main defense against triggering anti-bot detection. Login to the GoBiz account itself is handled automatically using an email and password stored as secrets, with the resulting access and refresh tokens cached so the system prefers reusing or refreshing them over logging in again from scratch. A local dashboard, built separately with React, gives a visual interface for creating test invoices with their QR codes, browsing payment history, reading API documentation with code examples in several languages, and configuring settings like the webhook URL and polling behavior, which can then be pushed to the live Worker. Setup involves installing dependencies for both the Worker and the dashboard, filling in an environment file with the API key and GoBiz credentials, and running both parts locally for development. Deploying to production uses Cloudflare's wrangler tool to log in, set the required secrets, and deploy the Worker, after which the dashboard is pointed at the live Worker URL to finish configuration.

Yoink these prompts

Prompt 1
Help me set up gobiz-payment-v2 locally with .dev.vars and run the Worker plus dashboard.
Prompt 2
Explain how the on-demand polling and Durable Object alarm avoid triggering a GoBiz account ban.
Prompt 3
Show me how to create a QRIS invoice by calling POST /v1/payments with a unique amount.
Prompt 4
Walk me through deploying gobiz-payment-v2 to Cloudflare with wrangler and setting the required secrets.

Frequently asked questions

wtf is gobiz-payment-v2?

An unofficial QRIS payment gateway on Cloudflare Workers that detects GoPay and GoBiz payments via careful API polling, with a local React dashboard.

What language is gobiz-payment-v2 written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, Durable Objects.

How hard is gobiz-payment-v2 to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is gobiz-payment-v2 for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.