Payments & Partner Settlements · Documentation
User Journey
The end-to-end path through Payments & Partner Settlements, from trigger to outcome.
← Payments & Partner Settlements- 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
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.