文档
测试

6.添加小费

POST
api_method:u-order-addTips

调用注意事项

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

编码

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

货拉拉UI前端界面参考:

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

公共请求参数

参数名
类型
描述
必填
api_method
string
接口方法名。请传"u-order-addTips"
必填
api_version
string
接口版本号。请传固定值“1.0”
必填
app_key
string
开发者应用唯一标识
必填
access_token
string
用户账户授权访问令牌
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,仅用于保证签名不可预测;示例:474
必填
timestamp
string
Unix时间戳(单位:秒),60s内有效,超过60s则超时;示例:1565225482
必填
signature
string
签名值
必填

应用级请求参数(api_data数据结构)

参数名
类型
描述
必填
order_display_id
string
货拉拉订单号,
必填
total_tips_fen
int
小费总金额(分), 可多次添加,不可低于上次添加金额 示例:5000
必填

响应参数

参数名
类型
描述
必填
ret
number
返回结果码,示例:0
可选
msg
string
返回结果描述,示例:Success
可选
data
array
数据列表
可选

request Body请求示例

```json { "api_method":"u-order-addTips", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"order_display_id\":225400609008, \"total_tips_fen\":1000 }" } ```

response响应示例

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

返回状态码

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