Merchant earnings
Every paid order from a merchant's shoppers accrues the merchant's royalty. These numbers are read live from the API with each demo merchant's key (merchantEarnings) — no shopper names, addresses or accounts are visible to the merchant.
How royalty works
- Your shopper orders through your site, app or assistant with your merchant key.
- Villa prices and fulfils it. Royalty is recorded on the order as Pending.
- The shopper pays on the payment link: royalty becomes Accrued.
- Settlement of accrued royalty is monthly (not part of this sandbox).
royalty = rate × (grand total − delivery − express)
individual shoppers on Villa's own agent: rate 0