接口说明
- 下单estimatedAmount传预估返回的原价,不影响结算的优惠价
接口地址
https:// <SQYC_DOMAIN>/carapi/partner/postInstantCarpoolOrder
请求方式
POST
请求参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
bookingDate | string | yes | 预定日期时间,13位时间戳 |
riderPhone | string | yes | 乘车人手机号 |
bookingStartAddr | string | yes | 上车地点(URLEncode编码后的值) |
bookingEndAddr | string | yes | 下车地点(URLEncode编码后的值) |
bookingStartPoint | string | yes | 预订上车坐标点 (格式:经度,纬度) |
bookingEndPoint | string | yes | 预订下车坐标点(格式:经度,纬度) |
imei | string | yes | 设备唯一识别码 |
cityId | string | yes | 城市id(测试环境请用44) |
groupIds | string | yes | 下单车型,多车型用“,”分割。如“34,35” |
estimatedAmount | string | yes | 预估金额,传预估返回车型原价,多车型时以最低价格为准 |
buyoutPrice | string | yes | 一口价价格 |
buyoutFlag | int | yes | 一口价标志位,0:不是一口价订单;1:是一口价订单 |
failAmount | string | yes | 拼车失败一口价(优惠后的) |
failDisMoney | string | yes | 拼车失败预估原价 |
partnerOrderNo | string | yes | 合作方订单号 |
riderName | string | no | 乘车人姓名(URLEncode编码后的值) |
verifyCode | string | no | 手机验证码,部分渠道为必填项 |
payFlag | string | yes | 是否渠道付款,0为渠道付 |
couponCode | string | no | 优惠券编码 |
isNew | int | no | 是否为新用户(由合作方传) |
fingerVerifyId | string | no | 指纹设备id(风控) |
carpoolMark | int | yes | 拼车标识(0:不拼车,1:拼车) |
seats | int | yes | 子单乘客人数 |
ruleId | string | yes | 规则id |
priceMark | string | yes | 价格标识 |
sign | string | yes | 参考sign生成算法 |
channel | string | yes | 渠道名称,由首汽提供 |
payStatus | string | no | 支付状态 1:已支付(城际拼车必传) |
startCityName | string | no | 上车城市名:例如北京(城际拼车必传) |
endCityId | string | no | 下车城市(城际拼车必传) |
endCityName | string | no | 下车城市名:例如上海(城际拼车必传) |
serviceType | int | no | 服务类型(城际拼车必传) |
carpoolType | int | no | 拼车类型(1: 室内拼车, 2:城际拼车)默认1 |
startPoiId | string | no | 起点poi_id: 如B0FFFTQRTX |
endPoiId | string | no | 终点poi_id: 如B0FFFTQRTX |
isMatchByShouyue | Boolean | no | 首约拼车标识(百度使用):默认首约拼车true |
返回数据
名称 | 类型 | 说明 |
---|---|---|
result | string | 0:成功;非0:失败原因编码 |
errmsg | string | 失败原因描述,若成功则值为空 |
data | oobject | 参考返回 |
返回示例
{
"result":"0",
"errmsg":"SUCCESS",
"data":{
"orderId":198813025,
"orderNo":"B7518002632952624",
"returnCode":"0"
}
}