Order Cancellation


There are 2 Types of Cancellation that might occur during the process of delivery.

  • Cancelled Order by Driver

When the order is cancelled by our driver, the order shipper status will return to 1000. In this case, you just need to make another pickup request with the same OrderID (5ixxxx).

  • Cancelled Order by Merchant

When the order is cancelled by the merchant, the order shipper status will change to 999. In this case, you need to recreate a new order.

1.) Cancelled Order by Driver

  1. To ensure the convenience of our driver while picking up the order, our Mitra / Driver Shipper has the right to cancel the order if :
    A. Order is not yet ready to be collected in the pickup location.
    B. Order is not there when driver arrived at the pickup location.

Cancellation Flow by Driver


  1. When an order is successfully activated, there will be a pickup_code generated.
  2. When an order is accepted by Driver, the shipper_status will move from 1000 to 1020.
  3. When the driver arrives, they have the right to cancel the order as mentioned on point A & B.
    In this event, the status will move back from 1020 to 1000.
  4. If the order shipper_status.code is returned to 1000, you need to make another pickup request using the same order id using Create Pickup Order endpoint.
curl --location --request POST 'https://merchant-api.shipper.id/v3/pickup' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: {{YOUR_API_KEY}}' \
--data-raw '{
    "data": {
        "order_activation": {
            "order_id": [
            "pickup_time": "2021-07-21T15:00:00+07:00"

Sample User Interface


Sample UX of making Request Pickup

Notes to Avoid Cancellation by Driver

To avoid cancellation by our Driver upon arrival, we strongly suggest to only make a pickup request when the packet is ready to be collected.

The Service Level Agreement (SLA) for the new Pick Up ID will be collected between 15:00 - 18:00, if the pickup is requested before 13:00. For Order ID that is received after 13:00, will be collected the day after between 15:00 - 18:00.

2.) Cancelled Order by Merchant

in the case of order cancelled by user/ merchant, the order status will move to 999. In this case, you can't make a new pickup request with the exisiting order ID. You need to make a new order with new Order ID and make a new pickup request.


Cancellation Flow by Merchant


In the case that you need to cancel the order, the status will change from that current status to Cancelled - 999.

Notes to Avoid Cancellation

In order to avoid any cases of cancellation above, please ensure that the order(s) are ready for pick up before the driver arrives.

What’s Next