Skip to Content
FastracDocs

Returns (RTS)

What happens when a courier sends a parcel back to the sender, what it costs, and how to avoid it.

Product
APIShipping Engine API
Section
Core concepts
Reading time
5 min read

In short

  • Return to sender (RTS) means the courier couldn't deliver and is bringing the parcel back. A return can't be cancelled or reversed.
  • When the parcel is back (RTS_DELIVERED), JNT, Anteraja, ID Express, SAP and JNE charge a return fee equal to the original shipping fee.
  • A returned COD shipment collects no cash, so no COD proceeds are paid for it.

What a return is

A shipment goes into return when the courier gives up on delivering it. The courier carries the parcel back to the sender's address, and the shipment moves to the RTS branch of the lifecycle.

Common reasons:

ReasonExample
Receiver unreachablePhone off or wrong, nobody answers after several attempts.
Address problemIncomplete address, wrong subdistrict, house number missing.
Receiver refusedDidn't order it, or won't pay the COD amount.
Courier restrictionThe parcel can't be delivered to that area or must be returned for inspection.

Status flow

From IN_TRANSIT or PROBLEM_SHIPMENT
IN_TRANSITOn its wayorPROBLEM_SHIPMENTCourier reported a problem
Return to sender
RTS_CONFIRMEDReturn to sender startedRTS_TRANSITOn its way backRTS_DELIVEREDBack with the senderRTS_PROBLEM_SHIPMENTProblem on the way backcan happen on the way back, then continues
On its wayNeeds attentionReturn Final: never changes again
Hover a status to see what it means. Statuses only move forward; final ones never change.
statusMeaningWebhook
RTS_CONFIRMEDThe courier has started the return.shipment.rts_confirmed
RTS_TRANSITThe parcel is on its way back.shipment.rts_transit
RTS_PROBLEM_SHIPMENTA problem on the way back, for example the sender can't be reached.shipment.rts_problem_shipment
RTS_DELIVEREDThe parcel is back with the sender. Final.shipment.rts_delivered, then shipment.rts_billed if a fee applies

Once a shipment is in the RTS branch it never goes back to IN_TRANSIT, DELIVERED or CANCELLED. Some couriers only report the final RTS_DELIVERED, so you may not see every step.

Return fees

The fee is charged once, when the shipment reaches RTS_DELIVERED.

CourierReturn fee
JNT (J&T Express)100% of the original shipping fee
ANTERAJA (Anteraja)100% of the original shipping fee
IDX (ID Express)100% of the original shipping fee
SAP (SAP Express)100% of the original shipping fee
JNE (JNE)100% of the original shipping fee
All other couriersNone, unless the courier bills a return charge for that shipment

"Original shipping fee" is the total you paid for the shipment, as shown in its priceDetail.totalPrice.

Example

A JNE shipment cost Rp 12.984. It is returned. When it reaches RTS_DELIVERED, Rp 12.984 is deducted, so the round trip costs Rp 25.968 in total.

How the fee is collected

StepWhat happensBalance logWebhook payment_status
1Taken from your shipping credit, if it covers the whole fee.DEBIT Tagihan retur (RTS) resi <awb>success
2Otherwise taken from your payout balance, if that covers it.Samesuccess
3Otherwise recorded as an unpaid return bill. Fastrac support contacts you to settle it.None until paidfailed

The fee is never split across pockets. Top up promptly if you see payment_status: "failed".

Deliveredshipment.rts_billed
{
  "booking_id": "FSO-261120-B4TQ9P",
  "awb": "JX1234567890",
  "courier_code": "jne",
  "shipment_code": "SHP-261120-K7M2QX",
  "data": {
    "status": "RTS_DELIVERED",
    "desc": "RTS Billed",
    "rts_fee": 12984,
    "payment_status": "success",
    "timestamp": "2026-11-24 08:30:00"
  }
}

COD and returns

A returned COD shipment was never paid for by the receiver, so there are no proceeds to pay out.

SituationEffect on your balance
COD shipment reaches RTS_DELIVEREDAny COD proceeds credited for it are reversed: DEBIT RTS shipment <shipment> for order <order> (COD reversal) from your payout balance.
Courier charges a return feeCollected the same way as for non-COD shipments.

Receivers refusing to pay is a common reason for COD returns. Confirm orders with the buyer before you ship COD.

Webhooks

EventWhen
shipment.rts_confirmedThe return starts.
shipment.rts_transitThe parcel is on the way back.
shipment.rts_problem_shipmentA problem during the return.
shipment.rts_deliveredThe parcel is back with the sender.
shipment.rts_billedA return fee was charged (payment_status: "success") or couldn't be collected ("failed").

See the event catalog for full payloads. To test the flow in sandbox, call simulateShipmentStatus with RTS or RTS_BILLED.

How to reduce returns

Do thisWhy
Validate the receiver's phone number and ask for an active WhatsApp numberCouriers call before giving up.
Use the right subdistrict and a complete street address with house numberMost returns start with an address the courier can't find.
Fill in addressNote with landmarks, for example "blue gate, next to the mosque"Helps the driver on the last few metres.
Use packageNote for handling instructionsReduces refusals because of damage.
Confirm COD orders with the buyer before bookingRefusing to pay is a top cause of COD returns.
Watch PROBLEM_SHIPMENT and contact the receiver quicklyMany problems become returns only after several failed attempts.

Common mistakes

Trying to cancel a return

A shipment in any RTS_* status can't be cancelled. Contact support if you need to redirect it.

Expecting a refund of the original fee

The courier did carry the parcel, so the original fee is not refunded. For the couriers above, a return fee is added on top.

Ignoring failed bills

If shipment.rts_billed arrives with payment_status: "failed", the fee is still owed. Top up so it can be settled.

Was this page helpful?

On this page