下单接口

接口说明

调用下单接口前请先调用车费预估接口

幂等校验（合作方单号作为key校验）

  1）正常情况：5min之内重复下单，返回之前成功单号
  2）超时情况：第一次请求下单超时，第二次请求返回重复下单提示，渠道需要根据返回重复下单状态码，再次来下单
  3）重试： 第N次重试时，如果前N-1次都还没有生成单号，那么返回重复下单，否则返回成功的订单号

说明：请保证合作方订单号partnerOrderNo的唯一性

接口地址

https:// <SQYC_DOMAIN>/chartered/postCharteredOrder

请求方式

POST

请求参数

名称	类型	是否必选	说明
partnerOrderNo	string	yes	合作方订单号(最长64位)
cityId	string	yes	首约城市ID(测试环境请用44)
serviceTypeId	int	yes	服务类型ID，6.日租，7.半日租 (日租=8小时、100公里；半日租=4小时、50公里；)
groupIds	string	yes	下单车型，如“34”
payFlag	string	no	1个人支付/2企业支付
bookingStartAddr	string	no	上车地点(URLEncode编码后的值)
bookingEndAddr	string	no	下车地点(URLEncode编码后的值)
bookingStartPointLo	string	yes	上车地点经度坐标
bookingStartPointLa	string	yes	上车地点纬度坐标
bookingEndPointLo	string	yes	下车地点经度坐标
bookingEndPointLa	string	yes	下车地点纬度坐标
bookingDate	string	yes	预定日期时间，10位秒级时间戳
estimatedAmount	string	yes	预估金额，取预估接口中originalAmount
riderName	string	no	乘车人姓名(URLEncode编码后的值)
riderPhone	string	yes	乘车人手机号
callerPhone	string	no	代叫人手机号(A给B叫车，那么A的手机号就是代叫人手机号)
customerVirtualPhone	string	no	乘车人虚拟号(针对特定渠道，如有相同需求请先与首约产品沟通)
phoneLastFour	string	no	真实手机号后四位
priceToken	string	yes	价格标识。预估时返回，用户锁定订单创建是时的价格
sign	string	yes	参见sign生成算法
channel	string	yes	渠道名称，由首汽提供

返回数据

名称	类型	说明
result	Integer	0:成功；非0：失败原因编码
errmsg	string	失败原因描述，若成功则值为空
data	OrderResultDTO	下单结果

data数据

名称	说明
orderId	可忽略该返回值，以mainOrderNo为准
mainOrderNo	订单号

返回示例

正常返回

{
    "result": 0,
    "errmsg": "SUCCESS",
    "data": {
    "returnCode": "0",
        "orderId": 198813025,
        "mainOrderNo": "C221107162329931000",
    }
}

重复下单返回

{
    "result":1110,
    "data":null,
    "errmsg":"重复下单."
}

下单接口

下单接口

接口说明

接口地址

请求方式

请求参数

返回数据

data数据

返回示例

results matching ""

No results matching ""