Promotions

Version note: Source PDF is dated 12 May 2026 and shows GMS v2.2.0. Navigation and labels may differ in newer versions. Rewards Program screenshot contains legacy Re-Purchase Program wording.

Promotions provides account-level discounts, free vends, referral tracking, loyalty rewards, top-up rewards, and anniversary rewards. Configuration happens in GMS and serves both GreenwaldPay and MultiPay through shared platform services.

At a glance

Promotion	Customer benefit	Scheduled activation	Source status
Mobile Vend Discount	Discount or service charge per vend	Yes	Existing
First Mobile Vend Free	First vend after signup is free	No	Existing
Refer a Friend	Tracks successful referrals	No	Existing
Loyalty Program	Points earn a free vend	Yes	Added
Rewards Program	Top-up threshold earns bonus balance	Yes	Added
Anniversary	Anniversary activity earns a free vend	No	Added

Mobile Vend Discount, Loyalty Program, and Rewards Program may run together. Platform records each vend against every applicable program.

System impact

Component	Responsibility
GMS	Account-level promotion configuration
GreenwaldPay Mobile App	Promotion messages, discounts, credits, and free-vend experience
Shared platform services	Promotion data, eligibility, and reward processing used by GreenwaldPay and MultiPay

Prerequisites

Before configuring promotions:

• Promotions must be enabled for the customer system. Contact Greenwald support if the Promotions tab is unavailable.
• GMS user needs promotion permissions. Source names Promotion Read while also describing edit access. Editing may also require Promotion Change, depending on the GMS version.
• Existing Mobile Vend Discount, First Mobile Vend Free, and Refer a Friend settings should already be migrated to new format.

Feature gate: When system-level feature is disabled, account settings do not take effect and Promotions tab is hidden.

Open Promotion Settings

Navigate to:

System → Accounts → select account → product section → Promotions

Exact product-section label may differ by deployment.

GMS Promotion Settings - GMS v2.2.0

Vending promotions

Mobile Vend Discount

Applies discount or service charge to every eligible mobile vend under account.

Mobile Vend Discount settings - GMS v2.2.0

Setting	Values and behavior
Type	Disabled: no promotion. Fixed Amount: positive value creates Mobile Discount refund; negative value creates Mobile Service Charge. Percentage: refunds configured percentage as Mobile Discount; negative percentages are not allowed.
Amount	Available only when Type is Fixed Amount.
Percentage	Available only when Type is Percentage.
Time Setting	Always On or Schedule. See Scheduling.

First Mobile Vend Free

Grants each eligible user under account one free vend after signup. No additional fields documented in source.

Refer a Friend

Tracks friend referrals. Referral becomes successful when referred person signs up for GreenwaldPay Mobile App. No additional fields documented in source.

Loyalty Program

Awards loyalty points for eligible vends. After user reaches configured threshold, next vend is free.

Loyalty Program settings - GMS v2.2.0

Setting	Behavior
Enabled	Enables program for account and eligible users.
Display in Phone App	Shows Loyalty Program is enabled! at sign-in.
Points granted for Vend	Points awarded per vend. Any denomination may be used; simple example is 1 point per vend.
Points needed for Vend	Threshold that earns next free vend. Example: 5 points creates a 5+1 free scheme.
Notify User	Shows You have a Free Vend! after user earns free vend.
Time Setting	Always On or Schedule. See Scheduling.

User promotions

Rewards Program

Awards bonus balance after completed payment/top-up meets configured threshold.

Legacy screenshot label: Source screenshot says Re-Purchase Program. Canonical name is Rewards Program.

Rewards Program settings - GMS v2.2.0; screenshot contains legacy label

Setting	Behavior
Enabled	Enables program for account and eligible users.
Display in Phone App	Shows Rewards Program is enabled! at sign-in.
Reward #{n} Enabled	Enables one of three independently configurable reward levels.
Threshold #{n} Amount	Minimum top-up amount for reward level.
Reward #{n} Amount	Bonus balance awarded when top-up qualifies for level.
Time Setting	Always On or Schedule. See Scheduling.

Reward calculation: Levels are exclusive, not cumulative. With thresholds of $10, $15, and $20, a $20 top-up receives only level 3 reward. Enabled levels must remain ordered: Reward 3 > Reward 2 > Reward 1.

Anniversary

On user's account-signup anniversary, first vend triggers anniversary reward. Source says user then receives a free vend for following vend, which may occur after anniversary date.

Anniversary settings - GMS v2.2.0

Setting	Behavior
Enabled	Enables anniversary promotion for account and eligible users.
Display Message to User	Displays Happy Anniversary <username>/<emailAddress>. You have a free vend! after first vend on anniversary date.
Grant Free Vend	Awards free vend after first anniversary vend. Following vend is free even when performed later.

Scheduling

Scheduling is available for Mobile Vend Discount, Loyalty Program, and Rewards Program.

Mode	Behavior
Always On	Promotion remains active while its Type or Enabled field activates it.
Schedule	Select weekdays plus Start Time and End Time. Source defines schedule timezone as UTC+0/GMT+0.

Use independent schedules to move demand into quieter periods instead of moving Locations between promotional and non-promotional Accounts. Schedules may overlap.

Rollout checklist

• Confirm account timezone against source-defined UTC+0/GMT+0 behavior.
• Test start/end boundaries and overnight windows.
• Verify overlapping promotions produce expected transaction history and balances.
• Confirm GreenwaldPay Mobile App messages and MultiPay behavior with test users.
• Record configured settings and rollback values.