Back to Shop ERP
Shop-customer loop locked

FAEDA Shops And Customers: QR Receipts, Loyalty, Roznamcha, Family Wallet, And Privacy

The loop that turns a local shop transaction into a useful customer record: bill, points, dues, purchase history, family spending, delivery proof, and feedback without forcing full app adoption.

Core guardrail

Shop-to-customer links are drafts until confirmed. Family wallet, health context, phone disclosure, and aid review must be consented and auditable.

QR scan

Customer scans shop wall or bill QR and confirms the link.

FAEDA Lite / SMS

No-app customers receive receipt, points, offer, and due reminders.

Roznamcha link

Shop ledger and family ledger stay connected through confirmed receipts.

Family wallet

Purchases and loyalty sync to household view only with consent.

Customer types inside a shop
Frequent buyer

Loyalty offers, repeat bundles, LES points, and early offer drafts.

Debtor

Roznamcha dues, repayment reminders, dispute status, and risk prompts.

Walk-in buyer

Scans QR, saves receipt, starts lightweight profile.

Delivery buyer

Receipt linked to rider proof, home delivery, and family sync where allowed.

Family proxy

Child, elder, helper, or relative buying for a household.

Offline buyer

Paper QR/SMS receipt waits for sync.

Smart receipt preview
MADINA KIRYANA - FAEDA Connected
Bill: FK-2026-00018
Customer: Iqbal Family (confirmed)
Flour 5kg ........ Rs. 820
Sugar 1kg ........ Rs. 210
Tea 250g ......... Rs. 430
Paid: Cash
Points earned: 14
Family Roznamcha: Synced
Scan QR: full bill, reorder, feedback, privacy
Customer benefits engine
Loyalty Points

Earn points from confirmed purchases and approved campaigns.

LES Learning Coins

Useful post-purchase lessons can unlock transparent rewards.

Offers And Promos

Permitted buyers can receive shop offers with opt-out control.

Purchase History

Customers see previous items and can repeat useful purchases.

Safety Check

Health or food warnings stay advisory, consented, and policy-gated.

Family Roznamcha

Track expenses across connected shops with household permission.

Interaction modes
Scan-to-Sync

Scan QR on wall or bill, then confirm shop link.

App Order

Customer pre-orders, shop sees list before packing.

Bill Share

SMS/WhatsApp/app bill includes points, Roznamcha, and reminder links.

Delivery Receipt

Receipt includes loyalty, invoice, rider proof, and optional family sync.

Feedback Sync

Verified feedback updates Zonal Shop Health after moderation.

Offline QR Slip

Paper QR/token syncs when connection returns.

Protection, privacy, and aid rules
Household ID Lock

Family linking requires consent and role permission.

Phone Privacy

Shop does not see phone unless customer permits disclosure.

Aid Review Only

Purchase signals can create review drafts, not automatic poverty labels.

Data Transparency

Bills and app explain why FAEDA asks for data.

Ethical Offers

No junk manipulation or hidden targeting of vulnerable buyers.

Health Gate

Health warnings use only consented context and approved product rules.

Shop panel view
My Buyers

Linked customers from QR, app, bill, Roznamcha, delivery, or SMS.

Top Spenders

Most active permitted buyers and loyalty draft targets.

Most Frequent

Repeat patterns, favorite products, and approved discount suggestions.

Due View

Dues, repayment plan, reminders, and dispute state.

Family View

Purchases tied to family wallet or Roznamcha where consented.

Feedback View

Verified reviews, complaints, and shop-health impact.

Customer view
My Receipts

Bills from FAEDA shops by shop, date, and family member.

My Points

Loyalty points, earned rewards, expiry, and redemption rules.

My Dues

What is owed, what was paid, and dispute link.

My Offers

Approved shop offers and opt-out controls.

My Privacy

Phone sharing, family sync, health context, and SMS preferences.

My Feedback

Reviews submitted, complaint status, and shop response.

Realtime sync safeguards
Idempotency

Every shop event needs sourceEventId so offline retries cannot double-post a bill.

Offline Batch

Offline, mesh, and SMS sync should include offlineBatchId for conflict resolution.

Draft Downstream

Family Roznamcha, loyalty, aid, and health actions remain drafts until approved.

Consent Scopes

Family, loyalty, SMS, health, and aid review each require explicit consent scope.

No Auto Aid Label

Purchase data can trigger only a review draft, never a hardship label.

Non-Diagnostic Health

Product warnings are advisory and never become treatment instructions.

LES Urdu micro-videos
Aapka Bill Kya Kehta Hai?
1 coin

After purchase

QR receipt, points, reorder, feedback, dispute.

Points Kaise Milte Hain?
1 coin

Third shop visit

Loyalty points and clear reward rules.

Ghar Ka Kharacha Dekhna
2 coins

Family linked

Family wallet and approval drafts.

Cometti Kya Hai?
0 coins

Low-spend review

Support review without labeling hardship.

Meetha Kam, Sehat Zyada
1 coin

Sweet/snack overuse

Guardian-friendly snack reminder.

QR Scan Karna Seekhain
1 coin

First visit

Elder-friendly QR scan tutorial.

Example flow
1

Son buys flour from Madina Kiryana

2

Shop prints bill with FAEDA QR

3

Customer scans and confirms family link

4

Family Roznamcha gets purchase draft

5

Loyalty points are added after sale confirmation

6

LES suggests a useful flour storage lesson

7

Customer can reorder, give feedback, or manage privacy

Realtime sync API sketch
POST
/sync/customer-activity
Core sync: receipt, purchase history, loyalty draft, family Roznamcha draft.
GET
/sync/les-micro-videos
Return Urdu micro-video templates by trigger, role, and language.
POST
/sync/smart-qr-receipt-preview
Build printer/digital receipt lines, QR payload, LES link, and privacy actions.
POST
/sync/admin/les-videos
Create admin LES upload draft with zone, language, trigger, reward, and review gates.
GET
/sync/kiosk-config
Return shop tablet kiosk panels, mini LES station settings, and voice LES content.
POST
/sync/kid-snack/purchase-preview
Preview kid snack sale, consent gates, family snack draft, and ethical LES.
POST
/shops/:shopId/customers/link-draft
Create scan or bill-based customer link draft.
POST
/shops/:shopId/customers/:customerId/consents
Capture shop, phone, family, or health consent.
GET
/shops/:shopId/customers
List linked buyers with scope-safe fields.
POST
/shops/:shopId/receipts
Create bill, QR, SMS, and WhatsApp receipt record.
POST
/shops/:shopId/loyalty/events
Record loyalty points from confirmed sale.
POST
/shops/:shopId/customer-offers/draft
Create approved offer draft for permitted buyers.
Development lock

This layer is locked as a planning prototype. It does not create live customer links, send SMS, assign aid, or expose phone numbers. Every sensitive action remains draft-first, consent-gated, and auditable.

QR receipt scan actions
Receipt View

Open full bill by short QR without exposing phone or family details.

LES Tip

Play the matched Urdu/local micro-video with optional reward.

Points

Show earned or pending loyalty points with expiry rules.

Share

Send receipt by WhatsApp/SMS/app link with masked identifiers.

Family Draft

Show Roznamcha draft only when household consent exists.

Return

Start return/refund request from the verified receipt.

Admin LES upload lock
Zone Access

Target city, town, mohallah, shop type, and language.

Buyer Type

Customer, parent, elder, child guardian, or shopkeeper.

Trigger

After purchase, first visit, third visit, family linked, snack overuse.

Review Flags

Health, finance, faith, child, legal, or advertising review.

Offline Bundle

Allow kiosk/station cache only with expiry and version.

Reward Rules

Coins, limits, expiry, and anti-abuse checks shown clearly.

Shop tablet + LES station
Shop tablet

Public counter device for scan, points, LES, returns, and app invite.

Mini LES station

Idle screen or wall display for productive waiting time.

Voice LES

Audio-first lessons for elders, low-literacy users, and regional dialects.

Session safety

QR/OTP access, no full account control, auto-clear after 60 seconds.