11.支付司机账单

websocket测试

POST

api_method:u-bill-pay

调用注意事项

1.账单费用包含什么？答:账单主要包含二部分费用 - 用户添加的小费(需随同账单一起支付) - 司机运输完成后,如果在实际运输过程中,实际产生了高速费,停车费,等候费,搬运费。则司机会添加到账单中,发送账单给用户。由用户支付账单 2.账单是否有消息主动推送？答:账单通知主要分为二类 - **司机发送账单通知**:当司机发送了账单后,货拉拉将会向开发者应用发出“司机发送账单通知”（详情请参考推送说明） - **司机修改账单通知**:当司机修改了账单,货拉拉将向开发者应用推送“司机修改账单通知”。开发者接到此类通知后,需重新调订单详情接口,获取最新的订单状态及未付费用明细信息 3.开发者应用什么时候显示账单明细？答:当开发者接收到“司机发送账单通知”或者“司机修改账单通知”时,应调“获取订单详情接口”获取账单中未付费用明细详情(price_info中pay_status=0） 4.开发者应用什么时候显示支付入口？答:开发者应用判断“订单详情-价格详情结构体price_info”中字段“need_to_pay是否需要支付”.如果need_to_pay=1,则需要开发者显示支付入口

前端UI界面示例

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

系统级请求参数

参数名

类型

描述

必填

api_method

string

接口方法名。请传“u-bill-pay”

必填

api_version

string

接口版本号。请传固定值“1.0”

必填

app_key

string

开发者应用唯一app_key

必填

access_token

string

用户账户授权访问令牌

必填

nonce_str

string

随机数,用户自定义,60s内不可重复使用,用于确保请求不可重复

必填

timestamp

number

unix时间戳(单位:秒),时间戳应为60s内的值,超过60s则超时

必填

signature

string

签名值

必填

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

参数名

类型

描述

必填

order_display_id

string

货拉拉订单号

必填

string

用户ip地址，示例:"127.0.0.1"

必填

pay_type

int

支付方式:4.账户余额支付，901云闪付APP支付(仅中国银联可用)

必填

price_fen

int

账单金额(分)

必填

响应参数

参数名

类型

描述

必填

ret

number

返回结果码，示例：0

必填

msg

string

返回结果描述，示例：""

必填

data

object

返回数据，示例：null

必填

order_display_id

string

货拉拉订单号

必填

pay_no

int

待支付单号(货拉拉生成)

必填

price_fen

int

待支付金额(分)

必填

pay_notify_url

string

支付结果回调地址(银联侧需通过此回调地址通知我们支付结果)

必填

pay_time_expire

long

支付超时时间(unix时间戳,单位秒)

必填

请求json示例：

```json { "api_method":"u-bill-pay", "api_version":"1.0", "app_key":"*****************", "access_token":"**********************", "signature":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "api_data":"{ \"order_display_id\":\"127.0.0.1\", \"price_fen\":1200, \"ip\":\"192.168.0.1\", \"pay_type\":4 }" } ```

返回json示例:

```json { "ret":0, "msg":"", "data":{ "order_display_id":"137100800068", "pay_no":"", "price_fen":1000, "pay_notify_url":"http://xxxxxxx.cn", "pay_time_expire":1587095166 } } ```

返回状态码说明

|ret状态码|描述| |-|-| |0|成功| |30012|订单ID错误| |31001|订单费用已结清| |31002|支付失败| |31003|还未发起账单| |31004|支付金额不正确|