A FREE TOOL FROM TIDYPAYOUTS

Settlement code
decoder.

A plain-English reference for the codes marketplace payout reports use. Search any Amazon amount type or description, any Etsy Payments ledger entry, or a TikTok Shop statement line, and see what it means, which way the money moved, and where it belongs in your books. Nothing to upload: it is a lookup, not a parser — the settlement analyzer reads files.

TidyPayouts is ecommerce bookkeeping software that maps these codes to your accounts automatically. This decoder is one of our free seller tools.

✓ Free, no sign-up✓ Works without JavaScript✓ Nothing leaves your browser

Find a code

Type a code, filter by marketplace or by the bookkeeping bucket it belongs in.

RUNS IN YOUR BROWSER

Amazon settlement reports — the Flat File V2 (24 columns) is the current format; Amazon removed the classic 19-column flat file on November 11, 2026. Amazon does not publish a dictionary of code values: entries below marked with an official note come from Amazon’s own Finances API or data dictionary; the rest are commonly documented by seller tools and observed in real files.

Order SalesEither sign

Revenue lines for a customer order: item price, shipping, gift wrap, their taxes, and the fees charged against that order. Charges post positive, fees within the same order post negative.

Transaction type · Official definition via Amazon’s old data dictionary; still the core transaction type in the current Flat File V2.

Refund RefundsEither sign

A refund issued to the customer. It reverses the order amounts and refunds some fees proportionally. A refund does not necessarily mean the item came back.

Transaction type · Commonly documented; wording follows seller-tools guides.

ServiceFee FeesDebits you

Amazon service charges not tied to a single item sale: subscription, storage, advertising and similar. Chargeback and guarantee lines can also appear under it in practice.

Transaction type · Commonly documented; one-word spelling seen in UK files.

Adjustment ReimbursementEither sign

Manual and programmatic adjustments: FBA inventory reimbursements, corrections and reserve movements. Each carries an adjustment-id.

Transaction type · Officially described through the Finances API adjustment events (FBAInventoryReimbursement, ReserveEvent, PostageBilling, PostageRefund).

Chargeback RefundsDebits you

A buyer dispute filed with their card issuer: funds are debited from your balance, and credited back if the dispute is won.

Transaction type · Definition from Amazon Pay’s official settlement documentation; occurrence in seller files is community-observed.

Guarantee (GuarantClaim) RefundsDebits you

An A-to-z Guarantee claim: Amazon decided a buyer claim against the seller and debited your balance. Reversals post if the decision changes.

Transaction type · Official A-to-z semantics via Amazon Pay docs; the GuarantClaim spelling is the historical form seen in files.

Transfer TransferDebits you

The payout itself — money sent to your bank account for this settlement. Its amount equals the negative of the settlement total.

Transaction type · Official definition in Amazon Pay settlement docs; same meaning in seller files.

Liquidations OtherEither sign

Proceeds from FBA Liquidation of unsellable inventory: a credit for the liquidation value, minus a processing fee.

Transaction type · Officially described as the FBALiquidationEvent in the Finances API.

ItemPrice SalesEither sign

The revenue components of a sale: principal, shipping, gift wrap, their taxes and COD charges. Positive on sales, negative on refunds.

Amount type · Official semantics via the Finances API charge components.

ItemFees FeesDebits you

Amazon fees charged against the sale: commissions, FBA fulfillment fees, closing fees, chargebacks of shipping or gift wrap, refund commissions. Positive only when a fee is refunded.

Amount type · Commonly documented; semantics corroborated by the Finances API.

Promotion SalesDebits you

Promotional discounts funded by you, the seller, including shipping promotions. Reduces the sale amount.

Amount type · Officially described via the Finances API promotion components.

ItemWithheldTax / MarketplaceFacilitatorTax-… Sales taxDebits you

Buyer sales tax that Amazon withholds and remits for you under marketplace facilitator rules. It offsets the positive Tax line so the tax never reaches your payout — the pair nets to zero.

Amount type · Official: the Finances API TaxWithheldComponent distinguishes MarketplaceFacilitator (Amazon remits) from Standard (paid to you).

Principal SalesEither sign

The selling price of the item, times quantity. Positive on a sale, negative on a refund.

Amount description · Official Finances API definition.

Tax Sales taxEither sign

Tax on the item price collected by you, the seller. Under the standard model the tax is paid to you and you remit it; under marketplace facilitator it is withheld back by the paired withheld-tax line.

Amount description · Official Finances API definition; the collection-model distinction is official too.

ShippingCharge SalesEither sign

The shipping charge the customer paid. On FBA orders this revenue is usually offset by an equal ShippingChargeback fee.

Amount description · Official Finances API definition.

ShippingTax Sales taxEither sign

Tax collected on the shipping charge. Like Tax, it is either paid to you or withheld by the facilitator offset.

Amount description · Official Finances API definition.

Giftwrap / GiftwrapTax SalesEither sign

Gift wrap charges and their tax. On FBA orders, offset by a GiftwrapChargeback fee.

Amount description · Official Finances API definitions.

Commission FeesDebits you

The referral fee: a percentage of the item value, charged against each sale. On refunds it comes back as RefundCommission.

Amount description · Definition from Amazon’s old data dictionary, reproduced by seller tools.

RefundCommission FeesCredits you

The original referral fee returned to you when the sale it was charged on is refunded.

Amount description · Definition from Amazon’s old data dictionary.

VariableClosingFee FeesDebits you

The per-item variable closing fee from the fee schedule, charged alongside the commission.

Amount description · Definition from Amazon’s old data dictionary.

FBAPerUnitFulfillmentFee FeesDebits you

The per-unit fee for FBA picking, packing and shipping — the main pick-and-pack line on FBA sales.

Amount description · Definition from Amazon’s old data dictionary.

FBAWeightBasedFee FeesDebits you

The weight-based shipping fee component of FBA fulfillment, based on the item’s outbound weight band.

Amount description · Definition from Amazon’s old data dictionary.

FBAperOrderFulfillmentFee FeesDebits you

A per-order fulfillment fee, charged once per order rather than per unit.

Amount description · Definition from Amazon’s old data dictionary.

FBATransportationFee FeesDebits you

The shipping cost of a Multi-Channel Fulfillment order — FBA fulfilling a sale made off Amazon.

Amount description · Definition from Amazon’s old data dictionary.

FBACustomerReturnPerOrderFee / PerUnitFee / WeightBasedFee FeesDebits you

Returns processing fees charged when customers return FBA items, in per-order, per-unit and weight-based variants (the returns fee family consolidated in the 2024 fee changes).

Amount description · Commonly reported values; no official public definition.

FBAInboundTransportationFee FeesDebits you

The transport fee for sending inventory inbound to FBA warehouses.

Amount description · Commonly reported; no official public definition.

ShippingChargeback FeesDebits you

For FBA orders: the shipping you charged the customer is reported as Shipping revenue, then charged back as a fee of the same amount — so the pair nets to about zero and Amazon keeps the shipping economics.

Amount description · Definition from Amazon’s old data dictionary.

GiftwrapChargeback FeesDebits you

Same mechanism as the shipping chargeback, for gift wrap: charged back so the gift wrap revenue nets to zero on FBA orders.

Amount description · Definition from Amazon’s old data dictionary.

StorageFee / StorageRenewalBilling FeesDebits you

Monthly storage for inventory in Amazon warehouses; StorageRenewalBilling is the billing-cycle line for monthly and long-term storage.

Amount description · Storage Fee from the old data dictionary; StorageRenewalBilling community-observed.

Subscription FeesDebits you

The professional seller subscription — for example the monthly fee on US Seller Central accounts.

Amount description · Commonly reported; no official public definition.

Current Reserve Amount ReserveDebits you

The reserve Amazon held back from this settlement to cover returns, claims and chargebacks. It is your money, deferred — not a fee.

Amount description · Definition from Amazon’s old data dictionary.

Previous Reserve Amount Balance ReserveCredits you

The release of the previous settlement’s reserve back into this payout. Paired with Current Reserve Amount, the two lines usually net to a small movement.

Amount description · Definition from Amazon’s old data dictionary.

ReserveEvent ReserveEither sign

A reserve event recorded when a settlement period closes: money held back, or an earlier hold released.

Amount description · Officially described as an adjustment type in the Finances API.

FBAInventoryReimbursement ReimbursementCredits you

Reimbursement for inventory lost or damaged in FBA warehouses. Since March 2025 these are paid at a cost basis — your manufacturing cost if provided, otherwise Amazon’s estimate. ALL-CAPS suffixes in the field state the reason.

Amount description · Officially described as an adjustment type in the Finances API; reason-suffix guidance from A2X.

PostageBilling / PostageRefund FeesEither sign

What you paid for shipping labels bought through Amazon Buy Shipping, and refunds of labels for canceled orders. The label purchase can also appear as Shipping label purchase.

Amount description · Official adjustment types in the Finances API; the label-purchase spelling is community-observed.

Goodwill RefundsDebits you

Money given to a buyer as goodwill compensation, not applied against a specific charge.

Amount description · Official Finances API definition.

RestockingFee SalesCredits you

A restocking fee charged to the buyer on certain returns, credited to you as part of the refund lines.

Amount description · Official Finances API definition.

SAFE-TReimbursement ReimbursementCredits you

The SAFE-T claim amount: an FBA refund issued without the returned item being received back.

Amount description · Official Finances API definition.

ReturnShipping / FreeReplacementReturnShipping RefundsDebits you

Return-shipping compensation to the buyer when Amazon is at fault, or for wrong-item free replacements.

Amount description · Official Finances API definitions.

PointsFee RefundsDebits you

The value of Amazon Points deducted from a refund.

Amount description · Official Finances API definition.

Discount / TaxDiscount / PromotionReimbursement SalesEither sign

Promotional discounts on the item, tax deductions from promotional rebates, and reimbursements of seller-funded promotions.

Amount description · Discount and TaxDiscount are official Finances API definitions; PromotionReimbursement is community-observed.

ExportCharge FeesDebits you

Export duty on Amazon Global shipments — a pass-through charge.

Amount description · Official Finances API definition.

PaymentMethodFee FeesDebits you

A fee for certain payment methods, charged in some marketplaces.

Amount description · Official Finances API definition.

DigitalServicesFee FeesDebits you

A digital services tax pass-through on marketplace-facilitated orders — the name is seen in UK files.

Amount description · Community-observed; no official public definition.

MarketplaceFacilitatorVAT-Principal / -Shipping Sales taxDebits you

UK and EU VAT that Amazon withheld and remitted for you as marketplace facilitator. It offsets the corresponding VAT revenue line.

Amount description · Community-observed spelling; mechanism officially described in the Finances API.

BASalesTaxCollectionFee FeesDebits you

A fee Amazon charges for collecting US sales tax on your behalf.

Amount description · Community-observed; no official public definition.

COOPAdvertising FeesDebits you

Co-operative advertising deductions — marketing charges Amazon applies to the balance.

Amount description · Community-observed; no official public definition.

FBADisposalBenefit / DisposalComplete OtherEither sign

Credits from the FBA disposal benefit program and completion lines for disposal orders.

Amount description · Community-observed; no official public definition.

ShippingHB FeesDebits you

A shipping handling fee line seen in EU and UK files.

Amount description · Community-observed; no official public definition.

Capture / RefundCharge / FXTransfer / ABARefund TransferEither sign

Card capture, refund-linked charge, currency-conversion transfer and US ACH transfer or refund. Definitions are inferred from the token names — no official public documentation exists for them.

Transaction type · Community-observed tokens; treat as unverified.

The Etsy Payments ledger — sales add to your balance while fees, refunds and labels subtract; deposits are paid from the current balance on your schedule. Exact ledger Type strings are not officially published, so the entries follow the fee and deposit mechanics Etsy documents.

Sale / order payment SalesCredits you

The buyer payment for the order — item price, shipping and gift wrap as applicable. Sales add to your payment account balance.

Ledger entry · Official Etsy Payments deposit documentation.

Listing fee FeesDebits you

$0.20 per listing, including automatic renewals of expired or sold listings and private listings; multi-quantity listings renew at $0.20 each.

Ledger entry · Official Etsy fee schedule.

Transaction fee FeesDebits you

6.5% of the total order amount in the listing currency — item price, shipping and gift wrap all count toward the base.

Ledger entry · Official Etsy fee schedule.

Payment processing fee FeesDebits you

The Etsy Payments processing fee: a fixed amount plus a percentage of the total sale price including shipping and sales tax, set per country.

Ledger entry · Official Etsy fee schedule.

Regulatory operating fee FeesDebits you

A percentage of the order total charged in some countries — currently the UK, France, Italy, India, Spain, Türkiye, Vietnam and Canada — excluding tax Etsy itself collects.

Ledger entry · Official Etsy fee schedule.

Offsite Ads fee FeesDebits you

The fee on an order attributed to an Offsite Ad: 15% for smaller shops, 12% once a shop passes $10,000 of revenue in 365 days, capped at $100 per order.

Ledger entry · Official Etsy fee and Offsite Ads documentation.

Etsy Ads FeesDebits you

Your chosen spend for on-site Etsy Ads. Marketing fees not tied to a sale come out of the current balance when charged.

Ledger entry · Official Etsy fee documentation.

Sales tax / VAT collected Sales taxEither sign

Buyer-paid tax shown as part of the payment and then subtracted back out: Etsy collects and remits it as a facilitator where applicable, so it passes through rather than becoming your liability.

Ledger entry · Official Etsy fee basics.

Shipping label FeesDebits you

Purchase of an Etsy shipping label, plus carrier adjustments and label insurance when they occur.

Ledger entry · Official Etsy payment-account documentation.

Refund RefundsDebits you

Funds returned to the buyer, full or partial, reversing the sale and usually its fees. Refunds before a deposit draw the payment account balance down.

Ledger entry · Official Etsy payment-account documentation.

Dispute / chargeback RefundsDebits you

A buyer-initiated card dispute: funds are held or debited while the dispute is decided, and a reserve can be triggered.

Ledger entry · Etsy documents disputes in its payments policy; the exact ledger line naming is practitioner-observed.

Deposit / disbursement TransferDebits you

The payout itself, on your deposit schedule. In the ledger it is its own category and posts negative, because the money is leaving the payment account.

Ledger entry · Sign convention practitioner-observed; deposit mechanics are official.

Currency conversion fee FeesDebits you

2.5% when funds are converted into a different payout currency.

Ledger entry · Official Etsy fee schedule.

Deposit fee FeesDebits you

Charged in certain countries when a deposit is above the minimum but below the fee threshold.

Ledger entry · Official Etsy fee schedule.

Adjustment OtherEither sign

Etsy-initiated corrections such as fee adjustments or currency true-ups.

Ledger entry · Generic category; no published vocabulary.

Funds availability (reserve) ReserveEither sign

A percentage of each physical-item sale sits in the pending balance until valid tracking shows the order in transit, or a default period passes. Released funds become available at 6pm ET; digital items are never reserved.

Concept · Official Etsy payment-account reserve documentation.

TikTok Shop US settlement statements — generated daily, covering orders settled after delivery. Fee-field names below come from TikTok’s official API vocabulary; the US commission is 6% for most categories.

PAYMENT SalesCredits you

A payment transaction: the customer payment for an order. TikTok settles an order after it is delivered and no refund request is open.

Statement type · Official TikTok Shop OpenAPI finance types.

REFUND RefundsDebits you

A refund transaction to the customer.

Statement type · Official TikTok Shop OpenAPI finance types.

SETTLE TransferCredits you

The platform settling the order amount to the seller after the delivery-based clearing window.

Statement type · Official TikTok Shop OpenAPI finance types.

WITHDRAW TransferDebits you

Your withdrawal of the settled balance to the bank. Failed withdrawals reverse back as REVERSE lines.

Statement type · Official TikTok Shop OpenAPI finance types.

TRANSFER OtherEither sign

A platform subsidy or deduction under platform policies — the adjustment line.

Statement type · Official TikTok Shop OpenAPI finance types.

REVERSE OtherCredits you

Reversal of a failed withdrawal, usually caused by incorrect bank details.

Statement type · Official TikTok Shop OpenAPI finance types.

referral_fee_amount FeesDebits you

The marketplace commission. In the US it is 6% of the fee base for most categories, 5% for precious jewelry and pre-owned, and 3% on portions of a sale above $10,000 for pre-owned and collectibles. The base is the customer payment plus platform-funded discounts, minus tax.

Fee line · Official TikTok Shop fee policy and category table.

refund_administration_fee_amount FeesDebits you

The fee retained when an order is refunded: 20% of the referral fee per SKU, capped at $5 per SKU since May 2025.

Fee line · Official TikTok Shop fee policy.

affiliate_commission_amount FeesDebits you

The creator or affiliate commission you set — typically 10-20% of the sale — including the variant lines for partner and ads-driven affiliates.

Fee line · Official OpenAPI field; typical range is third-party reported.

transaction_fee_amount FeesDebits you

A transaction or payment-handling fee line that exists in the API and in some markets. TikTok’s current US policy says the referral fee covers all platform fees except shipping and tax, so treat a US transaction-fee line with caution and check your own statements.

Fee line · Official field; conflicting third-party claims about a US 2% + $0.30 fee are unverified.

fbt_fulfillment_fee_amount FeesDebits you

The Fulfilled by TikTok fulfillment fee, with a matching reimbursement line when TikTok refunds it.

Fee line · Official OpenAPI fields.

sfp_service_fee_amount FeesDebits you

The Ship by TikTok service fee for orders fulfilled through that program.

Fee line · Official OpenAPI field.

mall / flash sales / voucher Xtra / GMV Max fees FeesDebits you

Optional program service fees: Mall participation, flash sales, pre-order, voucher Xtra, smart promotions, co-funded promotions and creator bonuses, GMV Max advertising.

Fee line · Official OpenAPI fields.

sales_tax_amount / vat_amount / gst_amount Sales taxEither sign

Taxes collected or accounted for at settlement, plus the tax-related referral fee line where it applies. Marketplace-collected tax passes through rather than becoming your expense.

Tax line · Official OpenAPI fields.

reserve_amount (COLLECTED / RELEASED) ReserveEither sign

A share of the sale held to cover refunds. COLLECTED means withheld; RELEASED means paid out. Reserves run on a thirty-day window from delivery with three reserve levels.

Reserve line · Official OpenAPI fields and the dynamic settlement and reserve policy.

seller_discount_amount / platform_discount_amount SalesEither sign

Who funded a discount: seller-funded discounts reduce your revenue and the fee base; platform-funded discounts count toward the referral-fee base even though you never received that money.

Revenue line · Official OpenAPI fields and the referral-fee formula.

Coverage is strongest for Amazon flat-file settlements (the Settlement V2 report) and reflects codes as documented by Amazon and seen in real reports; marketplaces add new codes from time to time, and regional reports can differ. Signs are typical, not guaranteed — a reversal flips the direction of the original line.

WHY IT MATTERS.

A settlement is a ledger
written in shorthand.

Read the bookkeeping guides
or try the other free tools.

Why the codes are cryptic

Amount descriptions like FBACustomerReturnPerUnitFulfillmentFee were written for machines, not for sellers. Each one names a program, a fee family or an internal adjustment, and none of them say where the money goes in your books. Decoded, each code maps to one of seven buckets — sales, refunds, fees, sales tax collected for you, reimbursements and credits, reserve movements, and transfers — and each bucket maps to an account in your chart of accounts.

From code to entry

Once every line has a bucket, a payout stops being one confusing deposit and becomes the same journal entry every time: income net of refunds, fee groups as expenses, sales tax as a liability you owe the state, reimbursements as other income, and reserves as money that is yours but not yet in the bank. The journal entry builder produces that entry from a payout, and the chart of accounts generator creates the accounts to receive it.

COMMON QUESTIONS.

Quick answers.

Want these codes mapped to your accounts automatically? That is TidyPayouts ↗

Which marketplaces does the decoder cover?+

Amazon flat-file settlement reports (the Settlement V2 report), the Etsy Payments ledger, and TikTok Shop US settlement statements. Amazon coverage is the deepest because its report format is documented and widely shared; Etsy and TikTok Shop entries cover the ledger and statement lines sellers reconcile most often. Reports differ by region, so a code can behave slightly differently outside the US.

Where do I find these codes in my own reports?+

Amazon: request the Settlement flat file V2 from the Payments report in Seller Central, and look at the amount-type and amount-description columns. Etsy: download the CSV ledger from Shop Manager. TikTok Shop: open Statements in Seller Center and export the settlement detail. The decoder matches the code values exactly as those exports spell them.

What does the bookkeeping bucket on each card mean?+

It is the account family the line usually posts to: product sales, refunds and allowances, marketplace fee expense, sales tax collected for you, reimbursements and other income, reserve movements as money owed to or held by the marketplace, and bank transfers including the payout itself. Fee detail can stay grouped or split further — the chart of accounts generator shows a common split.

Does this tool read my settlement file?+

No. The decoder is a searchable reference: nothing is uploaded and nothing is parsed. If you want a file read, the settlement analyzer and the payout analyzer parse reports entirely in your browser and reconcile them to the cent.

DECODED ONCE. MAPPED EVERY TIME.

Every code, in the
right account, already.

TidyPayouts turns these codes into clear, reviewable entries — without you reading the shorthand.

Join the free beta →Free during beta. No credit card.