User Guide — City Offers

🌟 What Is City Offers?

This guide is translated from Arabic for your convenience; if anything differs, the Arabic version prevails.

City Offers is a game in your real city. Scattered across the city map are Boxes containing discount Coupons from shops near you, Coins (the game's currency), and XP that raises your level.

The Idea in Three Steps

Walk to a Box near you — you see it through your phone's camera.
Open it when you get close, after a short, fun game.
Redeem the Coupon at the shop: show its code to the cashier, who scans it.

Opening Boxes is always free, and you never need to buy anything to win.

What You Need

A phone with a camera, a compass, and location services (GPS).
A Saudi mobile number.
To be 18 or older.
An internet connection.

📲 Signing Up and Signing In

Enter your mobile number (it starts with 5) and tap "Send Verification Code".
You receive a code by text message — enter it on the next screen.
You do not need a password. Your number is your account.

After you sign in for the first time, a screen with checkboxes appears:

"I am 18 or older"
"I have read and agree to the Terms and Conditions" — tap "Read the Terms" to read them.
"I have read the Privacy Policy…" — tap "Read the Privacy Policy".
"I would like notifications about offers and Events" — optional, and you can change it later.

Check the first three boxes, then tap "Agree and Continue". If we make an important change to the Terms, this screen will appear again so that you can accept the new version.

On the "One Last Step" screen, enter:

Username: the name others see (3 to 24 characters).
Date of birth and gender: players and Merchants cannot see them; we use them to show you the offers suited to your group.

Then tap "Start Now".

If you have already linked an email to your account (see Recovery Email), tap "I lost my mobile number" on the sign-in screen and sign in with your email and password, then change your number from Account Settings.

Your account works on one active device at a time. If you sign in on another device, the first device is signed out and shows the message "Your account was opened on another device". For your protection, you cannot go back to the previous device until two hours have passed.

🧭 A Tour of the App

At the bottom of the screen there are five buttons:

Profile: your photo, level, Rank, friends, Badges, Quests, and Daily Login.
Wallet: your balance, "My Coupons", and "My Items".
Camera: this is where you play — you see the Boxes around you and open them.
Store: buy Radars and Treasure Keys with Coins.
Chats: private chats with your friends, and the public Rooms.

At the top of the "Profile" screen: the bell for notifications, friend requests, and the gear for Settings.

📦 Boxes: How to Find and Open Them

Where Do I Find Boxes?

Open the "Camera" tab and hold your phone up in front of you: nearby Boxes appear over what you see.
You can see a Box from about 50 meters away. The Radar extends this (see The Radar).
At the top, the screen tells you how many Boxes are around you.
The mini radar in the corner of the screen shows you the direction of the Boxes; the red mark on it is north. Tap it to enlarge it.

Can't see any Boxes? Move around a little, and make sure location is enabled with high accuracy on your phone. There may also be no offers in your area right now.

Map Mode

Hold your phone flat and the camera turns into a map showing the Boxes around you. If you tap a distant Box, you can request a walking route to it.

How Do I Open a Box?

Get within about 30 meters of the Box — the screen tells you how far away you are.
The Box drops in front of you: tap it on the ground to open it.
A short game appears — complete it to open the Box.
Your reward appears: a Coupon, Coins, or XP.

The Opening Game

A variety of quick games: catch, pop, stop the pointer, remember the order, draw the path, balance by tilting your phone, and more.
Easy, and just for fun. If you don't succeed, it tells you "So close!" and you can try again after three seconds, or tap "Later".
The game does not change what is in the Box — your reward is set in advance.
You won't get the same game too often.

The Treasure Key

If you have a Treasure Key, an "Open with Key" button appears and lets you skip the game straight away — in regular Boxes only. The Key saves you time and does not change the reward. You buy it in the Store with Coins.

Regular, Rare, and Legendary Boxes

Regular: for everyone, including all shop Boxes.
Rare: start appearing for you from the Gold Rank.
Legendary: for the Diamond Rank, after passing the Legendary Box Gate.

The higher the rarity, the more XP and Coins you get.

"This Box isn't aimed at you"

Some Merchants aim their offer at a specific group by age or gender, so it cannot be opened by others. You will find other Boxes aimed at you.

A 24-Hour Wait for the Same Shop

After you open a Box from a shop, you wait 24 hours before you can open another Box from the same shop, so that the offer reaches as many people as possible. Boxes from other shops are available to you right now.

For Platform and Event Boxes: you open one Box of each rarity, then you can open that rarity again after 24 hours.

"We couldn't verify your location" and Other Messages

"We couldn't verify your location": you opened two Boxes far apart from each other in too short a time to walk between them. Wait a little.
"Weak location signal": go out to an open space, or wait until your GPS improves.
"Get closer": you are still outside opening distance.
"You've already opened this Box": each Box can be opened once per player.
"This Box has run out": it has been opened the number of times its owner set.
Fake-location apps are prohibited; openings are refused when they are used, and prizes obtained with them may be cancelled.

Don't Play While Driving

If you are moving at car speed (more than about 25 km/h), the camera stops and the "Don't play while driving" screen appears; the game comes back when you stop or walk. If you are a passenger, not the driver, tap "I'm a passenger" and then "I confirm I'm a passenger".

"Nearby Boxes" Alerts

An optional feature that alerts you to a Box near you, even when the App is closed.

Settings → Notifications → turn on "Nearby Boxes".
Read the explanation and allow the App to use your location "Always".

You receive at most three alerts per hour, and you are never alerted about the same Box twice. On some phones (Xiaomi, Huawei, Samsung), the App may need an exception from "battery saving" for the alerts to work reliably.

📡 The Radar and the Rarity Scanner

The Radar

Extends the distance from which you see Boxes: 100, 250, or 500 meters instead of 50, for half an hour or an hour.
It does not reveal what is in a Box or its rarity, and it does not replace getting within 30 meters to open it.
The color of the mini radar in the camera changes according to the type of Radar that is active, and its range is shown.

How Do I Activate It?

Buy it in the Store → "Items" with Coins.
Go to Wallet → "My Items" and tap "Activate".
It starts working immediately and shows the time remaining.

The Rarity Scanner

A special Item that distinguishes Rare and Legendary Boxes from the regular ones around you. It is not sold or bought — you receive it as a Rank reward — once, when you reach each Rank:

Gold: 10 minutes.
Platinum: 20 minutes.
Diamond: 30 minutes.

You will find it in Wallet → "My Items", and you choose when and where to use it. It does not reveal anything your Rank does not allow you to see. And it is yours alone: it cannot be gifted or thrown into Rooms.

🎟️ Coupons

Where Do I Find My Coupons?

In Wallet → "My Coupons". A Coupon appears as soon as you get it. Tap the card to open it and you will see:

The QR code and the written code below it.
The type of offer: a percentage discount, a purchase voucher for an amount (deducted from your bill and not exchangeable for cash), or a free sample.
The terms written by the Merchant.
The shop's location on the map, and its opening hours and phone number, if available.
The expiry date and time.

How Do I Redeem a Coupon?

Go to the shop before the Coupon expires.
Open the Coupon card and show the code to the cashier.
The cashier scans it with the Merchant app — or types the written code manually.
The Coupon is redeemed and you receive bonus XP and Coins.

Each Coupon can be redeemed once. Read its terms before you go.

"Just redeemed"

After redemption, the Coupon disappears from the list and moves to "Past Coupons", and a "Just redeemed" bar appears at the top with the time and branch for ten minutes — show it to the cashier if there is any disagreement.

When Does a Coupon Expire?

The Merchant sets the validity period, and you can see it on the card. We remind you three days before it expires. An expired Coupon moves to "Past Coupons" and cannot be redeemed.

Gifting a Coupon to a Friend

Open the Coupon card and tap "Gift to a Friend" — or tap the gift button in your friend's chat.
Choose the friend and confirm.

Gifting is for your friends only, and the Coupon leaves your account permanently. A redeemed or expired Coupon cannot be gifted.

A Problem with a Coupon

If a shop refuses a valid Coupon or something goes wrong: open the card and tap "Problem with this coupon?" — a ticket is opened and the Coupon number is attached automatically.

The Shop Is Unavailable or Paused

"The shop is temporarily paused": redeem your Coupon if you find the shop open; otherwise, its validity will be extended by the time it spent under the pause when the shop returns.
"The shop is closing its account": your Coupon is valid until its expiry date, so redeem it before then.
"The shop is currently unavailable": contact support before you go.
If the Platform suspends a shop for violating its terms, that shop's Coupons may be cancelled, and you will receive a notification about it.

Past Coupons

At the bottom of "My Coupons" there is a "Past Coupons" button: redeemed, expired, and cancelled Coupons, with the date and place of redemption.

💰 The Wallet and Coins

What Are Coins?

The game's currency. You spend them in the Store on Radars and Treasure Keys. They cannot be cashed out, withdrawn, transferred to others, or used at shops.

How Do I Earn Coins?

Opening Boxes (more from Rare and Legendary ones).
Redeeming Coupons at shops.
The Daily Login and the seventh-day bonus.
Quests and Badges.
Inviting friends.

Cash Balances

You may win a cash prize from the Boxes of some Events, which then appears in your "Earnings Balance". Prizes from Rare and Legendary Boxes stay "under verification" for about a day before they are confirmed.

Withdrawing Earnings

Wallet → "Withdraw".
The first time: enter your full name as shown on your ID and the IBAN of a bank account in the Kingdom in your name, and complete identity verification.
Enter the amount — you see the minimum amount, the processing time, and any fees before you confirm.
Follow the status of your request in the Transaction History.

Some time may need to pass before your first withdrawal, and we may review large withdrawals before processing them — to protect you from fraud.

Transaction History

In Wallet → "Balance" → "Full History": every Coin and balance transaction, with its reason and date.

My Items

In Wallet → "My Items" you will find the Items you own:

"Activate" to turn on a Radar.
Treasure Keys are not activated; they are used when you open a regular Box.
"Gift" to give an unused Item to a friend (it cannot be taken back).

🛒 The Store

"Items": Radars, Treasure Keys, and bundles of them, for Coins. Choose the Item, then tap "Confirm Purchase". Its price and duration are shown before you buy.
Discount: if you have a discount Coupon for the Store, "Use discount…" appears before you buy.
Limited-time offers show when the offer ends.
"Coins": Coin packs for real money — choose the pack, then pay through the App Store or Google Play. The pack's contents and its price including tax are shown before you buy, and purchased Coins do not expire. Refunds are handled by the app store you bought from.

Nothing sold in the Store reveals what is in Boxes, and opening is from 30 meters for every player. The Radar only extends your view.

⭐ XP, Level, and Rank

How Do I Earn XP?

Opening a regular Box: 40 · Rare: 120 · Legendary: 250
Redeeming a Coupon at a shop: 1,000 — the biggest boost!
The seventh-day Daily Login bonus: 400
Inviting a friend who redeems their first Coupon: 500
Quests and Badges: depending on each Quest.

Daily Box XP

To keep the game fair: the first 20 Boxes each day give full XP, then half up to the 40th Box, then a quarter after that. Coins, Coupons, and redemption XP are not affected.

Level and Rank

Each level needs more XP than the one before, and your Rank follows your level:

Bronze: from level 1
Silver: from level 10
Gold: from level 30 — Rare Boxes begin
Platinum: from level 60 — the Legendary Gate card appears for you
Diamond: from level 100

Tap the shield on your profile to see all the Ranks.

The Legendary Box Gate

Legendary Boxes are for Diamond players who have also completed:

20 Coupons redeemed at at least 7 different shops.
6 Badges (Event Badges do not count).
120 active days (one day for each Daily Login reward you claim).

You can see your progress on the "Legendary Box Gate" card on your profile.

Your Ranking

The "Your Ranking" card on your profile shows your position in your city and in the whole game; tap it to see the top ten.

📅 Daily Login, Quests, and Badges

The Daily Login Reward

On your profile → the "Daily Login" card → "Claim Today's Reward", once every day. On the seventh day of the streak there is a big reward, and then the streak starts again.

Grace Days 🛡️

If you miss a day, your streak does not break right away: you have a Grace Day that is used automatically, and you earn an extra one for every completed week, up to two days. If you are away longer than your Grace Days, the streak starts over.

Daily and Weekly Quests

On your profile → the "Quests" card: daily Quests that change every day (walk a distance, open a number of Boxes, message a friend…) and bigger weekly Quests. Complete a Quest, then tap "Claim".

Walking is counted between the Boxes you open — the more Boxes you open in different places, the more distance you cover.

Badges

12 Badges that you earn through achievements such as: your first Box, ten Boxes, your first Rare Box, attending an Event, the first Coupon you redeem, ten friends, and walking ten kilometers. Tap "My Badges" on your profile to see what you have earned and how to earn the rest. Your Badges appear on your public profile.

🎉 Events

How Do I Find an Event?

When an Event is nearby, a colored beam of light appears in the camera from a distance, along with the message "An Event is happening near you".
Tap "Details" to see: the distance, the rounds, the prizes, and their times.
You can see an Event's Boxes from farther away when you get close to it.

Event Prizes

They may be a Coupon, a cash amount, or an in-kind prize. In-kind prizes appear in "My Coupons" → "Event Prizes" with a collection code that you show at the collection point. Participation is always free.

An Event's Official Rules

On the Event sheet there is an "Official Rules" button: the organizing body and its license number, the duration, who is eligible to take part, the prizes and their number, how winners are determined, where and how prizes are delivered (within seven days of winning), and where winners are announced. They are published before the Event starts and do not change after it starts. Employees of the Platform, the organizing body, and the sponsoring shops, and their relatives, are not eligible to win its prizes.

The Event Room

Every Event has a chat Room that you open from its page ("Event Room"), and it closes a few hours after the Event ends.

Reserving a Seat

The "Reserve Your Seat" button opens the organizing body's website outside the App. Check the link before entering any information.

👑 Map Dominance

The Dominator of a neighborhood, district, city, region, or the Kingdom is the player who has redeemed the most Coupons there (at least 3 Coupons).
The titles: Knight of the Neighborhood, Champion of the District, Leader of the City, Chief of the Region, Legend of the Kingdom — each with its own frame for your photo.
You choose whether to appear: when you take the lead we ask you "Appear on the map?", and you can change your decision from Settings → "Map Dominance" → the visibility switch.
Your location is never shown — the Dominator's marker is at the center of their area.
If you are away for 90 days, your appearance is hidden and your count remains.

🤝 Inviting Friends

On your profile → the "Invite Your Friends" card → "Share Your Invite" to send your code to your friends.
Your friend enters your code in "Did someone invite you?" within 7 days of signing up.
You both get a reward when your friend redeems their first Coupon at a shop.

🏪 The Shop Directory

Every shop that has a City Offers account in your city, in one place.

Settings → "Shop Directory".
Search by name, choose a category, or turn on "🟢 Campaign running now" to see who has Boxes scattered right now.
Tap a shop to open its page.

The Shop Page

Its logo and category, "Open now" and its weekly hours, and its phone number.
Its branches on the map, with "Directions" next to each branch.
"Follow" to receive its new campaigns.
"Visit Shop" if it has a website — it opens outside the App, and any purchase from it is between you and the shop.
You can also reach it from the Coupon card → "Shop Page", and from "Shops I Follow".

The page does not say where the Boxes are or what is in them — only "Campaign running". A shop may hide itself from the list, but its page remains reachable from its Coupon.

🤝 Success Partners

Settings → "Success Partners": the organizations that help run City Offers and make it succeed — such as the bank responsible for transferring prizes, and marketing partners. They are not shops.

💛 Shops I Follow

From a Coupon card, after winning, or from the shop page, tap "Follow" to receive the shop's new campaigns.
The list is in Settings → "Shops I Follow", where you can unfollow, and tap a shop to open its page.
The Merchant sees only how many followers it has, not their names.

🔔 Notifications

Nearby Box alerts quiet down during prayer times in your city.
Settings → "Notifications": each type has its own switch — Nearby Boxes, Public Events (offers and Events), campaigns from shops I follow, gifts, Coupons, Dominance, private messages, and friend requests.
"Turn Off All" turns them all off, while important service notifications remain (support replies, account, maintenance).
Your preferences apply across all your devices.
The bell at the top of your profile keeps your notifications for 90 days.
If notifications are turned off on your phone, allow them from your phone's settings.

🔐 Account and Security

Editing Your Profile

Settings → "Edit Profile": name, photo, date of birth, and gender. Your username can be changed once every 72 hours. You can also change your photo by tapping it on your profile.

Your City

We determine your city from your location automatically. If it doesn't appear: pull the profile screen down or tap "Detect City", and make sure location access is allowed. If it says "We don't recognize your city yet", we will add it soon.

Fingerprint Sign-in

Settings → "Fingerprint Sign-in": locks the App when it opens and after two minutes in the background, and unlocks it with your fingerprint, face, or phone passcode.

Recovery Email

Settings → Account Settings → "Link an Email": enter your email and a password, then confirm the email from the message you receive. It helps if you lose your mobile number.

Changing Your Mobile Number

Settings → Account Settings → Mobile Number → "Change", and you receive a code on the new number. It can be changed once every 15 days.

Account Suspension

If you violate the Terms, your account may be suspended for a day, a week, a month, or permanently. You will see a message with the reason, the time the suspension will be lifted, and the ways to contact us to appeal. A temporary suspension is lifted automatically on time.

A Copy of My Data

Settings → Account Settings → "A Copy of My Data". We prepare a JSON file for you containing your profile, Boxes, Coupons, Wallet, friends, messages, and tickets, then you choose where to save or send it (preparation may take a minute). The file is for you alone, so don't send it to anyone; it is deleted from our servers after 7 days, and you can request two copies per day. Details are in the Privacy Policy.

Deleting Your Account

Settings → Account Settings → "Delete Account".
If your Wallet holds a cash balance or a prize you haven't collected, you will be asked to type the confirmation word "I waive".
Your account stays in a deletion grace period for 30 days: you can "Restore My Account" as it was.
After 30 days it is deleted permanently, together with your Coins, Coupons, belongings, and friends.

The "Start Over" option immediately deletes your profile, Coupons, belongings, friends, and history, and starts a new account for you with the same number. To learn what we delete and what we keep, see the Privacy Policy.

🦺 Your Safety While Playing

Don't play while driving. Only passengers should tap "I'm a passenger".
Look around you as you walk, and watch out for cars and pedestrians.
Don't enter private property, government or military sites, or restricted areas for a Box. We don't place Boxes in mosques, hospitals, or schools, or on government and military sites or highways.
Respect people: don't photograph them without their permission, and respect prayer times and public places.
Play at safe times and in safe places, and take water with you in hot weather.
Seen a Box in an unsuitable place? Report it to us from the Help Center.

🆘 Help and Support

The Help Center

Settings → "Help Center": search for your question or choose a section. Under every answer there is a "More — see the User Guide" link that takes you to the full explanation here, and you can tell us "Was this helpful?".

Opening a Ticket

Didn't find your answer? Tap "Open a Ticket", choose the category, enter the subject and details, then tap "Send". You can follow the reply from "My Tickets" (the icon at the top of the Help Center), and you can reply to support up to five times in a ticket. A ticket closes automatically if seven days pass without a reply from you.

Terms and Privacy

Read the Terms and Conditions and the Privacy Policy from Settings at any time.