The Revenue Share GPV Payouts API lets a Wix Partner read their revenue-share earnings derived from gross payment volume (GPV), the total payment volume processed across the sites the partner manages. It's a read-only API for reviewing what the partner earned from GPV and whether Wix invoiced it.
A GPV payout represents a partner's GPV-derived revenue-share earning for a
single period. Wix creates and maintains these records automatically as payment
volume accrues on the partner's sites, and the partner can't create or edit them.
Each payout exposes the period's total GPV, the partner's earned amount, the
revenue-share rate that was applied, and a per-site breakdown. All monetary
values are in USD.
With the Revenue Share GPV Payouts API, you can:
A partner in the Wix Partner Program earns revenue share from separate streams, each with its own read-only API: Revenue Share Premium Payouts for premium subscriptions the partner sold, this API for GPV-derived earnings, and Marketplace Payouts for marketplace transactions such as template sales. These APIs record per-earning revenue share. Separately, the Materialized Invoices API surfaces the invoices and payments the partner actually received, and breaks each invoice total down into premium, GPV, marketplace, and app market sub-totals. The GPV sub-total cross-links back to this API.
transactionDate, the GPV period,
updating it in place as more volume accrues. Don't expect multiple payouts for
the same period.transactionDate is the day the volume was processed, and it's the date to
filter and sort on. createdDate and updatedDate are record bookkeeping.
They record when Wix created the payout and when it last changed as volume
accrued.A payout's invoiceId is the reference code of the partner invoice Wix included
it in, and it's empty until Wix invoices the payout. To resolve the code, query
the Materialized Invoices
API for the invoice whose invoicesRefCodes contains that value, and read the
status of that invoice to see whether Wix paid it.
Partners also see their GPV earnings in the Wix Studio dashboard. The dashboard presents the same records, but names and shapes them differently:
gpv as Client sales.sitesGpv lists up to 200 contributing sites, each with the volume it
processed in USD and the site's name. The dashboard shows only the site count
and the first few site names, without amounts.sitesGpv[].siteName is captured when Wix last calculated
the payout. A day's payout is recalculated while volume is still accruing, so a
site renamed during that window can show the newer name. Once the day is
settled, the name stops changing. The field is best effort. It can be empty,
and it's empty on payouts created before Wix started capturing it. You can't
filter or sort on it, so use metaSiteId as the stable key.invoiceId isn't invoiced yet. Once invoiceId is set,
the status of the matching materialized invoice tells you whether Wix paid it.It's important to note the following points before starting to code:
gpv, amount, and sitesGpv.gpvInUsd, are in USD, even
where the field name doesn't carry an explicit InUsd suffix.paymentRevenueSharePercent is a fractional percent.
0.05 means 0.05% and 0.1 means 0.1%, not 5% or 10%. Wix sets it
automatically based on the period's GPV. For the calculation, see Terminology.paymentRevenueSharePercent. Wix sets
it automatically per period: 0.05% when the period's GPV is 2,000 USD or less,
and 0.1% when it's above 2,000 USD. The earned amount equals
gpv × paymentRevenueSharePercent ÷ 100.sitesGpv.invoiceId
is set. Until then, the payout is uninvoiced.Last updated: 25 August 2026