System Documentation

Future Multi-Vendor Roadmap

Strategy and technical architecture for multi-vendor transition.

1. Vendor Onboarding & linked Accounts

Sellers register via a dedicated onboarding portal. Upon completing KYC verification, the system registers the seller as a Linked Account in the Razorpay Marketplace ecosystem, saving the returned `razorpayAccountId` in the user's document details.

2. Split Cart Order Routing

When a checkout contains products from different vendors:

  • The platform generates a single parent `Order` ID for payment processing.
  • Behind the scenes, the database generates individual `SubOrders` associated with each vendor.
  • Suborders maintain their own fulfillment logs (Packed, Shipped, AWB entries), allowing vendors to dispatch their goods independently.

3. Automated Settlements via Razorpay Route

To automate splits and platform payouts, we will integrate Razorpay Route. Upon verifying payment capture:

Transfer Dispatch Logic

Platform fees/commissions are retained, and the net payout is routed:

Vendor Payout = Item Price - Platform Category Commission - Shipping Cost Split

4. Held Payouts & Return Shield

To prevent vendor account balance deficits due to customer returns, Razorpay Route transfers will be created with `"on_hold": true`. Payouts will remain locked on hold until the return period window (e.g. 7 or 15 days) expires. Once expired, a background task automatically releases the funds, ensuring hassle-free return reversals.