upload trackers

Developing

Useepay API V2.0 Sandbox Environment

https://openapi1.uat.useepay.com

POST

/api/v2/shipping/trackers

上传/更新订单物流信息,一次可以给20个订单上传物流
同一订单重复提交视为“更新”，以最后一次提交为准（不产生重复记录）。

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://openapi1.uat.useepay.com/api/v2/shipping/trackers' \
--header 'x-merchant-no: 500000000007245' \
--header 'x-api-key: FUYTIUvjhgfytfuytwiue' \
--header 'x-app-id: www.pay.com' \
--header 'x-api-version: 2024-08' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "meta_data": {
        "id": 1
    },
    "trackers": [
        {
            "payment_intent_id": "1012601291730245786",
            "shipments": [
                    {
                        "carrier": "others",
                        "tracking_number": "GFUS01031427213762",
                        "tracking_url": "https://shopify.17track.net/app-api/tracking-page/proxy?data=ItgVDpal6nhcaTaJYzgROMtjZfQa%2FJ"
                    },
                    {
                        "carrier": "others",
                        "tracking_number": "GFUS01031427213763",
                        "tracking_url": "https://shopify.17track.net/app-api/tracking-page/proxy?data=ItgVDpal6nhcaTaJYzgROMtjZfQa%2FJ"
                    }
            ]
        },
        {
            "payment_intent_id": "1012601291730245787",
            "shipments": [
                    {
                        "carrier": "others",
                        "tracking_number": "GFUS01031427213764",
                        "tracking_url": "https://shopify.17track.net/app-api/tracking-page/proxy?data=ItgVDpal6nhcaTaJYzgROMtjZfQa%2FJ"
                    }
            ]
        }
    ]
}'

Response Example

{
    "code": "0000",
    "message": "Approved or completed successfully",
    "data": {
        "accepted": [
            {
                "shipments": [
                    {
                        "carrier": "ups",
                        "tracking_number": "1ZR08H680301455864",
                        "tracking_url": "https://www.ups.com/"
                    }
                ],
                "payment_intent_id": "1012601151754028903"
            },
            {
                "shipments": [
                    {
                        "carrier": "others",
                        "tracking_number": "4PX3002416767932CN",
                        "tracking_url": "https://t.17track.net/"
                    },
                    {
                        "carrier": "ups",
                        "tracking_number": "1ZR08H680301455864",
                        "tracking_url": "https://www.ups.com/"
                    }
                ],
                "payment_intent_id": "1012601151834028921"
            }
        ],
        "rejected": []
    },
    "merchant_no": "500000000007245",
    "app_id": "www.pay.com",
    "meta_data": {
        "id": 1
    }
}

Modified at 2026-02-02 03:17:52

Retrieve Checkout Session

Retrieve a tracker