Skip to main content

Payout Requests

Version Pro Updated

Pro feature

This page documents a capability of the MHM Rentiva Pro add-on. It is not part of the free Lite edition on WordPress.org and requires Pro installed alongside Lite plus a valid licence. See Editions β€” Lite vs Pro for the full split, or get Pro at wpalemi.com/rentiva.

When the Vendor ecosystem is active, the process of transferring earned rental fees to vendors is managed through the MHM Rentiva > All Payout Requests menu.


πŸ“… Payout Request Flow​

Vendor earnings move to the balance after the customer's payment is confirmed. The process works as follows:

  1. Request Creation: The vendor creates a payout request from their dashboard.
  2. Admin Review: The admin sees the pending requests in the list.
  3. Approval & Payment: The physical transfer is made via the designated bank or payment channel.
  4. Status Update: Once the payment is complete, the request is marked as "Paid".

🏧 Earnings Calculation Parameters​

The system accounts for the following items:

  • Total Rental Fee: The net rental amount for the vehicle.
  • Platform Commission: The share retained by the admin.
  • Extra Revenue: Additional income from services such as insurance, child seat, etc.
πŸ“Έ Image Coming Soon: Payout Request List
The MHM Rentiva payout management screen will appear here.

πŸ“„ Payout Statements (v4.61.0)​

When you approve a payout, the system automatically generates a payment statement (hakediş makbuzu) for the period that payout covers. The statement is sequentially numbered (e.g. MKB-2026-0001) and frozen as an immutable record at the moment of approval β€” it is never rewritten afterwards, so it always reflects the figures as they were when the vendor was paid.

The statement lists every ledger movement in the period β€” earnings and any penalties β€” with the period totals and the amount paid. The vendor automatically receives an email with a link to view and print it from their panel.

Where to find it​

  • Admin: the statement number and a View link appear on the All Payout Requests list, next to the approved payout.
  • Vendor: the statement appears in the vendor's payout history, and the email links straight to it (opened from inside the vendor's own session in the panel).

Commission breakdown​

Each earning line on the statement shows the full split, so the vendor sees exactly how their net was calculated:

ColumnMeaning
GrossThe total booking amount before commission.
CommissionThe platform's rate and the amount deducted (e.g. %20 Β· 400.00).
NetWhat the vendor actually earned (Gross βˆ’ Commission).

A period "Total commission deducted" row sums the commission across all earnings in the statement. Penalty and refund lines show "β€”" for Gross/Commission (they carry no commission). Statements issued before v4.61.0 were not captured with this detail and show the net only.

Statement branding​

The statement carries your company identity. Under Settings β†’ Vendor Marketplace β†’ Statement Branding you can set:

  • Company name, address, tax office and tax number, phone, and email
  • A company logo
  • A custom footer note (e.g. a legal disclaimer)

Branding is applied when the statement is viewed, so updating these settings is reflected on every statement immediately β€” including ones already issued.


πŸ› οΈ Technical Infrastructure​

All earnings logs are stored atomically in the mhm_rentiva_vendor_transactions table. When a booking is cancelled, it is reflected as a debit on the vendor's account. Statements are stored as an immutable snapshot on the approved payout record and rendered on demand.


Section Summary​

  • Payout is the system that manages vendor earnings.
  • Balance tracking is automatically updated after each booking.
  • Requests are finalized with admin approval.

Changelog​

DateVersionNote
29.06.20264.61.0Payout statements (numbered, printable), commission breakdown, and statement branding documented.
23.04.20264.27.2English translation added.
18.03.20264.21.2New document created.