Payments & Partner Settlements · Documentation

User Journey

The end-to-end path through Payments & Partner Settlements, from trigger to outcome.

Payments & Partner Settlements
  1. 1

    Booking → capture → settlement

    Each non-cancelled shared booking produces a simulated capture attributed to the property's partner. Captures aggregate per partner over recent weeks into a settlement: commission percent follows the partner tier (15% base, platinum −3, bronze +3), tax is 18% of commission, and the payout is gross minus commission minus tax. The arithmetic reconciles with the shared bookings' totals.

  2. 2

    Settlement → payout + the ecosystem

    When the owner approves, the settlement is paid, settlement.approved and a simulated payment.captured (payout) are emitted, and a confirmation notification is sent. A fraud signal (#18) or an open refund (#21) can motivate a hold instead. The settlement figures feed the partner's performance view (#13), and refunds in #21 emit their own simulated payment.captured — all reconciled against the one set of bookings.

User Journey · Payments & Partner Settlements · Abhishek Saxena