Skip to main content

Get Payout

GET 

/api/temu/:integrationInstance/payouts/:payout

Returns one payout with its statement lines, every readiness check, the ledger entries it posted and its deposit status. is_locked is true once its documents are in the accounting provider. Returns 404 when the payout belongs to another store.

Required scope: accounting:read

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

Authentication: Requires Bearer token. Open to API tokens with the accounting:read scope.

accounting_readiness lists what holds a payout back from posting: has_transactions (the statement is saved and not all zero), statement_balances (beginning balance + sales + refunds + others + reserves = payout amount), reserve_carried_forward (the beginning balance releases exactly the reserve the previous statement withheld; a mismatch means a statement is missing or mistyped), per_payout_mode_enabled, after_accounting_start_date (by payout date), part_dates_unlocked (a split statement's month parts are all dated after the accounting lock date; checked until it first posts), mappings_configured (every line type has an account or a fallback covers it; the reserve lines must be mapped), reserve_account_on_balance_sheet (both reserve lines map to a balance-sheet account) and currency_conversion_configured.

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".

split_at_month_end is frozen when the statement is recorded. parts lists what each part posts: one per earlier month (dated on its last day) and final (the rest, with the beginning balance and reserve). An unsplit statement has the single final part. Each line carries month_end_date (null for the last month).

Request​

Responses​

OK

Response Headers
    Content-Type