# Super App

<figure><img src="/files/JwbICpch4VxsKq4gZ58i" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Overview</mark>

PayWithCrypto Super App is the all-in-one digital command center for spending, earning, and engaging with crypto in everyday life. Designed with a dual-wallet system — non-custodial for users, custodial for merchants — it unifies everything under one seamless experience: POS hardware, Soft POS for mobile merchants, crypto debit cards, NFT loyalty, AR gamification, and the powerful APC  Rewards engine.

Technically, the Super App sits on a robust multi-chain backend that routes transactions across Ethereum, BNB Smart Chain, Tron, and more — with real-time settlement, smart contract-based loyalty payouts, and compliance-ready fiat ramps through regulated VASPs and payment gateways.

Designed for both consumers and merchants, the app enables seamless, QR-code-based crypto transactions, built on a foundation of non-custodial architecture and regulatory compliance. Both End Users and Registered Merchants can enjoy a seamless user interface, enhanced by gamified experiences that drive engagement, retention, and real-world crypto utility.

### <mark style="color:blue;">**User Utilities & Everyday Benefits**</mark>

PayWithCrypto gives everyday users:

* Scan-to-Pay: Spend crypto instantly at local merchants by scanning national QR codes (QR Ph, VietQR, Thai PromptPay).
* Crypto Card: Pay anywhere Visa/Mastercard is accepted — online or offline — with your crypto balance.
* Non-Custodial Wallet: Self-custody keys for maximum security.
* On/Off Ramp: Buy crypto with local fiat or cash out earnings anytime via licensed VASPs and banking rails.
* Token Swaps: Swap tokens instantly using an in-app DEX aggregator with gas fee estimates.
* P2P Transfers: Send crypto to friends using @handles — no confusing wallet addresses.
* PayWithCrypto Cares Charity: Support verified causes with crypto donations and earn extra APC InfinityPoints.
* DApp Browser: Access DeFi, NFT marketplaces, or other Web3 dApps right inside the wallet.
* AR Gamification: Play PayWithCrypto Monster Hunt — catch monsters at merchant locations for rewards
* Travel: Book your flights and hotels through partners without leaving the app
* E-Sim: Buy your ESim conveniently with just a tap on your screen.&#x20;

### &#x20;<mark style="color:blue;">**Merchant Tools**</mark>

* Vouchers & Gift Cards: Issue or redeem merchant-branded vouchers and gift cards, increasing loyalty and repeat visits.
* NFT Loyalty Programs: Merchants can issue NFTs representing discounts or privileges (e.g., Coffee Shop NFT), encouraging ongoing engagement.
* Mini-Programs: Host lightweight merchant-specific apps within the PayWithCrypto Super App (e.g., food ordering, service bookings).
* POS Integration: Custodial wallets allow merchants to track transaction history, receive payments, and view fiat settlements in real time.

### <mark style="color:blue;">**Gamification Engine**</mark>

Gamification is core to PayWithCrypto's user engagement model, blending game mechanics with real-world financial utility.

·         APC Points: Users earn points from actions like wallet transactions, travel bookings, and participation in AR games. Points are redeemable for gas discounts, exclusive NFTs, and merchant vouchers.

·         Levels & Badges: Users progress from "Crypto Novice" to "Super User," earning titles and badges such as "Travel Pro" or "Monster Hunter."

·         Challenges: Weekly and monthly missions (e.g., "Catch 3 monsters this week") encourage repeated engagement with the app.

·         Leaderboards: Role-specific rankings allow End Users to compete for point totals and Merchants to rank based on POS volume.

·         AR Game (Monster Hunt): A flagship feature, this AR experience places monsters at merchant locations, incentivizing real-world visits and turning payments into a playful, rewarding journey.

> ### &#x20;     *<mark style="color:$primary;">One Scan. One App. Endless Rewards.</mark>*

&#x20;

### &#x20;**Role-Based Experiences**

* End Users: Access all wallet, travel, utility, and gaming features, with an intuitive interface optimized for convenience and discovery.
* Merchants: Switch roles to manage business-specific features like POS, voucher issuance, and sponsored monster placement—all from the same app.

### <mark style="color:blue;">**Architecture Overview**</mark>

* Mobile App Interface: Bottom-tab navigation includes Dashboard, Wallet, Merchants, Vouchers, and Settings. The UI adapts based on user role.
* Wallet Module: Supports both non-custodial (user-controlled) and custodial (merchant-managed) wallets.
* Backend Server: Manages services for Gaming, Travel, Social, NFT, POS, Utilities, Authentication, and Gamification using JWT-based role logic.
* Indexer Layer: Optimizes performance by caching data like monster locations, point transactions, and voucher statuses.
* Blockchain Nodes: Uses Infura and Alchemy to handle token transfers, NFT minting, and smart contract interactions.

### <mark style="color:blue;">**Why**</mark> <mark style="color:blue;">PayWithCrypto</mark> <mark style="color:blue;">**Super App?**</mark>

PayWithCrypto differentiates itself by blending the versatility of crypto wallets with a rich lifestyle ecosystem. It creates seamless interactions between users and merchants through:

* Real-time QR code payments
* NFT-based loyalty programs
* AR-powered merchant discovery
* Token rewards and competitive gamification
* Scalable, user-friendly architecture

Whether you're booking a flight, grabbing coffee, or catching a monster, PayWithCrypto turns every interaction into an opportunity for value, rewards, and community connection.

### <mark style="color:blue;">**Core Features and Benefits Summary**</mark>

| Feature                     | Description                                                                         |
| --------------------------- | ----------------------------------------------------------------------------------- |
| Scan to Pay                 | Instantly pay by scanning QR codes at partner merchants.                            |
| Non-Custodial Architecture  | Full control of private keys—ensuring user sovereignty and security.                |
| Multi-Chain Support         | Pay using stablecoins and crypto assets across Ethereum, BNB Chain, Tron, and more. |
| Loyalty Rewards             | Earn tokenized cashback and merchant rewards with every purchase.                   |
| Merchant Discounts          | Access exclusive discounts and bundled deals from participating businesses.         |
| Low Fees, Fast Transactions | Near-instant settlement and ultra-low on-chain transaction costs.                   |
| Referral Rewards            | Invite others and earn token-based rewards, growing the ecosystem organically.      |
| Exclusive Vouchers          | Collect and redeem merchant-issued vouchers with real-world value.                  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://paywithcrypto-1.gitbook.io/paywithcrypto/10.-paywithcrypto-infrastructure/super-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
