Primarch Solutions · Kampala

Voucher Platform Concept Note

A marketplace where any business designs, sells and redeems its own gift vouchers online — and is paid directly by the buyer, through its own payment account.

Dan Agaba · Founder & Lead Engineer · primarch.work · primarch.admin@gmail.com · +256 780 337 692

01 The idea in one paragraph

A restaurant, salon, supermarket or hotel signs up, draws its own voucher, sets the values it wants to sell, and connects its own payment account.

From then on anyone can buy that voucher from a public shop page, for themselves or for somebody else, and pay by card or mobile money. The recipient gets the voucher by email as a PDF with their name, the value, an expiry date, a unique code and a QR code. At the counter it is checked once and it is spent.

The platform is built and running at vouchers.primarch.work. The screens in this note are the working system, not mock-ups.

02 The problem

A business that wants to sell gift vouchers today has three poor options.

The buyer has a difficulty of their own. Sending a gift to a relative in another town, or to five members of staff at once, means going to the shop in person — so mostly it is done in cash, or not at all.

03 Who does what

The business

Designs the voucher, sets its values, connects its own payment account, and redeems vouchers at the counter.

The buyer

Picks vouchers in the shop, says who each one is for, checks them, and pays.

The recipient

Receives a named voucher by email and shows it, on a phone or printed, when using it.

The platform

Approves businesses, sets the plans they subscribe to, and decides which payment providers are offered.

The money goes from the buyer to the business. The platform never holds it.

04 How it works, screen by screen

The business designs its voucher

business · step 1

The designer is a card the size of a voucher. The business starts from a ready layout, or from its own artwork, and places the fields where it wants them: its name, the voucher name, the value, the recipient, the expiry date, a gift message, the code and the QR.

It works like a simple design tool — undo and redo, snap-to-centre guides, shapes, background photos that can be darkened or blurred so text stays readable, and a list of layers. No designer needs to be hired.

The voucher designer: details and values on the left, the voucher card with its fields in the middle, styling controls underneath
The designer. Words in curly brackets are filled in separately for every voucher sold. Only the business name and voucher name are shown in the shop; the rest appears once the buyer has said who the voucher is for.

Or lets AI draw it

business · optional

A business with no artwork can describe what it wants in a sentence, or hand the AI a picture to follow — a voucher it likes, its shop front, a flyer — and get background artwork back in under a minute. Stock photos are searchable from the same place.

The AI draws the artwork only. The value, name, date and code are still placed on top by the system for each buyer, because those have to be exact and different on every voucher.

The Create with AI panel: a description box, style suggestions, and an optional reference image
Create with AI: a description, a style, and optionally a reference picture.

The buyer chooses

buyer · step 1

The shop lists only vouchers that can be bought right now. The buyer opens one, and picks the values and how many of each. No account and no sign-in are needed to buy.

A voucher page in the shop: the voucher design on the left, values and quantities on the right
A voucher in the shop. One value or several, any quantity.

The buyer says who each voucher is for

buyer · step 2

This is the step that paper cannot do. One voucher for one person; several vouchers for one person; or several vouchers for several people — a manager buying for a team, a family buying for relatives. Each person gets their own name on the voucher, their own optional gift message, and their own email.

More vouchers from the same business, of any kind it sells, can be added from this page without starting again.

The who-for page: two people, three vouchers assigned between them, and a panel to add more vouchers
Three vouchers of two kinds, shared between two people, in one order and one payment.

The buyer checks every voucher, then pays

buyer · step 3

Before paying, the buyer sees each voucher exactly as it will be issued — the right name, value and expiry date on the business’s own design. The unique code and QR are created only once the payment is confirmed with the payment provider, never before.

The review page: each recipient with their vouchers drawn in full, and the payment panel
The review page. What the buyer sees here is what the recipient receives.

The recipient uses it

recipient · counter staff

Each recipient is emailed their voucher as a PDF; the buyer gets a receipt, and download links if they asked for them. At the counter, a member of staff checks the QR or the printed code, sees the value and the name, and marks the voucher as used.

A second use of the same voucher is refused, even if two tills try in the same second. Staff can only check vouchers that belong to their own business.

The checking and redeeming service is built and tested on the server. The screen staff will use at the counter — a phone app that scans the QR — is the next piece to build.

05 Getting paid

Each business is paid through its own account with a payment provider. There is no float held by the platform.

This is usually the first question a finance manager asks, and the answer is the main difference from a marketplace that collects on the seller’s behalf: nothing to reconcile with us, no payout to wait for, no commission taken out of each sale.

ProviderHow the buyer paysState
FlutterwaveCard or mobile money on Flutterwave’s pageBuilt
StripeCard on Stripe’s pageBuilt
MTN Mobile MoneyA prompt on the buyer’s phone, approved with their PINBuilt, not yet run against the live network
Airtel MoneyA prompt on the buyer’s phone, approved with their PINBuilt, not yet run against the live network

A business enters test keys first, makes a test payment, and only then switches to live. The platform owner decides which providers are offered, and can add others.

06 Why a voucher cannot be faked or spent twice

07 How the platform earns

From subscriptions paid by businesses, not from a cut of their sales.

Plan prices are not fixed yet. I would rather set them against what the first few businesses say they would pay than publish a number now.

08 Where it honestly stands

The platform is built and live. It does not yet have paying businesses on it.

Everything described above is finished, deployed on a real server, and covered by an automated test suite. It has a demonstration mode, in which a purchase can be made from start to finish with test money and the vouchers issued are clearly stamped as tests.

For the first businesses that is an advantage. They get direct access to the engineer, pilot terms, and real influence over what is built next.

What is not yet proven

  • MTN Mobile Money and Airtel Money follow the networks’ published interfaces and pass their tests against simulated replies. They have not yet taken a payment on the live networks.
  • AI design is built for OpenAI and Google image models and tested the same way; it needs the platform’s own AI account to be connected before businesses can use it.
  • The counter app that staff will scan vouchers with is not built yet; the redeeming service behind it is.
  • No business has yet sold a real voucher to a real customer through it.

09 Who it is for

Businesses that would sell

  • Restaurants, cafés and hotels
  • Salons, spas and gyms
  • Supermarkets and retail chains
  • Bookshops, fashion and furniture stores

People who would buy

  • Families sending a gift to another town
  • People abroad buying for relatives at home
  • Employers rewarding staff, or giving at year end
  • Companies thanking clients

The corporate buyer is the quieter opportunity. Staff rewards are mostly done in cash or printed paper today; one order here can name twenty people and send each their own voucher.

10 Next step

A live walk-through, screen shared: I design a voucher as a business, you buy it as a customer with test money, and the voucher arrives in your inbox. Twenty minutes is enough.

Three things would make that conversation more useful than a product tour:

The platform is online now: vouchers.primarch.work