Skip to main content

Record Payout Statement

POST 

/api/temu/:integrationInstance/payouts

Records one Temu statement as a payout and its lines (one per nonzero statement column). The statement after it (if any) is re-evaluated, since its beginning balance must release this statement's reserve.

Required scope: accounting:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Refused (422) when it would change the reserve handed on to a later statement whose documents are already in the accounting provider.

Authentication: Requires Bearer token and the integrations.update permission. Open to API tokens with the accounting:write scope.

Body: period_start_date (required, Y-m-d), period_end_date (required, Y-m-d, on or after the start), payout_date (required, Y-m-d, the day Temu paid out; not before the period start), amount (required, the statement Payout amount), beginning_balance (optional, default 0), sales (optional, ≥ 0), refunds (optional, ≤ 0), others (optional, either sign), reserves (optional, ≤ 0), currency (optional 3-letter code, default the account currency), temu_payout_id (optional, max 64, unique per store), payout_status (optional, max 64), bank_account (optional, max 64), notes (optional, max 2000), month_parts (see below).

Every amount is in whole cents (at most two decimal places). Amounts are signed the way Temu Seller Center shows them (Finances → Payments → Statements). The five columns must add up to amount exactly, and the period must not overlap another statement of the store; otherwise the response is 422.

How a payout posts: one Temu Sales invoice and, when Others is nonzero, one Temu Fees bill, dated on the payout date and netting exactly to the payout amount. Sales are booked in full as revenue; the reserve Temu withholds is debited to the reserve account and the reserve it releases (the beginning balance) is credited back, so the invoice for the 09/18-10/05/2026 statement is Sales 189.95 less 119.00 reserve = 70.95, and the next statement (beginning balance 119.00, reserves -100.00) posts a 19.00 invoice that only moves the reserve. A payout that nets to 0.00 still posts a zero-total invoice; its deposit status then reads "Nothing to deposit".

Month-end split: when the store's split_payouts_at_month_end setting is on (the default) and the period crosses a month end, send month_parts: one entry per month end the period crosses, [{"month_end_date": "2026-09-30", "sales": 120.00, "refunds": 0, "others": 0}], with that earlier month's own amounts (not a running total). The last month gets the rest. The statement then posts one document set per month, earlier months dated on their last day. Missing, extra or oversized parts are refused (422); a statement that does not split must send none. A correction keeps the split the statement was recorded with.

Request​

Responses​

Created

Response Headers
    Content-Type