Batch Upload Logistics Information

POST

/v1/logistics

This API allows merchants to upload logistics information for a transaction.
The platform will store the information and synchronize it to supported payment channels if available.
This batch API allows merchants to upload logistics information for up to 10 transactions in a single request, supporting partial success and independent error handling per transaction.

Request

Body Params application/jsonRequired

Example

{
    "merchant_id": "1038501",
    "account_id": "1038501001",
    "request_id": "",
    "items": [
        {
            "transaction_id": "P2003787826134548481122428327",
            "merchant_order_id": "P20037878261345484811224",
            "carrier_key": "100002",
            "tracking_number": "2126613fffff63f66fffff23f"
        }
    ],
    "encryption_data": "8AA21ABF25E85289FF082D7C72B75ACC3F868FF8CB31A8BCBA96B1511EBCC7D9"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/logistics' \
--header 'Content-Type: application/json' \
--data '{
    "merchant_id": "1038501",
    "account_id": "1038501001",
    "request_id": "",
    "items": [
        {
            "transaction_id": "P2003787826134548481122428327",
            "merchant_order_id": "P20037878261345484811224",
            "carrier_key": "100002",
            "tracking_number": "2126613fffff63f66fffff23f"
        }
    ],
    "encryption_data": "8AA21ABF25E85289FF082D7C72B75ACC3F868FF8CB31A8BCBA96B1511EBCC7D9"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Examples

Example 1Example 2

{
    "code": "SUCCESS",
    "data": {
        "account_id": "1038501001",
        "total_count": 1,
        "encryption_data": "D7C6D457C36C6A56CA3CCB921A435A52930C258785A35F3AF8BF544033A3C50A",
        "success_count": 1,
        "failure_count": 0,
        "merchant_id": "1038501",
        "request_id": "8888",
        "results": [
            {
                "transaction_id": "P2003787826134548481122428327",
                "message": "",
                "status": "SUCCESS"
            }
        ]
    }
}

Modified at 2026-11-02 07:26:10

Optimise payment methods

Query a payout transaction