Simulate a status (sandbox only)
Sandbox only. Production returns 403.
Pretends that the courier reported an event for one of your sandbox shipments, so you can test your webhook handler and status logic end to end without waiting for a real courier. Use a shipment that already has an airway bill.
status | Webhook sent | Effect on the shipment |
|---|---|---|
DRIVER_ASSIGNED | shipment.pending_pickup | Sample driver details are attached |
TRANSIT | shipment.in_transit | Status becomes IN_TRANSIT |
DELIVERED | shipment.delivered | Status becomes DELIVERED |
CANCELLED | none (use Cancel a shipment to receive shipment.cancelled) | Status becomes CANCELLED and the shipment is refunded |
RTS | shipment.rts_billed if a return fee applies | Status becomes RTS_DELIVERED (returned to the sender) |
AIRWAYBILL_UPDATED | shipment.airway_bill_updated | The airway bill is replaced by a SIM-… number |
PRICE_CHANGED | shipment.price_changed | None: webhook only, sample values (Rp 10.000 → Rp 15.000) |
WEIGHT_CHANGED | shipment.measurement_changed | None: webhook only, sample values |
RTS_BILLED | shipment.rts_billed | None: webhook only, sample fee Rp 15.000 |
Requires the CANCEL_ORDER permission.
bearerAuthAuthorizationBearer <token>An access token from the OAuth2 client-credentials grant. Exchange your API key
(client_id + client_secret) at the token endpoint and send
Authorization: Bearer <access_token>.
shipmentCode*stringThe shipment code from Create an order or List shipments.
^SHP-[0-9]{6}-[A-Z0-9]{6}$application/json- body
status*stringThe courier event to simulate. See the table above.
"DRIVER_ASSIGNED""TRANSIT""DELIVERED""CANCELLED""RTS""AIRWAYBILL_UPDATED""PRICE_CHANGED""WEIGHT_CHANGED""RTS_BILLED"The event was processed and the webhook queued.
application/json- response
statusCode*integermessage*stringdata?nullAlways empty.
curl -X POST 'https://sandbox-api.fastrac.example/b2b/shipments/string/simulate-status' \ -H 'Content-Type: application/json' \ -d '{ "status": "DELIVERED"}'{ "statusCode": 200, "message": "Shipment status simulated successfully."}Was this page helpful?
Cancel a shipment POST
Cancels one shipment and refunds what was paid for it to where the payment came from. Before the courier has an airway bill, the shipment is cancelled immediately. After that, the courier is asked to cancel first; if the courier refuses (for example because the parcel is already picked up), the error is returned and nothing changes. Calling it again on a cancelled shipment succeeds without doing anything. Delivered shipments and shipments already being returned to the sender can't be cancelled. Requires the `CANCEL_ORDER` permission. No request body.
Retrieve your balance GET
Returns your four balance pockets in whole Rupiah. Orders are paid from `shippingCredit`; check it before you create orders in bulk. Top-ups are done in the Fastrac dashboard, not through the API. Any valid API key can call it; no extra permission is needed.