P&L

Buyer-side payment breakdown

What the CUSTOMER paid for each order x SKU, as opposed to what the seller earned: subtotal before and after discount, which party funded each discount, shipping, retail delivery fee and tax.

Paired to order lines on (order, SKU) to get a paid date, since this sheet carries none of its own. TikTok does not guarantee that pairing is 1:1, so a payment row with no matching order line falls outside the window rather than being invented into it.

post/pnl/customer-payments

Request body

start_datestring date nullable

Inclusive paid-date window start.

end_datestring date nullable

Inclusive paid-date window end.

product_idstring nullable

Filter to one product.

sku_idstring nullable

Filter to one SKU.

limitinteger

Page size.

offsetinteger

Page offset.

Response

Successful Response

shop_idinteger required
seller_idstring required
totalinteger required
limitinteger required
offsetinteger required

Changes

No recorded changes to this endpoint across all 2 revisions of this API.