Shipments

Overview

Passfeed’s Logistics APIs enable you to upload the shipping information in your backend, track your package, and upload the shipments confirmation.

Add Shipping Information

You can add shipping information for your package.

curl --request POST \
     --url https://www.sandbox-checkout.imerchant.online/Logistics/add \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data bid=py_live_0I9fPdXQWhzZPurCVe8y2AHX \
     --data carrier=USP \
     --data delivery_address=China \
     --data order_id=37302021311169761620302930 \
     --data tracking_number=123456789 \
     --data sign=E9C91248BBB8E84C9012C17CC990BF0F

Response

{
    "result": "success",
    "data": {
        "bid": "123756",
        "carrier": "UPS", 
        "delivery_address": "750 Lexington Ave 9th floor",
        "order_id": "120295231638181698747522213",
        "tracking_number": "1Z3X47506737943338",
        "sign": " ",
    }
}

Upload Shipping Information

Upload the package scheduled shipping date and the expected deliver date. Merchant uploads these information to provide user a good expectation in shipment.

curl --request POST \
     --url https://sandbox.imerchant.online/index/AcceptanceApi/upload \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data bid=py_live_0I9fPdXQWhzZPurCVe8y2AHX \
     --data item_type=1 \
     --data order_id=37302021311169761620302930 \
     --data promise_delivery_time=30 \
     --data promise_transit_time=25 \
     --data sign=742D3DC5E43992B3EC82973495284A23

Response

{
    "result": "success",
    "data": {
        "bid": "123756",
        "item_type": "1",
        "order_id": "120295231638181698747522213",
        "promise_delivery_time": "30",
        "promise_transit_time": "25",
        "sign": " ",
    }
}

Package Status

You can retrieve package status by order id and bid.

curl --request POST \
     --url https://www.sandbox-checkout.imerchant.online/Logistics/status \
     --header 'accept: application/json' \
     --header 'content-type: application/x-www-form-urlencoded' \
     --data bid=py_live_0I9fPdXQWhzZPurCVe8y2AHX \
     --data order_id=37302021311169761620302930 \
     --data sign=61A10501E81D907ABD3F857442876ED0

Response

{
  "result": 1,
  "message": "success",
  "data": {
    "order_id": "37302021311169761620302930",
    "tracking_number": "123456789",
    "carrier": "USP",
    "is_verify": -1,
    "is_finished": 1,
    "finished_time": null,
    "shipping_from": "China"
  }
}