Docs
This guide shows you how to understand your organization's revenue and settlement reports. Before you can receive payouts, you must review and confirm settlement reports that reflect your earnings.
Prerequisities
Fund processing happens after you have released your mini app and started receiving transactions. Therefore, to manage your revenue and confirm settlement reports, you must have already completed the following:
- Enabled and configured at least one monetization feature
- Registered a payout account by providing business, tax, and bank information
Access your revenue
The revenue settlement process can be located at the organization level within the Developer Portal:
- On the Developer Portal, go to My organizations, then click your organization.
- Click the Monetization tab.
- Go to the Revenue page.
Understand your revenue
The Revenue page is your central hub for managing income. It hosts your organization's detailed settlement statements, broken by revenue streams, including those earned from in-app purchases (IAPs) and in-app ads (IAAs).
You can view, download, and file an appeal for your statements. You can also easily filter this data by payment status and transaction period to locate the information you need.
Revenue streams
To focus on specific earnings, you can filter the settlement details by revenue stream. Choose from the following options to get the stream-specific information you need:
- IAPs (subscriptions)
- IAPs (non-subscriptions)
- IAAs
Total settled revenue
The main figure displayed, labeled Total settled revenue, reflects the total revenue that has been processed and is ready for you to review and confirm. This value is displayed in USD currency.
Note: Settlement amount is about revenue generated by the app's live version.
Settlement details
To view the details of a settlement, click the Details [>] button next to the desired settlement entry. This opens the settlement report.
Within this report, you can further refine the data by filtering by app name and ID.
To access your settlement report outside the Developer Portal, you can export it by clicking Download .xlsx on the settlement report.
Review and confirm settlement reports
Before you can receive payouts, you must review and confirm settlement reports that reflect your earnings per transaction period.
- Click the Details [>] button next to a settlement entry with a Pending confirmation status.
- Review the settlement report.
- If the settlement details look accurate, continue by clicking Confirm report. If you do not manually confirm a settlement report within four weeks of the receipt of settlement, the settlement statement will be automatically confirmed.
Note: Settlement report fields may differ across in-app purchases and in-app ads.
After confirming a settlement report, it will be eligible for payout. Learn more about submitting invoices to receive payments.
View settlement history
After you've confirmed a settlement report, click View history to keep track of the report's status.
Submit an appeal
If you find that the settlement details have discrepancies, you can file a dispute to appeal an unpaid settlement amount.
Important: Appeal requirements:
- An appeal can only be filed for unpaid and unconfirmed settlement records.
- Each unpaid record is eligible for one appeal attempt only. Records that have been previously appealed, regardless of the outcome, are ineligible for a new appeal. If you have additional questions, please contact your TikTok perations representative.
To submit an appeal, go to the desired settlement report:
- Click Appeal here on the settlement report.
- Complete the required fields on the appeal form (including a subject, description, and any relevant attachments)
- Click Submit. The settlement's payment status will change to "Appeal review".
Your appeal will be investigated and results will be communicated with you via your TikTok for Developer's inbox notification and email associated with your account.
If your appeal is successful, the status of your settlement will change to "Replaced". If your appeal is not approved, the settlement status will go back to "Pending confirmation".
Settlement statuses
These settlement statuses are displayed, providing the statement's lifecycle and defining its eligibility for subsequent actions, such as appeal, invoicing, and final payment.
Status | Definition | Required actions |
Pending confirmation | Statement has been generated and is awaiting review. When an appeal is unsuccessful, the status will change back to this. | Confirm or appeal statement |
Confirmed | The statement has been (manually) accepted and is now considered invoiceable | |
Appeal review | An appeal was filed against the settlement statement | Wait for appeal result |
Replaced | The statement was successfully appealed. The original statement is nullified and a new statement is reissued. | Confirm new statement |
Paid | The invoice associated with statement has been fully processed and the funds have been disbursed | -- |
Next step: Invoice upload and payment processing
After you have settled your revenue in the Developer Portal, proceed to the invoice upload and payout processing stage.