文档

测试

6.添加小费

websocket测试

POST

api_method:u-order-addTips

接口描述

是否能添加小费,请判断订单详情中“是否可添加小费”

调用注意事项

1.添加小费是指什么？答:当用户下单后,如果长时间没有司机接单。用户可尝试采用添加小费的形式吸引司机接单 2.如何判断什么时候能添加小费？答:开发者可判断订单详情中字段“can_add_tips能否添加小费”。如果can_add_tips=1则可以显示添加小费入口。否则不显示入口 3.小费是添加时支付么？答:小费是在司机运送过程结束后,将随同账单一起发送给用户。由用户在收到账单后随账单其他费用一起支付

服务入口

测试环境:https://openapi-stg.huolala.cn/v1 正式环境:https://openapi.huolala.cn/v1

编码

数据编码: Accept:application/json Content-type: application/json 字符编码: utf-8

货拉拉UI前端界面参考:

![image.png](https://cos.easydoc.net/48578360/files/k93smiso)

公共请求参数

参数名

类型

描述

必填

api_method

string

接口方法

必填

api_version

string

接口版本，固定值:1.0

必填

app_key

string

应用app_key

必填

access_token

string

用户账户授权访问令牌

必填

nonce_str

string

随机数,用户自定义,60s内不可重复使用,仅用于保证签名不可预测；示例：474

必填

timestamp

string

Unix时间戳(单位:秒),60s内有效,超过60s则超时；示例：1565225482

必填

signature

string

签名值

必填

应用级请求参数

参数名

类型

描述

必填

order_display_id

string

货拉拉订单号,

必填

total_tips_fen

int

小费总金额(分), 可多次添加,不可低于上次添加金额示例：5000

必填

响应参数

参数名

类型

描述

必填

ret

number

返回结果码，示例：0

可选

msg

string

返回结果描述，示例：Success

可选

data

array

数据列表

可选

request Body请求示例

```json { "app_key":"****************", "access_token":"**************", "nonce_str":"474", "timestamp":"1565225482040", "signature":"*****************" "order_display_id":225400609008, "total_tips_fen":1000, } ```

response响应示例

```json { "ret": 0, "msg": "Success", "data": { } } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |30012|订单ID错误| |31001|小费金额不能低于之前金额|

上一篇 5.下单

nextDoc 7.取消订单