GET/v1/trains/order/:gdsprovider/:orderId/refundable-items

列出可退款的火车项目

查找可以选择退款的订单项目。

分享

查找可以选择退款的订单项目。

认证和请求头

请求头说明
AuthorizationBearer <secret_key>。密钥只能保存在服务器端，不能写入客户端日志。
X-Travelandz-Id<public_key>:<profile_code>，持久化的 profile code 格式为 dp_<12 位字母数字>。
Content-Type带 JSON body 的请求使用 application/json。

请求

Path 参数：gdsprovider 当前为 0；orderId 来自订单创建。

请求参数结构

gdsprovider
enum
0
是
Currently 0
orderId
string是
Order id returned by order creation.

成功响应

返回 items[]，包含项目 id、可退款金额和受影响的行程区段。

响应体结构

items
array是
items[]id
string是
items[]amountToRefund
object是
items[]amountToRefundamount
number是
items[]amountToRefundcurrency
string是
items[]refundOfferParts
array是
items[]refundOfferParts[]segments
array是
items[]refundOfferParts[]segments[]departureAt
string
格式: ISO 8601
是
items[]refundOfferParts[]segments[]arrivalAt
string
格式: ISO 8601
是
items[]refundOfferParts[]segments[]durationInMinutes
number是
items[]refundOfferParts[]segments[]transport
enum
trainbusferry
是
items[]refundOfferParts[]segments[]identifier
string是

错误

  • 400 表示验证失败或存在未知字段。
  • 401 或 403 表示 API 凭证无效。
  • 供应方失败时返回 500 internal_communication_error 或 unknown_error。
  • 订单不存在时返回 order_not_found。

使用说明

保存选中的 items[].id，并将这些 id 发送到退款端点。

cURL 示例

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/trains/order/0/order_123/refundable-items" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"