KedaiKitalah

Operations Flow Guide

SenangPay payments, WhatsApp notifications, magic links & step-by-step flow for Buyer, Vendor and Admin

๐Ÿ”„ Updated September 2026 โ€” Payments now via SenangPay
1
Buyer Action
Browse & Add to Cart
Buyer visits KedaiKitalah and selects a product. Standard products go straight to checkout. Catering/service products require booking details.
๐Ÿ“… Catering & Service Products OnlyBuyer must fill in Booking Date, Preferred Time, and Number of Pax before adding to cart. Price preview is shown automatically.
2
Buyer Action
Checkout & Pay via SenangPay
Buyer fills in phone, email, delivery location (map), and unit/floor/house number. A flat RM10 delivery fee is added. Buyer is redirected to SenangPay to pay by FPX online banking, debit/credit card or e-wallet.
๐Ÿ’ณ Payment is approved automaticallyPayment successful โ†’ order moves to Processing instantly. Buyer, vendor and admin are notified. No slip, no waiting for admin.
๐Ÿ“… Catering & Service BookingsBooking is sent to the vendor first. Buyer receives a SenangPay payment link by WhatsApp only after the vendor confirms availability.
โœ‰
Auto โ€” SenangPay โ†’ WAWP
Payment Received
Sent instantly when SenangPay confirms the payment and the order moves to Processing.
โœ‰
Auto โ€” If payment fails / unpaid
Payment Unsuccessful & Reminder
If the SenangPay payment fails or is cancelled, the order stays Pending. Buyer gets a link to retry. If still unpaid after 48 hours, a reminder is sent, and the order is cancelled after that.
โœ‰
KK Plugin โ€” Standard Products
Order On The Way
When the vendor updates delivery via their magic link, buyer receives the delivery details โ€” courier tracking, or driver details for own delivery / Lalamove / Grab.
โœ‰
KK Plugin โ€” Standard Products
Order Delivered
When the vendor marks the order as delivered, buyer is notified with a 48-hour window to report any issue.
โœ‰
KK Plugin โ€” Catering / Service
Service Fulfilled
When vendor taps Confirm Fulfilled on their magic link, buyer receives a completion message with a 24-hour issue window.
โœ‰
KK Plugin
Order Completed
Once the issue window has passed with no complaint, admin marks the order as Completed and buyer receives a final thank-you.
1
Catering / Service Only
New Booking Request โ†’ Confirm or Decline
When a buyer places a catering/service booking, vendor gets a request immediately. Vendor must confirm or decline before the buyer pays.
๐Ÿ”— Vendor taps Confirm โ†’ Buyer receives SenangPay payment link Once the buyer pays, the booking is confirmed automatically and vendor receives step 4 (Mark as Fulfilled).

๐Ÿ”— Vendor taps Decline โ†’ Buyer receives apology Order cancelled. Buyer is asked to choose a different date or vendor. No payment is taken.
2
Standard Products
New Paid Order โ†’ Update Delivery
As soon as the buyer pays via SenangPay, vendor receives the order with a magic link to update delivery. No login required โ€” works directly from WhatsApp.
๐Ÿ”— Vendor taps magic link โ†’ Mobile delivery page (no login):
Delivery method
( ) Courier โ€” Courier [ J&T Express โ–ผ ] ยท Tracking ID [ JT1234567890MY ]
( ) Own delivery / Lalamove / Grab โ€” Driver name ยท Phone ยท Live tracking link (optional)
Extra delivery cost (only if actual cost is above RM10)
Actual delivery cost [ RM18.00 ] ยท Receipt / screenshot [ Upload ]
Notes [ optional ]

๐Ÿšš Submit & Notify Buyer

On submit โ†’ Order โ†’ Shipped โ†’ Buyer gets delivery WA โ†’ Admin gets WA alert (with extra cost claim, if any)
๐Ÿšš Delivery Fee RuleThe platform collects a flat RM10 delivery fee from the buyer. If your actual delivery cost is higher, declare the full cost and upload the receipt in this form when you ship. Admin reviews the claim; the approved extra amount is added to your next payout. Never ask the buyer to pay extra.
3
Standard Products
Mark as Delivered
When the buyer has received the order, vendor taps the "delivered" link from the confirmation message.
๐Ÿ”— Vendor taps magic link โ†’ Delivered confirmation page: Shows order details. Proof of delivery photo [ Upload โ€” optional ]

โœ… Confirm Delivered โœ• Not Yet

On confirm โ†’ Order โ†’ Delivered โ†’ Buyer + Admin get WA notifications
4
Catering / Service
Paid Booking โ†’ Mark as Fulfilled
Once the buyer pays for a confirmed booking, vendor receives a magic link to mark the service as Fulfilled after it is done.
๐Ÿ”— Vendor taps magic link โ†’ Fulfill confirmation page: Shows order + booking details (date, pax, amount), then:

โœ… Confirm Fulfilled โœ• Not Yet / Cancel

On confirm โ†’ Order โ†’ Fulfilled โ†’ Buyer + Admin get WA notifications
5
All Vendors
Payout Received
Orders become eligible for payout once they are Completed (after the buyer's issue window). When admin transfers your payout, you receive a WhatsApp with the breakdown and bank reference.
๐Ÿฆ Before your first payoutMake sure your bank account name and number are filled in under Settings โ†’ Payment in the vendor dashboard.
1
Admin Receives
New Paid Order (Auto-Approved)
When SenangPay confirms payment, the order moves to Processing automatically. Admin receives an info alert โ€” no action needed.
โš ๏ธ Buyer says "I paid" but order is still Pending?SenangPay may have failed to update the site. Check the transaction in the SenangPay merchant dashboard. If payment is successful there, change the order to Processing manually in WooCommerce โ†’ Orders โ€” buyer and vendor are then notified as usual.
2
Admin Receives
Delivery Updated by Vendor (+ Extra Cost Claim)
When the vendor submits delivery details, admin is alerted. If the vendor declared a cost above RM10, the message includes the receipt and an approve/reject link.
๐Ÿ”— Admin taps claim link โ†’ Claim review page: Shows receipt, courier and order details.

โœ… Approve RM8.00 โœ• Reject

Approved amount is recorded on the order and added to the vendor's next payout. Vendor is notified either way.
3
Admin Receives
Delivered / Fulfilled by Vendor
When the vendor marks an order Delivered (standard) or Fulfilled (catering/service), admin receives a confirmation. The buyer's issue window starts here.
4
Admin Action
Mark Order as Completed
After the issue window passes with no complaint (48 hrs for delivered orders, 24 hrs for services), go to WooCommerce โ†’ Orders and change status to Completed. This sends the final WhatsApp to the buyer and makes the order eligible for vendor payout.
โ†ฉ๏ธ Refunds & CancellationsIf the vendor cannot fulfil, the item is out of stock, or the buyer reports a valid issue: process the refund in the SenangPay merchant dashboard first, then set the order to Refunded in WooCommerce. Inform buyer and vendor by WhatsApp. Refunded orders are excluded from payout.
5
Admin Action
Process Vendor Payout
On each payout cycle, check the Ledger Book (export to Excel) for Completed orders per vendor. Total = product sales + RM10 delivery per order + approved extra delivery claims โˆ’ deductions. Transfer to the vendor's bank account, then mark the payout as paid with the bank reference.
โœ… Triggers Vendor Payout WAVendor receives the payout breakdown and bank reference automatically.
๐Ÿ“‹ Payout Checklist
  • Only Completed orders โ€” exclude Refunded / Cancelled
  • SenangPay settlement for those orders has reached the platform account
  • Extra delivery claims are approved (or rejected) before payout
  • Vendor bank details verified
๐Ÿ›’ Buyer Receives
Booking Confirmed by VendorKK Plugin โ€” SenangPay payment link
Booking Declined by VendorKK Plugin โ€” apology, order cancelled
Payment ReceivedNEWWAWP Auto (#2 Processing) โ€” instant after SenangPay
Payment Unsuccessful / ReminderNEWWAWP Auto (#5) โ€” retry payment link
Order On The WayKK Plugin โ€” courier tracking or driver details
Order DeliveredNEWKK Plugin โ€” with 48hr issue window
Service FulfilledKK Plugin โ€” with 24hr issue window
Order CompletedKK Plugin โ€” final thank-you
๐Ÿช Vendor Receives
New Booking RequestKK Plugin โ€” confirm/decline magic links
New Paid Order (Standard)KK Plugin โ€” delivery update magic link
Paid Booking (Catering/Service)KK Plugin โ€” fulfill magic link
Delivery UpdatedKK Plugin โ€” receipt + "delivered" magic link
Extra Delivery Claim Approved / RejectedNEWKK Plugin โ€” admin decision
Delivered / FulfilledKK Plugin โ€” confirmation receipt
Payout TransferredNEWKK Plugin โ€” breakdown + bank reference
โš™๏ธ Admin Receives
New Paid OrderKK Plugin โ€” info only, auto-approved by SenangPay
Delivery Updated by VendorKK Plugin โ€” tracking / driver details
Extra Delivery ClaimNEWKK Plugin โ€” receipt + approve/reject link
Delivered by VendorNEWKK Plugin โ€” with proof of delivery
Service Fulfilled by VendorKK Plugin โ€” booking + order details

๐Ÿ“Œ Message Sources

SenangPay โ€” Payment gateway (FPX, card, e-wallet). Confirms payment automatically and moves the order to Processing, which triggers the WhatsApp messages.
WAWP Auto โ€” Configured in app.wawp.net. Fires automatically when WooCommerce order status changes. No code needed.
KK Plugin โ€” Custom plugin logic. Sends via WAWP API. Includes magic links, booking details, delivery claims and payout notices.
Magic Links โ€” Secure one-time URLs sent via WhatsApp. No login required. Each link is unique per order and secured by a hash token.

๐Ÿ”„ Order Status Flow

Pending (awaiting payment) โ†’ Processing (paid via SenangPay) โ†’ Shipped โ†’ Delivered / Fulfilled โ†’ Completed โ†’ Vendor Paid Out
Side paths: Pending โ†’ Cancelled (unpaid after 48 hrs or booking declined) ยท any paid status โ†’ Refunded