# Kiges

> Kiges.cc is a SaaS platform for branded short links, dynamic QR codes, bio pages, smart redirects, and campaign analytics. It provides tracking, geo-routing, conversion goals, behavioral analytics, and a public API for link management and payment integration.

## Platform Overview

Kiges.cc is a comprehensive marketing infrastructure platform that combines URL shortening, QR code generation, bio page building, and campaign analytics into a single SaaS workspace. The platform is designed for teams that need branded, trackable, and intelligent redirect campaigns across digital and offline channels.

### Architecture

- **Frontend**: React (Inertia.js) with TypeScript, Tailwind CSS, and shadcn/ui components
- **Backend**: Laravel (PHP) with MySQL database and Redis cache
- **Authentication**: Kiges ID OAuth (centralized identity provider at id.kiges.cc)
- **Billing**: Kiges Pay (centralized payment system at pay.kiges.cc)
- **AI**: OpenRouter integration for AI-powered bio page design and content generation
- **Localization**: Multi-language support with locale-based routing and translation management

### Core Capabilities

- **Tracking Links**: Branded short URLs with custom domains, Smart Link rules, UTM tagging, click analytics, expiration controls, health monitoring, A/B testing, and campaign-ready routing
- **Dynamic QR Codes**: Editable QR campaigns with scan analytics, regional routing, batch generation, and print-ready exports (PNG/SVG)
- **Bio Pages**: Link-in-bio landing pages with drag-and-drop blocks, lead capture forms, funnel analytics, custom domains, multi-language translations, and AI design assistance
- **Smart Redirects**: Geo-targeting, device routing, language-based redirects, localized CTAs, and regional QR campaigns from a single entry point
- **Campaign Analytics**: Real-time dashboards, conversion goals, tracking pixels, behavioral heatmaps, traffic intelligence, bot detection, and exportable reports

## Feature Pages

### Tracking Links

URL: https://kiges.cc/en/features/tracking-links

Create branded short URLs with Smart Link rules, UTM tagging, click analytics, expiration controls, health monitoring, and campaign-ready routing in one SaaS workspace.

**Key points:**
- Branded short links with custom domains, slugs, tags, and collections
- Smart Link targeting for country, device, language, campaign, and A/B paths
- Real-time clicks, conversions, health checks, anomalies, and exportable reports

**Capabilities:**
- **Branded short links**: Create clean short URLs with custom domains, memorable slugs, tags, folders, and bulk workflows.
- **Smart Link rules**: Route clicks by country, language, device, schedule, password, A/B branch, or campaign logic.
- **Campaign tagging**: Add UTM parameters, tagging rules, dependencies, and collections so every link stays organized.
- **Monitoring and alerts**: Track link health, traffic spikes, anomalies, expired links, and recovery options before campaigns break.

**FAQs:**
- **Q: What is a tracking link?** — A: A tracking link is a short, branded URL that records click data and can route visitors based on rules such as device, country, language, schedule, or campaign source.
- **Q: Can I use my own domain for short links?** — A: Yes. Branded domains let teams share links that match their brand instead of sending traffic through a generic shortener.
- **Q: Can tracking links support campaigns and reporting?** — A: Yes. Links can be grouped, tagged, exported, monitored, and tied to conversion goals so campaign performance stays measurable.

**Integrations:** Custom domains, UTM builder, A/B destinations, Bulk link creation, Health monitoring, CSV exports

---

### Dynamic QR Codes

URL: https://kiges.cc/en/features/dynamic-qr-codes

Build QR codes for online and offline campaigns, update destinations after publishing, export print-ready assets, and measure every scan inside the same analytics layer as your links.

**Key points:**
- Editable QR destinations for printed materials, events, stores, and launches
- Scan analytics by country, device, campaign, referrer, and time period
- Regional QR campaigns that send each market to the right destination

**Capabilities:**
- **Dynamic QR builder**: Create branded QR codes connected to short links, campaigns, and editable destinations.
- **Regional QR routing**: Send scans to localized destinations by country, campaign, or market without printing new codes.
- **Scan analytics**: Measure scan volume, location, devices, referrers, and conversion paths from one dashboard.
- **Batch workflows**: Generate, export, and manage multiple QR codes for product lines, events, or field teams.

**FAQs:**
- **Q: What makes a QR code dynamic?** — A: A dynamic QR code points to a managed redirect, so you can change the final destination later while the printed QR code stays the same.
- **Q: Can QR scans be tracked?** — A: Yes. Scans can be measured with time, device, country, campaign, and conversion context.
- **Q: Can one QR campaign send users to different pages?** — A: Yes. Regional and smart routing can send scans to different destinations based on geography, language, device, or campaign rules.

**Integrations:** Short links, Regional QR, Bulk export, Campaign reports, Geo heatmaps, Conversion goals

---

### Bio Pages

URL: https://kiges.cc/en/features/bio-pages

Launch beautiful bio pages with custom blocks, links, forms, embeds, translations, lead capture, funnel analytics, and custom-domain branding for every campaign or creator.

**Key points:**
- Drag-and-drop bio pages with blocks, links, forms, media, CTAs, and branding
- Public bio URLs on your own domain with SEO and social sharing controls
- Real-time clicks, geography, funnel steps, leads, and translation management

**Capabilities:**
- **Visual bio editor**: Create polished public pages with configurable blocks, ordering, themes, backgrounds, and social links.
- **Brand control**: Use custom domains, colors, previews, SEO metadata, and public sharing assets for each page.
- **Lead capture**: Collect intent from visitors with forms, CTA clicks, funnel events, and audience-ready analytics.
- **Bio translations**: Publish translated bio pages and localized blocks for campaigns that cross markets.

**FAQs:**
- **Q: What is a bio page?** — A: A bio page is a public link-in-bio landing page where a creator, brand, or campaign can collect links, calls to action, media, forms, and analytics in one place.
- **Q: Can bio pages use custom domains?** — A: Yes. Bio pages can be published with branded domains so profile traffic lands on a page that looks and feels owned by your brand.
- **Q: Can I track what visitors do on a bio page?** — A: Yes. Bio pages can track views, block clicks, funnel steps, geography, leads, and real-time activity.

**Integrations:** Custom domains, Lead capture, Bio translations, Funnel tracking, Public CTA buttons, Real-time analytics

---

### Smart Redirects

URL: https://kiges.cc/en/features/smart-redirects

Build redirect logic for countries, languages, devices, campaigns, localized CTAs, regional QR codes, and geo-aware journeys without multiplying landing pages.

**Key points:**
- Route visitors by country, language, device, schedule, campaign, or fallback rules
- Localize bio pages, CTAs, QR destinations, and country-specific campaign paths
- Use geo heatmaps and country analytics to understand where traffic is moving

**Capabilities:**
- **Geo routing**: Send visitors to country, region, or market-specific destinations from the same public link.
- **Device targeting**: Route iOS, Android, desktop, and tablet visitors to destinations that fit their context.
- **Language redirects**: Create localized journeys for pages, CTAs, and campaigns without duplicating every entry point.
- **Geo heatmaps**: See where clicks and scans concentrate so localization decisions are based on real traffic.

**FAQs:**
- **Q: What is a smart redirect?** — A: A smart redirect sends visitors to different destinations based on context such as country, language, device, campaign, schedule, or fallback rules.
- **Q: Can smart redirects work with QR codes?** — A: Yes. QR scans can use regional and smart routing so the same QR code can serve different destinations by market or device.
- **Q: Can I use smart redirects for localization?** — A: Yes. Language redirects, bio translations, localized CTAs, and country campaigns help the same campaign feel native across markets.

**Integrations:** Language redirects, Regional QR, Localized CTAs, Country campaigns, Geo heatmaps, Device rules

---

### Campaign Analytics

URL: https://kiges.cc/en/features/campaign-analytics

Unify real-time analytics, conversion goals, tracking pixels, behavioral heatmaps, traffic intelligence, reports, and exports across every branded link, QR code, and bio page.

**Key points:**
- Real-time dashboards for clicks, scans, conversions, locations, devices, and referrers
- Tracking pixels, conversion goals, behavioral analytics, heatmaps, and funnel views
- Reports, exports, campaign ROI, engagement scores, and shared dashboards

**Capabilities:**
- **Click and scan analytics**: Measure every tracked link, QR scan, bio block click, referrer, location, and device.
- **Conversion goals**: Track signups, purchases, lead events, CTA clicks, or custom goals from public campaigns.
- **Traffic intelligence**: Detect bots, anomalies, trending links, traffic alerts, and quality signals before reports drift.
- **Behavioral insight**: Use heatmaps, recordings, funnels, and engagement scores to learn what visitors actually do.

**FAQs:**
- **Q: What can campaign analytics track?** — A: Campaign analytics can track link clicks, QR scans, bio page views, block clicks, conversion goals, tracking pixels, locations, devices, referrers, behavior, and reports.
- **Q: Can I track conversions from public campaigns?** — A: Yes. Conversion goals and tracking pixel events can connect public campaign traffic to signups, leads, purchases, or custom actions.
- **Q: Can analytics detect low-quality traffic?** — A: Yes. Traffic intelligence, bot detection, anomalies, and alerts help separate useful campaign traffic from noise.

**Integrations:** Real-time analytics, Conversion goals, Tracking pixels, Heatmaps, Bot detection, Shared reports

---

### Developer API

URL: https://kiges.cc/en/features/api

Connect Kiges to your stack with API keys, documented REST endpoints, webhook events, and bulk operations — the same capabilities available in the dashboard, ready for CRM, CMS, and custom integrations.

**Key points:**
- Create and manage API keys for apps, scripts, and partner systems
- REST endpoints for links, QR codes, bio pages, campaigns, and analytics
- Webhooks so your systems can react when campaign events happen

**Capabilities:**
- **API key management**: Generate, name, and revoke keys so every integration has clear ownership and access control.
- **REST endpoints**: Create and manage short links, QR codes, bio pages, campaigns, and related resources from documented endpoints.
- **Webhooks**: Send campaign, click, lead, and system events into CRM, analytics, and internal automation tools.
- **Automation flows**: Bulk-create assets, sync campaign state, and connect Kiges to CMS, ecommerce, and partner systems.

**FAQs:**
- **Q: What can I build with the Kiges API?** — A: You can create and manage short links, QR codes, bio pages, campaigns, and related assets, then connect analytics and automation into your own stack.
- **Q: How does API authentication work?** — A: Integrations authenticate with API keys. Generate a key in the product, send it with your requests, and revoke it any time you need to rotate access.
- **Q: Can the API power automations and partner workflows?** — A: Yes. Use the API for bulk jobs, CRM or CMS sync, partner provisioning, and webhook-driven reactions when campaign events happen.

**Integrations:** API keys, REST docs, Webhooks, Bulk operations, Bearer auth, Partner systems

---

### Barcodes

URL: https://kiges.cc/en/features/barcodes

Generate standards-ready barcodes for products, warehouses, packages, and print runs — with live design controls, batch generation, SVG/PNG/PDF exports, print sheets, and templates built for production teams.

**Key points:**
- Standards-ready barcodes for products, inventory, packaging, and logistics
- Batch generation, templates, frames, and live design controls for print teams
- Export SVG, PNG, PDF, ZIP packs, and cut-guide print sheets without redesigning

**Capabilities:**
- **Barcode studio**: Design product and logistics barcodes with live preview, frames, symbology controls, and brand-ready styling.
- **Batch generation**: Create many barcodes at once from pasted lists, CSV imports, or shared design settings.
- **Print-ready exports**: Download SVG, PNG, PDF, ZIP archives, and cut-guide sheets for packaging and warehouse print runs.
- **Templates and frames**: Reuse production templates so every SKU, carton, or shelf label stays consistent across teams.

**FAQs:**
- **Q: What are barcodes used for in Kiges?** — A: Barcodes help teams create print-ready product, inventory, packaging, and logistics labels that can be designed, batched, exported, and managed in one workspace.
- **Q: Can I generate barcodes in bulk?** — A: Yes. Batch generation supports large runs with shared design settings, pasted lists, and CSV import so production teams do not recreate each code manually.
- **Q: Which export formats are supported?** — A: Teams can export barcodes as SVG, PNG, PDF, ZIP archives, and print sheets with cut guides for packaging and warehouse workflows.

**Integrations:** Batch create, CSV import, Templates, SVG export, PDF sheets, ZIP packs

---

### CTA Overlays

URL: https://kiges.cc/en/features/cta-overlays

Engage visitors with configurable overlays — notifications, polls, lead forms, modals, announcement bars, slide-ins, full-page takeovers, and social proof — with triggers, styling, multilingual content, and response analytics.

**Key points:**
- Overlays for notifications, polls, forms, modals, bars, slide-ins, and full-page CTAs
- Triggers, styling, positions, and multilingual content controlled from one builder
- Impressions, clicks, conversion rates, and response capture for every campaign

**Capabilities:**
- **Multi-format overlays**: Launch notifications, polls, forms, modals, bars, slide-ins, full-page takeovers, and social proof widgets.
- **Trigger control**: Decide when overlays appear with timing, scroll, interaction, and campaign rules that fit the journey.
- **Multilingual CTAs**: Translate overlay copy and serve the right language automatically so global campaigns feel local.
- **Response analytics**: Measure impressions, clicks, conversion rate, and captured responses for every overlay campaign.

**FAQs:**
- **Q: What is a CTA overlay?** — A: A CTA overlay is an on-page campaign layer — such as a popup, bar, form, poll, or social proof widget — designed to capture attention, intent, or leads without rebuilding the whole page.
- **Q: Can CTA overlays collect leads and survey answers?** — A: Yes. Form and poll overlays can capture visitor responses while other formats drive clicks, announcements, and social proof.
- **Q: Can overlays be translated for different languages?** — A: Yes. Overlay content can be translated and auto-matched to visitor language so the same campaign works across markets.

**Integrations:** Lead forms, Polls, Social proof, Multilingual CTAs, Trigger rules, Response analytics

---

### Viral Features

URL: https://kiges.cc/en/features/viral-features

Attach modules to short links — share-to-unlock, countdown gates, referral tools, floating banners, exit-intent offers, retargeting pixels, click rewards, and campaign landing pages — and measure interactions from the same workspace.

**Key points:**
- Modules for interstitials, on-page engagement, referrals, and tracking
- Share-to-unlock, countdown gates, exit intent, rewards, and campaign landers
- Attach a feature pack to a short link and review interactions and conversion

**Capabilities:**
- **Share-to-unlock**: Require a social share before visitors reach the destination, when that fits the campaign.
- **Interstitials and gates**: Use countdown gates, campaign landers, exit-intent offers, and promo layers before the redirect.
- **Rewards and referrals**: Add click rewards, referral mechanics, and engagement layers for return visits.
- **Retargeting and analytics**: Add pixels, track interactions, and review conversion for the modules you enable.

**FAQs:**
- **Q: What are viral features?** — A: Viral features are modules you can attach to short links — such as share-to-unlock, countdown gates, referral tools, exit-intent offers, rewards, and retargeting pixels — to support distribution and conversion campaigns.
- **Q: How are viral features different from CTA overlays?** — A: CTA overlays focus on on-page layers like forms, polls, and announcements. Viral features are packs for short-link campaigns: unlocks, referrals, interstitials, rewards, and tracking modules.
- **Q: Can I attach viral features to an existing short link?** — A: Yes. Create a feature pack, attach it to a short link, enable the modules you want, and review interactions and conversion from the same workspace.

**Integrations:** Share unlock, Countdown gates, Referral loops, Exit intent, Retargeting pixels, Click rewards

---

## API Documentation

URL: https://kiges.cc/api/docs

Kiges.cc provides a REST API for programmatic access to link management, payment processing, and tracking features. All API endpoints are prefixed with `/api/v1/` or `/api/external/`.

### Link API (`/api/v1/links`)

- **Authentication**: Bearer token (API key)
- `GET /api/v1/links` — List all links for the authenticated organization
- `POST /api/v1/links` — Create a new short link
- `POST /api/v1/links/bulk` — Create multiple short links in one request
- `GET /api/v1/links/{link}` — Get details of a specific link
- `PUT/PATCH /api/v1/links/{link}` — Update a link
- `DELETE /api/v1/links/{link}` — Delete a link
- `GET /api/v1/links/{link}/analytics` — Get analytics for a specific link

### External Payment API (`/api/external`)

- **Authentication**: API key
- `POST /api/external/checkout/sessions` — Create a checkout session
- `GET /api/external/checkout/sessions/{id}` — Get a checkout session
- `POST /api/external/checkout/sessions/{id}/expire` — Expire a checkout session
- `GET /api/external/products` — List available products
- `GET /api/external/products/{id}` — Get a specific product
- `POST /api/external/customers` — Create a customer
- `GET /api/external/customers/{id}` — Get a customer
- `GET /api/external/subscriptions` — List subscriptions
- `GET /api/external/subscriptions/{id}` — Get a subscription
- `POST /api/external/subscriptions/{id}/cancel` — Cancel a subscription
- `POST /api/external/subscriptions/{id}/resume` — Resume a cancelled subscription
- `GET /api/external/invoices` — List invoices
- `GET /api/external/invoices/{number}` — Get an invoice
- `GET /api/external/payment-methods` — List payment methods
- `POST /api/external/webhooks/verify` — Verify a webhook signature

### Public Tracking Endpoints (no auth required)

- `GET /{code}` — Short link redirect (resolves code and 302-redirects to destination)
- `GET /qr/{qrId}/scan` — QR code scan handler
- `GET /rqr/{code}` — Regional QR scan handler with geo-routing
- `GET /c/{goal}` — Conversion tracking pixel
- `POST /api/conversions/track` — Server-side conversion event
- `POST /api/behavioral/track` — Behavioral event tracking
- `POST /api/behavioral/track-batch` — Batch behavioral event tracking
- `GET /api/viral/{id}/config` — Viral feature configuration
- `POST /api/viral/{id}/interaction` — Viral feature interaction
- `POST /api/cta/{id}/impression` — CTA overlay impression
- `POST /api/cta/{id}/click` — CTA overlay click
- `POST /api/cta/{id}/convert` — CTA overlay conversion
- `POST /api/cta/{id}/respond` — CTA overlay form response
- `GET /api/localized-cta/{id}` — Resolve localized CTA
- `GET /api/widgets` — Get widgets for a domain
- `POST /api/widgets/track` — Track widget event
- `POST /api/widgets/submit` — Submit widget form (lead capture)
- `GET /api/widgets/loader.js` — Widget loader script
- `GET /api/widgets/embed/{publicId}` — Individual widget embed script
- `GET /api/abtests` — Get active A/B tests and assign visitor to variants
- `POST /api/abtests/convert` — Track A/B test conversion
- `GET /api/abtests/variant` — Get visitor assigned variant
- `POST /api/visitors/init` — Initialize visitor profile
- `POST /api/visitors/identify` — Identify visitor with personal info
- `POST /api/visitors/track` — Track visitor event
- `POST /api/visitors/personalize` — Get personalized content
- `POST /api/visitors/segments` — Check segment membership

### Webhooks

- `POST /api/webhooks/kiges-id` — Kiges ID user profile change notifications
- `POST /api/webhooks/kiges-pay` — Kiges Pay checkout and subscription lifecycle events
- `POST /api/webhooks/{gateway}` — Universal payment gateway webhook handler
- Supported gateways: yookassa, stripe, paypal, mollie, paddle, razorpay, paystack, payu, mercadopago, midtrans, iyzico, flutterwave, lemonsqueezy, myfatoorah, klarna, coinbase, plisio, revolut, crypto_com

## Authentication

Kiges.cc uses Kiges ID as its sole authentication provider via OAuth 2.0:

- `GET /login` — Displays the login page (redirects to Kiges ID authorization)
- `GET /register` — Displays the registration page (same as login via Kiges ID)
- `GET /auth/kiges/redirect` — Redirects browser to Kiges ID authorization endpoint
- `GET /auth/kiges/callback` — OAuth callback handler (receives code + state)
- `POST /logout` — Logs out of this SaaS application
- `POST /logout-everywhere` — Logs out of this SaaS AND Kiges ID (ends central session)

## Public Bio Pages

URL pattern: https://kiges.cc/bio/{slug}

Public bio pages are link-in-bio landing pages accessible without authentication. They support:

- Custom blocks (links, media, CTAs, forms)
- Click tracking per block
- Funnel event tracking
- Lead capture form submission
- Checkout integration for product purchases
- Multi-language translations
- Custom domains and branding

## Public Checkout

URL: https://kiges.cc/pay

Public checkout routes handle payment sessions for external site integrations:

- `GET /pay/quick` — Quick checkout (create session and redirect)
- `GET /pay/product/{product}` — Product-specific checkout
- `GET /pay/{session}` — Display checkout page for a session
- `POST /pay/{session}` — Process payment for a session
- `GET /pay/{session}/complete` — Payment gateway return handler
- `GET /pay/{session}/success` — Success page
- `GET /pay/{session}/cancel` — Cancel page

## Localization

The platform supports multiple languages with locale-based routing:

- `GET /{locale}` — Localized home page (e.g., /en, /de, /ar)
- Available locales are discovered from `resources/lang/` directories
- Locale priority: explicit `?lang=` param > session > user preference > Accept-Language negotiation > app fallback