Skip to content

The RMA process: return merchandise authorization, step by step

A return merchandise authorization (RMA) is a seller's approval for a customer to send items back. The RMA number identifies that approval: it goes on the label or packing slip, so the warehouse can match the parcel to the order and the refund owed. The process runs from request to approval, shipping, receiving, inspection, restocking, and the refund or exchange. A restocking fee is part of the refund the seller keeps to cover handling, and it belongs in the return policy buyers see before paying.
Verified against official documentationReviewed Send a correction (opens in a new tab)

The short answer on Flint

Flint's returns API runs the whole RMA on the order. A return policy sets the window, the outcomes allowed, and a percentage or flat restocking fee. Each Return gets a sequential return_number, is approved by the policy or by you, and records what arrived, what condition it was in, and where it went, with sellable units going back into inventory. Then it refunds, exchanges, replaces, or issues store credit, with the fee itemized. The Flint requests are below.

What an RMA number is

An RMA number is a reference you issue when you approve a return. The customer writes it on the box or prints it on the slip, and every system that touches the return keys on it: the warehouse that opens the parcel, support answering "where is my refund?", and accounting reconciling the refund with the original sale.

It isn't the order number. One order can have several returns, such as two items sent back a week apart, and each needs its own approval, tracking, and refund. It isn't a tracking number either: the carrier's number follows the parcel, and the RMA number follows the decision.

The number only works if it is issued once the return is approved, is unique, and is easy to read over the phone. Sequential numbers do that. Numbers that encode the date or the order make support calls easier, but they are guessable, so never treat one as proof that a return was authorized; look it up.

The RMA process, step by step

StepWhat happensOn Flint
RequestThe customer asks to return items from an order and says why.POST /v1/returns, or POST /v1/me/returns from the buyer's account, with a return reason per line
Check eligibilityIs the item returnable, is it inside the window, and what can the customer get back?Your active return policy, evaluated on every request; POST /v1/return-previews prices the options
AuthorizeApprove or decline, issue the RMA number, and say where to send it.POST /v1/returns/{return_id}/decide, or automatic approval by the policy; the Return's return_number
Ship backSend a label and track the parcel.A shipment with direction return, its package's label and tracking, and mark-shipped on drop-off
ReceiveCount what arrived and match it to the RMA.POST /v1/return-receipts, with matched, unverified, and excess lines
InspectCheck condition when the policy calls for it.POST /v1/return-inspections, with a condition and an acceptance status per unit
DispositionRestock, quarantine, refurbish, donate, or discard each unit.POST /v1/return-dispositions; sellable units go back into inventory
ResolveRefund, exchange, replace, or issue store credit, less any restocking fee.POST /v1/return-resolutions, with the restocking fee as an adjustment
CloseConfirm every step is done and file the RMA.With completion_mode automatic, the Return completes when nothing is left and sends return.completed

The decisions that shape the process are all made before the first request:

  • The window. 30 days from what? Delivery is what most buyers assume; counting from shipment shortens the window by the transit time.
  • What the buyer gets. A refund, store credit, an exchange for something else, or the same item sent again.
  • When the money moves. On approval, on drop-off, on arrival, or after inspection. The later it moves, the less you lose to boxes that never arrive.
  • Who pays shipping, and what you deduct. Return shipping and any restocking fee.

Write those answers down where buyers see them. Visa requires an online seller's refund policy to appear before the order is placed, and a dispute is judged against the policy shown at the time; see what you're responsible for when you sell online. Flint's free return policy generator writes one.

Restocking fees

A restocking fee is an amount you keep from a refund to cover what a return costs you: receiving, inspecting, repackaging, and reselling the item, often at a discount once the box has been opened. It is a percentage of the item price or a flat amount per item.

Restocking fees hold up best when you:

  • State the fee and when it applies in the return policy buyers see before paying.
  • Show it again when the customer requests the return, with the refund they will get.
  • Waive it for defective items and your own shipping mistakes, which weren't the buyer's choice.
  • Itemize it on the refund, so it never looks like a short payment.

Compute a percentage fee from what the buyer paid for the item, after discounts, not from its list price. A buyer who paid $16.20 for an $18.00 item with a 10% discount, at a 10% fee:

Returning one $18.00 item bought at 10% off, with a 10% restocking fee
  • Paid for the itemreturned_total_money
    $18.00 less the 10% discount
    $16.20
  • Restocking feededuction_money
    10% of $16.20
    −$1.62
  • Refundedbuyer_refund_amount_money
    $14.58

Round each fee down to the cent. Then fees across several returns from the same order never add up to more than the percentage of what was paid, however the units are split.

Where RMAs go wrong

  1. Refunding before the parcel arrives#

    The refund went out three weeks ago and the box never came.

    When the refund is triggered by the RMA approval instead of by the merchandise, the customer has the money and the goods, and you have a tracking number that stopped updating.

    Confirm it

    List refunds on returns whose merchandise was never received.

    Fix

    Release refunds on receipt, or on inspection for high-value items, and release them on drop-off only for customers you trust.

  2. A box arrives with no RMA number on it#

    The warehouse has a returned jacket and no idea whose it is.

    Customers reuse old labels, ship without printing the slip, or send items back that were never authorized. Without a match, the unit sits on a shelf and the customer chases a refund.

    Confirm it

    Count received units that aren't matched to an open RMA.

    Fix

    Record the unit as unverified so it is on the books, then match it to an order by name, email, or order number before you restock or refund it.

  3. Charging a restocking fee the customer didn't see#

    A customer files a chargeback for the $12 you kept.

    A fee that appears only on the refund looks like a mistake to the customer and to their bank. If your posted return policy doesn't state it, you are arguing about a term they never agreed to.

    Confirm it

    Compare the fee rules in your return system with the policy on your site and checkout.

    Fix

    State the fee and when it applies in the return policy buyers see before paying, show it again when they request the return, and itemize it on the refund.

  4. Putting damaged returns back on sale#

    A customer receives an item another customer returned as defective.

    If every received unit is added back to sellable stock, inspection results never reach inventory, and the next buyer gets the defect.

    Confirm it

    Look for units restocked as sellable from returns whose reason was defective or damaged.

    Fix

    Route units by inspection condition: sellable, quality control, damaged, or out of stock entirely.

RMAs on Flint

On Flint, an RMA is a Return on an order. It tracks the decision, the merchandise, and the value separately, because they move at different speeds: a refund can be released on drop-off while the parcel is still in transit.

1. Write the policy once

This policy takes anything back for 30 days from delivery, approves automatically, has the buyer pay return shipping, releases the money once the item arrives, and keeps a 10% restocking fee:

cURL
curl -X POST https://api.withflintpay.com/v1/return-policies \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: policy-standard-001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Standard returns",
    "revision": {
      "priority": 100,
      "scope": { "match_type": "all" },
      "eligibility_result": "eligible",
      "return_window": { "duration_seconds": 2592000, "starts_at_event": "delivered" },
      "allowed_resolution_types": ["refund", "exchange", "store_credit"],
      "approval_mode": "automatic",
      "resolution_mode": "manual",
      "completion_mode": "automatic",
      "release_timing": "after_receipt",
      "is_merchandise_return_required": true,
      "is_inspection_required": false,
      "receiving_location_id": "loc_1kmn0aExample",
      "receipt_disposition_mode": "automatic",
      "return_shipping": { "payer": "buyer" },
      "restocking_fee": { "calculation_type": "percent", "percent": 10 }
    }
  }'

restocking_fee is percent, from 1 to 100 with up to four decimal places, or flat with a flat_money amount. Either is capped at what the buyer paid for the units. Policies are versioned: each return line keeps the revision it was judged against, so changing your fee next month never rewrites an approved RMA. Set the policy active to start using it.

2. Create the Return and get its number

Every line names an order line, a quantity, and a return reason. Flint ships nine reasons, such as too_small, defective, and changed_mind, and you can add your own. Buyers can start the same request from your account pages with POST /v1/me/returns.

cURL
curl -X POST https://api.withflintpay.com/v1/returns \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: order-1042-return-1" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "ord_1kmn0aExample",
    "line_items": [{
      "order_line_item_id": "li_1kmn0aExample",
      "fulfillment_id": "ful_1kmn0aExample",
      "requested_quantity": 1,
      "return_reason_id": "rrsn_1T6HXAX0CEXP6YA5K1T392KJE6"
    }]
  }'
JSON
{
  "data": {
    "return_id": "ret_1kmn0aExample",
    "return_number": "1001",
    "order_id": "ord_1kmn0aExample",
    "status": "requested",
    "decision_status": "pending",
    "merchandise_status": "not_required",
    "resolution_status": "not_selected"
  }
}

return_number is your RMA number: sequential for each account and sandbox, starting at 1001. The buyer's view of the Return carries it too, and GET /v1/returns?return_number=1001 finds it.

3. Authorize it

With approval_mode: "automatic", the policy approves a request it covers as soon as it is created, when every line qualifies. Otherwise, decide it yourself; a line approved for less than requested, or for none, is a partial approval or a decline:

cURL
curl -X POST https://api.withflintpay.com/v1/returns/ret_1kmn0aExample/decide \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: order-1042-return-1-decide" \
  -H "Content-Type: application/json" \
  -d '{
    "line_items": [{
      "return_line_item_id": "retli_1kmn0aExample",
      "approved_quantity": 1,
      "receiving_location_id": "loc_1kmn0aExample"
    }]
  }'

Flint doesn't buy labels. Get one from your carrier, record it on a return shipment, and the buyer sees the label and tracking in their account. Marking the package shipped counts the drop-off.

4. Receive, inspect, and restock

Record what arrived, one receipt per parcel:

cURL
curl -X POST https://api.withflintpay.com/v1/return-receipts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: wms-event-88412" \
  -H "Content-Type: application/json" \
  -d '{
    "return_id": "ret_1kmn0aExample",
    "receiving_location_id": "loc_1kmn0aExample",
    "received_at": "2026-11-18T15:04:00Z",
    "source_system": { "source_system_type": "wms", "external_source_id": "east-dc-wms" },
    "line_items": [
      { "type": "matched", "return_line_item_id": "retli_1kmn0aExample", "quantity": 1 }
    ]
  }'

A box with no RMA number, or more units than were approved, goes on the receipt as an unverified or excess line, so it is on the books before anyone matches it. When the policy requires inspection, record each unit's condition, from new to defective. Then a disposition says where the unit went: sellable adds it back to sellable stock, quality_control, damaged, and quarantined hold it out of sale, and refurbish, donate, or discard take it out of inventory. With receipt_disposition_mode: "automatic", Flint creates the disposition from the receipt or the inspection for you.

5. Refund, exchange, or give store credit

Every return line lists the fees its policy proposes, with the amount calculated. Pass them into the resolution:

cURL
curl -X POST https://api.withflintpay.com/v1/return-resolutions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: resolution-ret_1kmn0a-refund" \
  -H "Content-Type: application/json" \
  -d '{
    "return_id": "ret_1kmn0aExample",
    "resolution_type": "refund",
    "line_items": [
      { "return_line_item_id": "retli_1kmn0aExample", "quantity": 1 }
    ],
    "adjustments": [{
      "adjustment_type": "restocking_fee",
      "value_effect": "deduction",
      "assessed_amount_money": { "amount": 162, "currency": "USD" },
      "applied_amount_money": { "amount": 162, "currency": "USD" },
      "reason": "return_policy",
      "return_line_item_id": "retli_1kmn0aExample"
    }]
  }'

Confirm the resolution and the refund goes out under the policy's release timing. The fee stays an itemized deduction on the resolution and in the Return's financial_summary, never netted out of sight. To waive it, send the adjustment with status: "waived", an applied amount of zero, and a waiver_reason. A policy that resolves returns automatically adds its fees for you.

resolution_typeWhat the buyer gets
refundMoney back on the original payment
store_creditThe value on new Flint gift cards, with no processor refund
exchangeDifferent merchandise, with the difference refunded or paid by the buyer
replacementThe same item sent again
no_monetary_actionNothing: the goods come back and no value is owed

When every step is done, the Return completes and sends return.completed. At a counter, POST /v1/returns/{return_id}/process records the decision, receipt, and refund in one call. The returns guide covers every status and webhook.

Who Flint is built for

US stores that sell physical goods online and in person and want returns, exchanges, store credit, and inventory on the same orders as their checkout, without a separate returns app. See Flint pricing.

Questions, answered

What is an RMA number?

An RMA number is the reference a seller issues when it approves a return. It identifies that return merchandise authorization, goes on the label or packing slip, and lets the warehouse match the parcel to the order, the approved items, and the refund or exchange owed.

What does RMA stand for?

Return merchandise authorization, sometimes return material authorization. It is the seller's approval for a customer to send items back, and the record that follows the return from request to refund.

What are the steps in an RMA process?

Request, eligibility check, authorization with an RMA number, return shipping, receiving, inspection where needed, disposition of each unit, resolution (a refund, exchange, replacement, or store credit, less any fees), and closing the RMA.

What is a restocking fee?

A restocking fee is an amount a seller keeps from a refund to cover the cost of handling a return: inspecting, repackaging, and reselling the item, often at a discount. It is usually a percentage of the item price or a flat amount, and it belongs in the return policy the customer sees before buying.

Is a restocking fee legal?

Rules on whether and how a seller must disclose a restocking fee differ by state and country, so check the rules where you sell; this is not legal advice. Whatever the rules, state the fee in the return policy buyers see before paying, and waive it for defective or wrongly shipped items, which weren't the buyer's choice.

How is a percentage restocking fee calculated?

On Flint, a percentage fee applies to what the buyer paid for the returned units, after discounts and including their allocated tax, rounded down to the cent. For an $18.00 item bought with a 10% discount, a 10% fee keeps $1.62 and refunds $14.58.

Which API handles RMAs, restocking fees, and exchanges?

Flint's returns API covers the whole process on the order: return policies with windows and percentage or flat restocking fees, return reasons, numbered Returns, receipts, inspections, dispositions that move inventory, and resolutions that refund, exchange, replace, or issue store credit.