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:
| Reason | Example |
|---|---|
| Receiver unreachable | Phone off or wrong, nobody answers after several attempts. |
| Address problem | Incomplete address, wrong subdistrict, house number missing. |
| Receiver refused | Didn't order it, or won't pay the COD amount. |
| Courier restriction | The parcel can't be delivered to that area or must be returned for inspection. |
Status flow
status | Meaning | Webhook |
|---|---|---|
RTS_CONFIRMED | The courier has started the return. | shipment.rts_confirmed |
RTS_TRANSIT | The parcel is on its way back. | shipment.rts_transit |
RTS_PROBLEM_SHIPMENT | A problem on the way back, for example the sender can't be reached. | shipment.rts_problem_shipment |
RTS_DELIVERED | The 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.
| Courier | Return 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 couriers | None, 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
| Step | What happens | Balance log | Webhook payment_status |
|---|---|---|---|
| 1 | Taken from your shipping credit, if it covers the whole fee. | DEBIT Tagihan retur (RTS) resi <awb> | success |
| 2 | Otherwise taken from your payout balance, if that covers it. | Same | success |
| 3 | Otherwise recorded as an unpaid return bill. Fastrac support contacts you to settle it. | None until paid | failed |
The fee is never split across pockets. Top up promptly if you see payment_status: "failed".
{
"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.
| Situation | Effect on your balance |
|---|---|
COD shipment reaches RTS_DELIVERED | Any COD proceeds credited for it are reversed: DEBIT RTS shipment <shipment> for order <order> (COD reversal) from your payout balance. |
| Courier charges a return fee | Collected 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
| Event | When |
|---|---|
shipment.rts_confirmed | The return starts. |
shipment.rts_transit | The parcel is on the way back. |
shipment.rts_problem_shipment | A problem during the return. |
shipment.rts_delivered | The parcel is back with the sender. |
shipment.rts_billed | A 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 this | Why |
|---|---|
| Validate the receiver's phone number and ask for an active WhatsApp number | Couriers call before giving up. |
| Use the right subdistrict and a complete street address with house number | Most 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 instructions | Reduces refusals because of damage. |
| Confirm COD orders with the buyer before booking | Refusing to pay is a top cause of COD returns. |
Watch PROBLEM_SHIPMENT and contact the receiver quickly | Many 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?