Where to go Stores & storefronts

1. Open Stores & storefronts and use the New store form. Enter the store name and a customer contact phone number.
2. Choose the country, state and local government area (LGA). Select a ward if you know it; only the ward is optional.
3. Enter the city or town and a proper Store address, including the shop number, street and useful directions. You can complete the form without a map pin.
4. To use the map, search in its separate search box and choose a result, click the map, or use your current location. A selected pin updates the region and clears Store address so you can write your own description.
5. Changing city, state, LGA or ward removes the map pin. Editing Store address keeps the pin in place.
6. Save the store. If you have several branches, select the correct store in the dashboard before changing products, staff, payments or delivery settings.
7. Use Edit for corrections. Open Manage storefronts & QR codes to review the customer-facing store and its QR code.

Where to go Payment gateway → Business verification → Gateway connection → Gateway operations

1. Select your store and open Payment gateway. Enter the owner and business details, using the registered business name exactly as it appears on the CAC certificate.
2. Upload the CAC certificate and the owner identity document with NIN or BVN evidence. Use PDF, JPEG or PNG files of 10 MB or less. Each successful upload is sent to Statira for review; a file you have only selected is not saved.
3. Use Save & finish later or Finish later when needed. Add supporting documents when available or requested. Review the document statuses and replace anything rejected.
4. For a newly created Statira account, check the onboarding email from Statira Payments Ltd, including spam. Sign in to its merchant dashboard and change the default password to complete your signup there. Existing Statira customers use their existing login details.
5. If your business already exists on Statira, approve the connection using the emailed code or the approval flow shown. Do not create a duplicate business to work around a connection issue.
6. After documentation approval, choose LIVE for real trading in Gateway connection and complete the Statira connection. Return to MarketVillage and check that the status says Connected. The chosen mode stays fixed until you disconnect.
7. In the gateway operations section, send the MarketVillage webhook URL to Statira, then sync the webhook secret and confirm the secret shows as synced.
8. Review the detected server IP and submit the gateway OTP to whitelist it. Confirm the allowlist status before testing a payment.
9. Use the webhook and IP controls again after a gateway change, server migration or failed payment callback. These settings belong to the connected company and apply to all its stores.

Where to go Payment gateway · Delivery areas · Inventory

1. Confirm that Statira documentation is approved and the gateway is connected. A store that is not ready to accept payments will not appear in customer discovery.
2. Add active products and enable Show in store for products customers should browse. Cashier-only products can have Show in store turned off.
3. Open Delivery areas and enable the online delivery or pickup options you intend to offer. Set pickup lead time and collection hours where shown.
4. For each delivery area, choose its country, state and LGA, with a ward if needed. An LGA-wide area covers its wards; a ward-specific area is narrower. Check the hierarchy after using the map.
5. Set the delivery fee and whether your store collects its configured delivery fee with the goods payment. Platform-rider delivery charges are handled separately through the platform flow.
6. Check the store from the customer website or mobile app using a delivery location within the configured area. Recheck payment readiness, product visibility and location details if it is missing.

Where to go Stores & storefronts → Manage storefronts & QR codes

1. Open Manage storefronts & QR codes and find the correct store or branch.
2. Choose Generate QR and check the store name in the preview. This is a store QR code, not a product barcode or a payment account.
3. Download the QR card for sharing, or choose Print QR Card and check the printer preview before printing.
4. Scan the printed QR with the customer app to confirm it opens the intended store. Place the readable card near the entrance or checkout.

Where to go Vendors

1. Select the store, open Vendors and add the supplier’s name and the contact information you have.
2. Mark Internal vendor only for an internal supplier or department, such as your own bakery or kitchen. Leave it off for outside suppliers.
3. Save the vendor and confirm it is active. Use Edit to maintain contact details or status.
4. If this vendor will receive payouts, open Wallet, choose the bank by name, enter the account number and verify it. Check the returned account name before saving the payout account.

Where to go Inventory → add inventory item

1. Open Inventory and start a new item. Enter a clear product name and SKU. Barcode is optional: enter an existing barcode, use Generate barcode, or leave it blank for an internal barcode to be assigned. Enter the opening stock explicitly; units per carton is only needed for carton sales.
2. Enter the selling price and cost price. Choose the vendor when known. Cost and selling price serve different purposes; enter the actual figures rather than treating them as the same field.
3. Enter opening stock in units. Leave Variable product and Prepared on demand off for a normal stocked item.
4. Leave carton fields blank when you do not sell cartons. Turn on Show in store if customers should see it online, then save.
5. Find the product in the list and check its price and quantity. Use Edit for corrections and Increase to add stock when goods arrive.

Where to go Inventory → Sold by measurement → Selling unit

1. Create the product and enable Sold by measurement. Choose its Selling unit and give it a recognizable name, SKU and barcode. Existing weighed products remain in kg.
2. Enter the selling price and cost per selected unit. Use the optional fixed part price only when that product genuinely includes a fixed charge.
3. Enter opening stock in the selected unit. No automatic conversion is applied: 500 ml is not entered as 0.5 unless the selling unit is litres.
4. At the cashier, select the product and enter the measured quantity using the unit requested on screen. Review the calculated line total before collecting payment.

Where to go Inventory → Prepared on demand

1. Create or edit the item and enable Prepared on demand — don’t track stock.
2. Enter its selling and cost prices, barcode and supplier or internal kitchen if applicable. Choose weighed pricing only if you actually sell it by weight.
3. Keep the item active and select Show in store if it is also available to online shoppers.
4. Save. Prepared items can be sold at zero stock; stock deductions and low-stock alerts are not used for them. Deactivate the item when you cannot prepare it.

Where to go Inventory → carton fields

1. Set the normal unit barcode and unit selling price first.
2. If you sell cartons, enter the carton price and the correct Units per carton. Add the carton barcode when available.
3. Review how many individual units the carton represents. For example, one carton of 12 should consume 12 units of tracked stock.
4. If you do not use carton pricing, leave Carton price empty; Units per carton is not required solely for a unit-priced product. Save and test the intended barcode at the cashier.

Where to go Inventory → create or Edit → Vendor

1. Add and activate the supplier in Vendors first, including internal suppliers where appropriate.
2. Open the product in Inventory, choose Edit and select the correct Vendor.
3. Enter the actual cost or vendor supply price shown on the product form. Keep the customer selling price separate.
4. Save and reopen the product to confirm the match. Use the vendor filters in Sales reports to review the resulting product attribution.

Where to go Inventory → new product or Edit → Unit barcode

1. Select the correct store and create a product, or open an existing item with Edit. Keep a working manufacturer barcode when the product already has one.
2. Choose Generate barcode beside the unit barcode field. The app generates a 13-digit value and checks it against the loaded inventory barcodes.
3. Save the product or Save changes before downloading labels. Generating a number alone does not save or reserve it; resolve any save error before printing.
4. Reopen the saved item and check the barcode. Use a separate carton barcode only when the item has a properly configured carton pack.
5. Print a sample label and scan it at the cashier. Confirm the product, selling unit and price before labelling the rest of your stock.

Where to go Inventory → product actions → Download barcode PDF

1. Find the saved product in Inventory. Check its name and unit barcode, then choose Download barcode PDF.
2. Open the downloaded PDF. It contains one A4 sheet with 27 copies of that product’s unit barcode, arranged in three columns and nine rows. Each label area is 63 × 29 mm.
3. Use an A4-capable printer and paper or label stock that matches the layout. Print at Actual size / 100% rather than Fit to page, and test alignment on plain paper first.
4. Check the name and barcode are sharp and unclipped. Keep the white space around the bars and avoid folds or curved placement that makes scanning difficult.
5. Scan one printed label in the cashier app. Confirm the product and price, then attach labels to the matching goods. Download the same saved barcode again whenever you need more copies.

Where to go Inventory → Restock / Edit

1. Select the store, find the product and check the current quantity against the physical goods.
2. For newly received goods, enter the additional quantity in Restock, select Unit or Carton as appropriate, and click Increase. For cartons, verify Units per carton before adding them.
3. For a weighed product, use the kilogram quantity indicated on the form. Prepared-on-demand products do not need artificial restocks.
4. For a stock-count correction, use Edit and the exact stock quantity field. Enter the final counted balance, not the amount you want to add.
5. Save and check the resulting stock. If a request appears slow or uncertain, refresh and inspect the balance before repeating Increase so that the same delivery is not counted twice.

Where to go Inventory → Edit

1. Open the product with Edit and review Active and available for sale and Show in store.
2. Turn Show in store off to hide the item from customer web/mobile browsing, search and checkout while keeping it available to cashiers if Active remains on.
3. Turn Active off when the product should no longer be sold, including a prepared item you cannot currently make.
4. Save, then check the intended customer and cashier views. Restore the appropriate settings when the product becomes available again.

Where to go Media & bulk · Inventory

1. Select the correct store and open Media & bulk. Follow the CSV header and file requirements shown on that page.
2. Prepare a small sample first. Check names, SKUs, barcodes, selling prices, costs, opening quantities and vendor names before importing a larger file.
3. Review the import result and correct rejected rows rather than repeatedly uploading the entire file without checking what succeeded.
4. Use the product image tools for clear, relevant photos. Reopen sample products in Inventory to verify their details and online visibility.
5. For products without manufacturer barcodes, generate a barcode and use Download barcode PDF from the inventory item. Print a label and test that it scans to the correct product.

Where to go Team

1. Ask the cashier to sign up as a normal MarketVillage user and verify their email. They choose their own password.
2. Select the correct store or branch and open Team. Choose Cashier, enter their registered email, then use Add team member. No temporary password is needed for cashiers.
3. The cashier uses their existing email and password. Choose Cashier mode in the app. Shopper and cashier sessions are separate. Their assigned store and role appear in their profile.
4. If you own the store and sell alone, use your existing account in Cashier mode. You do not need to add yourself again; the first cash sale completes the combined checklist step.
5. Confirm the member is active in the store. Use Edit to adjust their role or active membership; remove access when they leave.

Where to go Cashier payments

1. Open Cashier payments for the selected store. Choose Allow cash checkout, Allow Pay with Transfer and Allow send to POS as needed, then Save cashier controls.
2. Complete Statira documentation and gateway connection before using gateway-backed payment methods. A toggle does not bypass payment readiness checks.
3. For Send to POS, register or configure the active terminal in the terminal section. Assign it to the correct cashier in Bind cashiers to terminals and save the assignment.
4. Have the cashier refresh or sign in and check the available methods. Send to POS requires an active configured terminal assigned to that cashier.

Where to go MarketVillage app → Cashier

1. Install the current app from Downloads, or open the web cashier. On mobile choose Cashier rather than the customer or rider workspace.
2. Enter the work email and password for the active cashier account. If prompted, enter the verification code sent to that email.
3. Use Forgot password? if a new staff account needs password setup or the cashier cannot remember their password.
4. Select the assigned store and let the catalogue sync. If no store appears, ask the owner to check Team membership rather than creating a second account.
5. Use the app’s Sign out before moving to another device. Pending offline sales must sync first; closing the app is not the same as signing out.

Where to go Mobile cashier → Settings → Printer & sharing

1. Charge the printer, load the thermal roll correctly and turn it on. Check its manual for its Bluetooth name and any pairing code; not every nearby Bluetooth device is a printer.
2. On Android, pair a Bluetooth Classic printer in the phone’s Bluetooth settings first when required. On iPhone or iPad, use a compatible ESC/POS Bluetooth LE (BLE) printer; Classic-only Bluetooth printers are not supported by this mobile flow.
3. In cashier Settings → Printer & sharing, choose Bluetooth, allow the requested nearby-device permissions and tap Find Bluetooth printers. Select your printer from the results.
4. For a Wi-Fi printer, put the phone and printer on the same reachable network, choose Wi-Fi, enter the Thermal printer IP and tap Save Wi-Fi printer.
5. Choose 58 mm or 80 mm to match the paper. Tap Print test receipt and confirm only if a readable slip actually prints.
6. Enable Auto-print paid receipts if wanted. The app saves the printer and attempts to reconnect when printing; keep it powered on and nearby.

Where to go Cashier → Sell

1. Select the store and open Sell. Scan a product barcode or search for its name.
2. Add the required quantity. For weighed products, enter the measured weight and check the calculated amount. Prepared-on-demand items do not need a pretend stock quantity.
3. Review each line and the running total. Adjust or remove mistakes before you start payment.
4. If the customer built a cart in their app, use the checkout handoff/QR option to import it and confirm the actual goods being purchased.
5. Use a separate customer cart for the next person when necessary. Always confirm which cart you are collecting payment for.

Where to go Cashier → customer checkout

1. For Cash, count and receive the cash before completing the cash checkout. Review the cart total first.
2. For Pay with Transfer, generate the account instructions for that cart. Show or print the bank name, account number, exact amount and expiry. The customer pays the displayed amount.
3. Wait for the app to show verified PAID status. A customer screenshot, bank alert or printed unpaid invoice is not proof that the gateway confirmed payment.
4. For Send to POS, select the assigned terminal, complete the payment on that terminal and use the app’s verification flow. Do not treat dispatching to the terminal as payment success.
5. If instructions expire or the result is uncertain, check the existing payment’s status and use only the retry option the app offers. Do not collect a second payment simply because a screen was closed.

Where to go Cashier → payment instructions / History

1. Before a transfer is paid, open the current payment instructions and choose the unpaid invoice print/share action. Only use instructions while their account is still valid.
2. Give the customer the bank name, account number and exact amount shown. The invoice is a request for payment, not a receipt or permission to release goods.
3. After successful payment, print the paid receipt. With Auto-print paid receipts enabled and a working saved printer, the mobile cashier attempts to print it automatically.
4. For a replacement copy, open History and the completed sale, then print or share its paid receipt/PDF. A paid cart is closed; use History rather than reopening the sale.
5. On web or desktop, use the available print dialog or configured printer. Check the paper width and preview. Save as PDF where offered if you need a digital copy.

Where to go Orders alerts → Fulfillment

1. Open Orders in the dashboard header. Use Enable browser alerts and Sound: on if wanted. Browser and sound alerts work while the dashboard is open; email alerts can arrive when it is closed.
2. Open Fulfillment and select the store. Distinguish a new order awaiting payment from Payment confirmed. Do not prepare or release goods as paid based only on a new-order notification.
3. For a paid order, review its items and pickup notes, then choose Start preparing. After checking and packing the items, choose Mark ready.
4. When the customer arrives, ask for their private pickup code and open the secure pickup confirmation handoff shown for that order.
5. Verify the code and the goods, then complete the collection through that flow. Keep the store’s handoff screen private; it is not a link for an outside delivery rider.

Where to go Fulfillment → delivery order

1. Open the paid delivery order, review its address and notes, choose Start preparing, and Mark ready once packed.
2. MarketVillage automatically assigns an active rider whose pickup and destination coverage match this order. The delivery fee is set by MarketVillage.
3. Wait for the assigned rider to accept in their app. The store cannot accept or record cash collected on the rider’s behalf. Dispatch when the order and rider are ready.
4. The assigned rider must accept before the store can dispatch. Merchants cannot choose or replace riders.
5. The customer or assigned rider can generate the platform delivery bank-transfer details. Both see the same active account instructions. The customer pays directly; if cash is collected instead, the rider must explicitly confirm it.
6. The rider confirms the recipient’s delivery code through their app after payment or cash collection is recorded. Live location is available during active tracking and ends after delivery. The rider can open the destination in their phone’s maps app.
7. Delivery checkout is unavailable when no eligible rider covers the route.

Where to go Fulfillment → Message customer

1. Open the correct order in Fulfillment and choose Message customer.
2. Send a short, specific update about that order, such as a packing question, pickup readiness or a delivery clarification.
3. The customer replies from Message merchant on their order. Customers can also message an accepted platform rider in the separate rider conversation.
4. When the order is completed or cancelled, conversation history remains read-only. Do not ask customers to send passwords, OTPs, bank PINs or payment-card details in chat.

Where to go Sales & payouts

1. Open Sales & payouts to review sales across all your stores, or filter by store and date. Use Sales reports for detailed product reporting.
2. Choose Open PaywithStatira. Sign in with your Statira merchant account.
3. Handle wallet funding, payouts and wallet transaction history directly on Statira.
4. If a previous payout is pending or uncertain, confirm its status with Statira before creating another payout.

Where to go Vendors → Wallet

1. Open the correct vendor’s Wallet and review its balance and recorded activity. Product-to-vendor mapping and cost information should be correct before relying on supplier reports.
2. Choose the bank from the directory and verify the account number before saving or using a payout account. Confirm the returned account name with the supplier.
3. Open PaywithStatira to pay the supplier. Review the beneficiary, amount, fees and status there.
4. Use Record a vendor payment only after you have already paid the supplier elsewhere. Enter the amount, payment reference and note. This records a payment; it does not send another bank transfer.
5. Review the payout history. For a pending gateway payout, check its status rather than recording or sending a second payment for the same obligation.

Where to go Sales reports · Cashier activity · Overview

1. Ask cashiers to sync pending offline cash sales before signing out or switching devices.
2. Open Sales reports for the correct store and period. Filter by payment method, channel, product or vendor to inspect completed sales.
3. Use Cashier activity for the related cashier sessions and handoffs. Compare counted cash with cash sales separately from verified gateway collections.
4. Review inventory insights and restock normal tracked products where needed. Prepared-on-demand items should not be treated as low stock solely because their quantity is zero.
5. Use PaywithStatira for wallet balances and pending movements. MarketVillage shows store sales, not gateway wallet transactions. Merchant finance credit insights are not wallet cash; loan and investment actions marked Coming soon are not live funding offers.

Where to go The affected store, device or order

1. Store missing from discovery: confirm Statira documentation approval, the correct connected gateway, store location and active products with Show in store enabled.
2. Cashier cannot see a store or payment method: check active Team membership, the selected store, Cashier payments toggles, gateway readiness and assigned POS terminals.
3. Printer will not print: check power, paper direction, Bluetooth/network permissions, paper width and the saved printer. Run Print test receipt. iOS needs a compatible BLE printer for this Bluetooth flow.
4. Product blocked by zero stock: restock a normal item, or use Prepared on demand only for genuinely made-to-order products. Do not change stock behavior just to hide missing inventory.
5. Online payment stuck or expired: the customer can check payment in Purchases, resume valid instructions, or use retry when the payment is conclusively unpaid. An unknown result needs verification, not another charge.
6. No rider matches: check both the store pickup hierarchy and the customer destination hierarchy. Delivery checkout remains unavailable until coverage is available.
7. Still stuck? Send support the screen, app version, store and relevant order reference. Hide bank details where unnecessary and never send passwords, OTPs, PINs or secret keys.