Marketplace Seller Fees (VN) API
Seller fees per order on Shopee, TikTok Shop and Lazada Vietnam: category fee, transaction fee, programmes, tax withheld, break-even and target price.
The marketplace fee API computes what a Vietnamese seller really keeps from an order on Shopee, TikTok Shop or Lazada. Send platform, price, cost and the product category in plain words (son môi, áo thun, laptop) or your own fixed_fee_rate: the API finds the category rate (TikTok Shop: the official level-3 table valid from 03/07/2026 for standard shops and 03/08/2026 for Mall; Shopee: the level-1 ranges since 23/05/2026 and 29/05/2026, upper bound by default), then adds the transaction fee (6% on price after seller discounts plus buyer-paid shipping), per-order fees (3,000 đ), optional programmes (voucher_xtra, piship, Lazada freeship_max, capped per item), affiliate_rate, ads_rate and other_costs.
Household and individual sellers also see the tax the platform withholds under Decree 117/2025/ND-CP (goods 1% VAT + 0.5% PIT; services 5% + 2%; transport and goods-linked services 3% + 1.5%), refundable when yearly revenue stays under 1 billion VND; companies are not withheld (seller_type=company). The answer has the fee lines, payout, profit and margin at your price, the break-even price, and with target_margin the price that reaches it. GET ?platform=tiktok&categories=son môi only looks up a category rate.
Rates are hand-entered from the platforms' public fee pages and notices, with the table version and review date in every answer; a weekly job hashes those pages to flag changes. Platforms change fees often and Lazada publishes its category table only in Seller Center: every rate can be overridden.
Parameters
| Name | In | Type | Required | Default | |
|---|---|---|---|---|---|
platform | body|query | string | yes | shopee, tiktok or lazada (none: overview of rates). | |
price | body|query | number | no | Selling price per unit, VND. | |
cost | body|query | number | no | Cost per unit, VND (for profit, break-even, target price). | |
category | body|query | string | no | Product category in words (Shopee, TikTok Shop). | |
fixed_fee_rate | body|query | number | no | Your category fee / commission in % (overrides the table). | |
shop_type | body|query | string | no | normal | normal or mall (Shopee Mall, TikTok Shop Mall, LazMall). |
quantity | body|query | number | no | 1 | Units in the order. |
seller_discount | body|query | number | no | Discount funded by the shop for the order, VND. | |
buyer_shipping | body|query | number | no | Shipping paid by the buyer (in the transaction-fee base). | |
voucher_xtra | body|query | boolean | no | Join Voucher Xtra (Shopee, TikTok Shop); a number sets the rate. | |
piship | body|query | boolean | no | Shopee PiShip shipping package. | |
freeship_max | body|query | boolean | no | Lazada Freeship Max; a number sets the rate. | |
affiliate_rate | body|query | number | no | Affiliate commission %. | |
ads_rate | body|query | number | no | Advertising cost as % of sales. | |
other_costs | body|query | number | no | Other costs per order (packaging…), VND. | |
seller_type | body|query | string | no | household | household, individual (tax withheld) or company. |
tax_category | body|query | string | no | goods | goods, services or goods_services. |
target_margin | body|query | number | no | Wanted profit margin % of net sales: returns suggested_price. | |
categories | query | string | no | GET only: look up category rates (son môi, or 1 for the list). |
Example
curl -X POST "https://apibox.io.vn/v1/vn-marketplace-fees" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"tiktok","price":250000,"cost":120000,"category":"son môi","target_margin":20}'const res = await fetch('https://apibox.io.vn/v1/vn-marketplace-fees', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"platform": "tiktok",
"price": 250000,
"cost": 120000,
"category": "son môi",
"target_margin": 20
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-marketplace-fees",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"platform": "tiktok", "price": 250000, "cost": 120000, "category": "son môi", "target_margin": 20},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-marketplace-fees');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"platform":"tiktok","price":250000,"cost":120000,"category":"son môi","target_margin":20}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Response
{
"platform": "tiktok",
"platform_name": "TikTok Shop",
"shop_type": "normal",
"category": {
"level": 3,
"path": [
"Chăm sóc sắc đẹp & Chăm sóc cá nhân",
"Trang điểm",
"Son môi & Son bóng"
],
"rate": 15.5,
"range": null,
"alternatives": []
},
"rates": {
"fixed_fee": 15.5,
"transaction_fee": 6,
"programmes": [],
"per_order": [
{
"code": "order_processing",
"name_vi": "Phí xử lý đơn hàng",
"amount": 3000
}
],
"affiliate": 0,
"ads": 0,
"effective": {
"commission": {
"normal": "2026-07-03",
"mall": "2026-08-03"
},
"transaction": "2026-05-09"
}
},
"tax": {
"seller_type": "household",
"withheld": true,
"category": "goods",
"vat_rate": 1,
"pit_rate": 0.5,
"decree": "117/2025/NĐ-CP",
"effective_from": "2025-07-01",
"reviewed": "2026-11-11"
},
"at_price": {
"price": 250000,
"units": 1,
"gross": 250000,
"seller_discount": 0,
"net_sales": 250000,
"buyer_shipping": 0,
"fees": [
{
"code": "commission",
"name_vi": "Phí hoa hồng nền tảng",
"rate": 15.5,
"base": 250000,
"amount": 38750
},
{
"code": "transaction_fee",
"name_vi": "Phí giao dịch",
"rate": 6,
"base": 250000,
"amount": 15000
},
{
"code": "order_processing",
"name_vi": "Phí xử lý đơn hàng",
"amount": 3000
}
],
"fee_total": 56750,
"fee_percent": 22.7,
"tax_withheld": {
"vat": 2500,
"pit": 1250,
"total": 3750
},
"payout": 189500,
"cost": 120000,
"profit": 69500,
"margin_percent": 27.8
},
"break_even_price": 159740,
"target_margin": 20,
"suggested_price": 215789,
"warnings": [],
"fee_table_version": "2026-11",
"reviewed": "2026-11-11",
"review_cadence": "monthly"
}Use cases
- Price products in multichannel selling software
- Show net payout per order in seller dashboards
- Compare Shopee, TikTok Shop and Lazada margins
- Estimate tax withheld by platforms for household sellers
FAQ
How current are the rates?
Reviewed monthly; each answer has fee_table_version and reviewed. A weekly script compares the public fee pages and flags any change for review.
Do platforms deduct tax for me?
Yes for households and individuals: since 01/07/2025 (Decree 117/2025) platforms with payment withhold VAT and PIT per order; sellers under 1 billion VND a year can get it back.
Why is the Shopee rate a range?
Shopee sets the fixed fee per level-3 category; the API knows the level-1 ranges and uses the upper bound unless you pass fixed_fee_rate.
Related APIs
JSON Validator
Check JSON syntax with exact line and column of errors, and validate data against a JSON Schema (draft 4, 7, 2019-09 or 2020-12).
{ }JSON Formatter
Pretty print JSON with 0-8 spaces or tabs, minify it, or sort object keys recursively. Syntax errors are reported with line and column.
CSVCSV to JSON
Convert CSV into an array of JSON objects using the header row, with delimiter auto-detection, number and boolean typing, and row-level errors.