Skip to content

A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.

JavaScript

Merge PR #97: docs update ARCHITECTURE and DEPLOYMENT guides for dynamic branding architecture

rishabh13d15cd040fb
diff --cc apps/checkout-portal/src/views/checkout.html
index fc60af5,14f5b9a..5ee1d84
--- a/apps/checkout-portal/src/views/checkout.html
+++ b/apps/checkout-portal/src/views/checkout.html
@@@ -1977,17 -1960,10 +1977,18 @@@
codApiBox.style.display = 'block';
codApiUrl.textContent = `${API_BASE}/api/v1/orders/${data.orderId}/cod`;
}
+ } else if (data.status === 'OBSERVED_SUCCESS') {
+ if (titleEl) titleEl.textContent = 'Payment observed';
+ if (descEl) descEl.textContent = 'A bank alert matched this payment. It is not confirmed against a bank statement yet.';
+ if (codApiBox) codApiBox.style.display = 'none';
+ } else if (data.status === 'RECONCILED') {
+ if (titleEl) titleEl.textContent = 'Payment reconciled';
+ if (descEl) descEl.textContent = 'This payment was matched to a bank statement.';
+ if (codApiBox) codApiBox.style.display = 'none';
} else {
if (titleEl) titleEl.textContent = 'Payment Successful!';
- if (descEl) descEl.textContent = 'Your payment was automatically verified by YouPI PG banking observers.';
+ const activeAppName = state?.branding?.appName || '{{APP_NAME}}' || 'YouPI PG';
+ if (descEl) descEl.textContent = `Your payment was automatically verified by ${activeAppName} banking observers.`;
if (codApiBox) codApiBox.style.display = 'none';
}
diff --cc apps/merchant-admin/src/views/admin.html
index e33b3d6,a56ebc7..373e351
--- a/apps/merchant-admin/src/views/admin.html
+++ b/apps/merchant-admin/src/views/admin.html
@@@ -4890,9 -4804,8 +4890,9 @@@
setVal('settingBusinessName', mData.businessName);
setVal('settingWebhookUrl', mData.webhookUrl);
setVal('settingWebhookSecret', mData.webhookSecret);
+ renderMerchantCredentials(mData);
- setVal('settingAppName', branding.appName || 'YOUPI PG');
+ setVal('settingAppName', branding.appName || '{{APP_NAME}}' || 'YOUPI PG');
setVal('settingLogoUrl', branding.logoUrl);
setVal('settingSidebarNotice', branding.sidebarNotice);
setVal('settingFooterGuarantee', branding.footerGuarantee);
diff --cc docs/DEPLOYMENT.md
index 90166c8,73ea854..561b53b
--- a/docs/DEPLOYMENT.md
+++ b/docs/DEPLOYMENT.md
@@@ -82,23 -99,8 +97,24 @@@ Starts services in background daemon mo
## 4. Production Domain & SSL (Cloudflare / NGINX)
For production deployment:
+
1. Terminate SSL at your reverse proxy (NGINX, Caddy, or Cloudflare Tunnel).
2. Point your public domain (e.g. `pay.yourdomain.com`) to port `7000` (Checkout Portal) or `6100` (Payment API).
- *The Checkout Portal automatically proxies all `/api/*` requests to the Payment API.*
+ _The Checkout Portal automatically proxies all `/api/_` requests to the Payment API.\*
3. Update `BASE_PAYMENT_API_URL` and `BASE_CHECKOUT_URL` in `.env` to match your public HTTPS domain.
+## Vercel Services
+
+The root `vercel.json` defines the approved multi-service deployment. Public
+traffic is routed to `/` (checkout), `/api/*` (payment API), `/admin/*`
+(merchant admin), `/help/*` (payment help), and `/store/*` (coin wallet store).
+The control center, Gmail observer, and SMS observer remain internal services.
+
+Service-to-service URLs are injected by Vercel bindings at runtime. The
+application reads `PAYMENT_API_URL`, `CHECKOUT_PORTAL_URL`,
+`CONTROL_CENTER_URL`, `GMAIL_OBSERVER_URL`, and `SMS_OBSERVER_URL`; these are
+binding variables and must not be manually configured with deployment URLs.
+
+Vercel Services is currently beta. The native deployment still remains the
+recommended production target for the SQLite-backed gateway and its long-lived
+observer processes; a Vercel deployment must use a persistent database and
+separate worker strategy before handling production payment traffic.