预估退票费用

POST

/train/openapi/v4/orders/{orderId}/refund-estimate

按待退乘客预估可退票款、扣费和服务费；只计算，不创建退票单。

Request

Authorization

API Key

Add parameter in header

code

Example:

code: ********************

API Key

Add parameter in header

timestamp

Example:

timestamp: ********************

API Key

Add parameter in header

signature

Example:

signature: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "passengerIds": [
        10001
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/train/openapi/v4/orders/TO202607150001/refund-estimate' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "passengerIds": [
        10001
    ]
}'

Responses

🟢200

application/json

预估成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "currency": "CNY",
        "cutoffAt": "2026-07-19 09:00:00",
        "priceBasis": "passenger",
        "items": [
            {
                "passengerId": 10001,
                "ticketRefundPrice": 500,
                "refundAmount": 447,
                "deductFee": 53,
                "serviceFee": 0
            }
        ]
    }
}

🟢200TrainBusinessError

Modified at 2026-07-21 08:28:46

预估改签费用

申请改签