支付宝

地铁购票订单批量查询

开发环境

POST

/v3/alipay/commerce/cityfacilitator/voucher/batchquery

alipay.commerce.cityfacilitator.voucher

商户APP调该接口批量查询订单状态

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/commerce/cityfacilitator/voucher/batchquery' \
--header 'Content-Type: application/json' \
--data-raw ''

响应示例

200 - 示例 1

{
  "tickets": [
    {
      "amount": "10.00",
      "end_station": "21003002",
      "end_station_name": "浦电路",
      "quantity": "8",
      "start_station": "12300002",
      "start_station_name": "蓝村路",
      "status": "SUCCESS",
      "ticket_price": "5.00",
      "ticket_type": "oneway",
      "trade_no": "0123456789"
    }
  ]
}

请求参数

Body 参数application/json

city_code

string

可选

城市编码请参考查询中华人民共和国行政区划代码。已支持城市：广州 440100，深圳 440300，杭州330100。

示例值:

440300

trade_nos

array[string]

支付宝交易号列表

可选

示例值:

0123456789

示例

返回响应

🟢200common response

application/json

Body

tickets

array[object (TicketDetailInfo) {10}]

可选

查询到的订单信息列表

amount

string

总金额，元为单位

可选

示例值:

10.00

end_station

string

终点站编码

可选

示例值:

21003002

end_station_name

string

终点站中文名称

可选

示例值:

浦电路

quantity

string

票数量

可选

示例值:

start_station

string

起点站编码

可选

示例值:

12300002

start_station_name

string

起点站中文名称

可选

示例值:

蓝村路

status

string

订单状态

可选

示例值:

SUCCESS

ticket_price

string

单价，元为单位

可选

示例值:

5.00

ticket_type

string

票类型

可选

示例值:

oneway

trade_no

string

支付宝交易号

可选

示例值:

0123456789

🔴500请求失败

修改于 2023-11-27 07:07:37

地铁购票站点数据查询

口碑开店产品介绍