youpi-pg/YouPI-PG

选用指南

AI 根据 README 整理 · 2026/10/18 19:11:16

适用场景

适用于在线销售和线下零售柜台场景，支持 UPI 二维码、现金和银行卡支付。

查看 README 依据

- **Online Selling Mode:** UPI Vector QR + Cash on Delivery (COD) with customer pre-purchase verification and decoupled address lifecycle. - **Offline Store Counter Mode:** Designed for physical retail stores. Supports UPI QR, Cash at Till (`CASH_COUNTER`), and Card at POS Terminal (`CARD_COUNTER`) with an interactive real-time cashier till dock and instant SSE customer approval. ### 7. 🎨 100% White-Label Customizer Rebrand the checkout portal completely through the Merchant Admin Panel: - Custom app name, logo URL, and browser favicon.

使用方式

通过 npm 安装依赖并启动，提供控制中心、商户管理面板、演示商店、支付 API 和客户结账门户等 Web 服务。

查看 README 依据

### 2. Configure Environment ```bash cp .env.example .env ``` *(The default `.env` is pre-configured for localhost out of the box).* ### 3. Zero-Config Launch (Auto-Initialized SQLite) On first launch, YOUPI PG automatically provisions `data/youpi_pg.sqlite`, creates the directory if missing, and executes idempotent migrations and baseline seeds. No manual database setup is required: ```bash npm run dev # or npm start ``` That's it! Your entire gateway cluster will spin up: - 🎛️ **Control Center Supervisor:** [`http://localhost:8090`](http://localhost:8090)

- 📊 **Merchant Admin Panel:** [`http://localhost:6001`](http://localhost:6001) - 🛒 **YOUPI Showcase Demo Store:** [`http://localhost:5000`](http://localhost:5000) - ⚡ **Payment REST API:** [`http://localhost:6100`](http://localhost:6100) - 💳 **Customer Checkout Portal:** [`http://localhost:7000`](http://localhost:7000) ### 4. Run the Full Regression Test Suite Verify all **31 test suites** across packages, apps, and chaos harnesses: ```bash npm test ``` ```text ============================================================ 🧪 YOUPI PG V2 — FULL REGRESSION TEST RUNNER

部署要求

需要 Node.js 20.0.0 或更高版本 LTS，以及标准 Linux 或 Windows 主机，无需 Docker 或外部数据库服务。

查看 README 依据

- `/order-expired` — 5-minute session elapsed, slot released for queued customers. - `/order-cancelled` — Customer cancelled checkout session. <br/> --- ## ⚡ Quickstart in 60 Seconds ### Prerequisites - **Node.js `>= 20.0.0` LTS** (`node -v`) - Standard Linux or Windows host - *No Docker or external database services required!* ### 1. Clone & Install Dependencies Standard `npm install` works out-of-the-box across all packages and apps without any protocol issues: ```bash git clone https://github.com/gxurav1710/YouPI-PG.git youpi-pg cd youpi-pg npm install ```

已知限制

由于标准 UPI 提醒不携带商户元数据，同一 VPA 同时只能有一个客户支付，其他买家需排队等待。

查看 README 依据

Because standard UPI alerts do not carry arbitrary merchant metadata, multiple concurrent transactions with identical amounts could create attribution confusion. YOUPI PG solves this with a mathematical invariant: - **Only ONE customer can pay on a VPA at a time.** - Other buyers wait in a database-backed FIFO queue with live position streaming. - Guarantees **100% exact payment matching** with zero payment mismatch errors! ### 4. 📱 Native Android Observer APK (`com.youpi.observer`) A lightweight, battery-optimized Android foreground service that captures: