MarketplacePurchase Flow

Purchase Flow

Menu path: Side menu → Marketplace  •  URL: /admin/marketplace Access: ADMIN, MANAGER (payment confirmation and cancellation are ADMIN-only) • Module required: None — the Marketplace is part of the free core

The only way to buy an item is to add it to the cart in the Marketplace and pay via PayTR. No entitlement (limit or feature) is added to your account until the payment completes; there is no way to activate a paid item for free. The free core needs no purchase at all — it is already on, forever.

Operator comps can only be issued by the HummyTummy team / superadmin. On your side, the only way to buy is the paid flow.

End-to-end flow

Pick an item

Find the item you want to buy on the Marketplace screen. Each card shows what it does, its price (₺), and whether it is annual or one-time.

Add to cart

Add the item to the cart. You can put several items in the same cart: an opening cart of licence + module(s) + credit pack settles cleanly, because the server provisions in dependency order. The screen shows the total KDV-inclusive, and the total is always recalculated on the server, so the amount you pay is trustworthy.

Continue to payment

Use the Pay / Continue button to move to the payment step. The screen redirects you to the PayTR secure payment page, where each item in your cart appears as its own line (e.g. “Inventory & Cost Management (annual)”). Payment is collected in TRY only.

Complete the payment

Pay on the PayTR page. Once the payment is confirmed, you are returned to the app.

Entitlements activate

The moment the payment is confirmed, the entitlement the item grants is added to your account automatically. For example, if you bought one Extra Branch, your branch limit goes up by one in the panel right away; if you bought a module or an integration, the related screen/setting is enabled; if you bought a credit pack, your balance is topped up.

⚠️

If you reach the payment page but abandon the payment, you are not charged and no entitlement is added. The purchase only completes once the payment is confirmed.

How entitlements stack

What you buy stacks on top of the free core; multiple sources of the same kind combine like this:

  • Limits (branches) → summed. The core gives 1 branch; buy 2 “Extra Branch” units and the total becomes 3.
  • Features (advanced reports, priority support, reservations, etc.) → enabled if any source enables it.
  • Integrations (e-invoice, fiscal printer, caller-ID, SMS) → they stack; you can run several at once. Delivery is now a single package: delivery_platforms unlocks all four platforms.
  • Credits → accumulate until consumed; a second pack adds to what is left of the first.

Paying twice for the same module or integration is blocked: if it is already active, the purchase is rejected (ADDON_ALREADY_GRANTED / ADDON_ALREADY_OWNED) and your card is not charged again. Extra Branch is the exception — it is quantity-based and can be bought repeatedly, up to 100 branches per account.

Dependencies

  • The Maintenance, Support & Updates is the prerequisite for every paid module, integration and capacity item. Without one the purchase is blocked (LICENSE_REQUIRED) — unless the licence is in the same cart, which satisfies it.
  • Credit packs require the item they belong to: AI credits require AI Menu Studio, SMS credits require SMS Notifications. A sibling cart line satisfies this too.
  • Credit packs and On-site Installation & Training need no licence.

Renewal

Billing runs off your anniversary: the day you buy the licence becomes your account’s fixed anniversary, and every annual item is collected onto one invoice with one renewal date. An item bought mid-year is priced pro rata for the days left until that anniversary; if fewer than 14 days remain, the remainder is billed together with the next full cycle. No line is ever priced below ₺1.

⚠️

Renewal is manual. There is no automatic card charge and no card on file. You get reminders 30, 7 and 1 day before the renewal date, and a 7-day grace period after it. If it goes unpaid, only access to the paid items goes darkno data is deleted, and everything comes back exactly as it was the moment you pay. The free core is never affected.

Cancellation behaviour

Only an ADMIN can cancel an item (it’s a billing decision). You have two options:

  • Cancel at period end (default): the item stays active until the end of the period, and the entitlements it grants keep working until that date. When the period ends it closes automatically and the related limit/feature is revoked.
  • Cancel immediately: the item closes at once and the entitlements it grants are revoked right away.

Annual items run on a period aligned to your licence anniversary. One-time lines (credit packs, on-site setup) have no period to cancel; credits stay with you until consumed.


Developer/integration details: Marketplace API