> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# Resource: Marketplace Payout V1

# Type: Marketplace Payout Object

# Link: https://dev.wix.com/docs/api-reference/account-level/studio-workspace/earnings/marketplace-payout-v1/marketplace-payout-object.md

## Description: A marketplace payout is a revenue-share payout a partner earns from a marketplace transaction, such as a template sale. Wix generates marketplace payouts automatically from marketplace transactions, so partners can't create them.

## Schema:

```json
 Type: Marketplace Payout Object | type: MarketplacePayout
 Description: A marketplace payout is a revenue-share payout a partner earns from a marketplace transaction, such as a template sale. Wix generates marketplace payouts automatically from marketplace transactions, so partners can't create them.
       - name: id  | type: string | description: MarketplacePayout ID.
           - name: value  | type: string | description: 
       - name: revision  | type: string | description: Revision number, which increments by 1 each time the MarketplacePayout is updated. To prevent conflicting changes, the current revision must be passed when updating the MarketplacePayout.
           - name: value  | type: string | description: 
       - name: createdDate  | type: string | description: Date and time the payout record was created in Wix's systems. This is record bookkeeping, not the date of the marketplace transaction. For that, use `transactionDate`.
           - name: seconds  | type: string | description: 
           - name: nanos  | type: number | description: 
       - name: updatedDate  | type: string | description: Date and time the payout record was last updated. Not the date of the marketplace transaction. For that, use `transactionDate`.
       - name: listing  | type: Listing | description: The marketplace listing the transaction was made on, for example the template that was sold. The Wix Studio dashboard displays the listing's name instead of its ID and type.
           - name: id  | type: string | description: ID of the listing.
           - name: type  | type: string | description: Type of the listing.
               enum: UNKNOWN, TEMPLATE
       - name: transactionAmount  | type: number | description: Total price of the marketplace transaction, converted to and stored in USD.
           - name: value  | type: number | description: 
       - name: paymentSharePercent  | type: number | description: Fractional percent of `transactionAmount` the partner earns as revenue share, used to calculate `amount`. For example, a value of `0.05` means 0.05%.
       - name: amount  | type: number | description: Revenue share the partner earned on this transaction, in USD. Calculated as `transactionAmount` multiplied by `paymentSharePercent`, divided by 100.
       - name: transactionDate  | type: string | description: Date and time the marketplace transaction took place, which is when the payout was earned.
       - name: invoiceId  | type: string | description: ID of the invoice this payout was included in, once invoiced. Empty until the payout is invoiced.  This is the reference code of the partner's invoice. To resolve it, query the Materialized Invoices API for the materialized invoice whose `invoicesRefCodes` contains this value, and read that invoice's `status` to see whether it was paid.
       - name: status  | type: string | description: Status of the marketplace payout. - `APPROVED`: Eligible to be invoiced. Shown as `Paid` in the Wix Studio dashboard, or as `Reversed` when `negative` is `true`. - `REJECTED`: Won't be paid. Shown as `Cancelled` in the Wix Studio dashboard, and excluded from the dashboard's earnings total.
           enum: APPROVED, REJECTED
       - name: negative  | type: boolean | description: Whether this payout is a reversal or cancellation of an earlier payout. When `true`, the payout offsets a previous earning, so its `amount` reduces the partner's total. One positive and one negative payout are allowed per transaction. Reversals are returned by queries like any other payout, and count toward totals, so don't filter them out when summing.
           - name: value  | type: boolean | description: 

```