请求方式

POST

接口规则

本接口使用微信支付V3版接口规则

sp_mchid

String(32)

是

1900000109

微信支付分配的服务商商户号

sub_mchid

String(32)

是

1900000100

微信支付分配子商户商户号

sp_appid

String(32)

是

wx8888888888888888

服务商在微信公众平台申请服务号对应的APPID 

sub_appid

String(32)

否

wx8888888888888888

子商户在微信公众平台申请服务号对应的APPID

out_shop_no

String(32)

是

6895

商户旗下门店的唯一编号

openid

String(32)

否

oYobu0Dmn6Tdod ZnFWKOEkqoRbI8

用户标识，用户在服务商appid下的openid。 openid和sub_openid可以选传其中之一，如果选择传sub_openid,则必须传sub_appid。

sub_openid

String(32)

否

oYobu0Dmn6Tdod ZnFWKOEkqoRbI8

用户子标识，用户在子商户appid下的openid。openid和sub_openid可以选传其中之一，如果选择传sub_openid,则必须传sub_appid。

login_token

String(256)

是

071oYFSN19sCH31AyNSN15QDSN1oYFSA

微信用户登录接口返回的登录票据

公众号，填写页面授权access_token，详细参考；

小程序，填写session_key，详细参考。

order_entry

String(256)

是

http://www.example.com

点餐入口，公众号：点餐页面完整URL
小程序：点餐页面path路径

total_amount

int

是

1000

总价，单位为分

discount_amount

int

是

100

优惠金额，单位为分

user_amount

int

是

900

实际支付金额，单位为分

status

String(32)

是

CREATE_DEAL

订单状态，取值如下：

CREATE_DEAL—用户下单；

PAY_SUCCESS—支付完成，结账成功；

action_time

String(64)

是

2018-06-08T10:34:56+08:00

状态发生变化的时间，格式为rfc3339格式，如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒

pay_time

String(64)

否

2018-06-08T10:34:56+08:00

支付时间，格式为rfc3339格式，如2018-06-08T10:34:56+08:00 代表北京时间2018年06月08日10时34分56秒（status为PAY_SUCCESS时必填）

transaction_id

String(64)

否

1009660380201506130728806387

支付订单号（status为PAY_SUCCESS时必填）

out_trade_no

String(64)

否

20150806125346

服务商系统内部支付订单号（status为PAY_SUCCESS时必填）

out_order_no

String(64)

是

20150806125346

服务商系统内部订单号

dish_list

JsonArray

是

[{

"out_dish_no":"1",

"name":"清汤锅底",

"price":6000,

"unit":"BY_SHARE",

"count":1,

"discount":100,

"type":"FAST_FOOD",

"priority":1,

"properties":

{"taste":"辣","cuisine":"炒","main_material":"猪肝","ingredients":"青椒|辣椒|葱|八角","others":"有机|农家"}

}]

详见dish_list对象列表

out_table_no

String(16)

否

1

桌位号

people_count

int

否

2

消费人数

out_dish_no

String(48)

是

1

商户菜品ID

name

String(128)

是

清汤锅底

菜品名称

price

int

是

1

菜品单价，单位为分

unit

String(16)

是

BY_SHARE

菜品单位，BY_SHARE-按份 BY_WEIGHT-按重量

count

Float

是

1.5

菜品数量，保留小数点后2位有效数字

discount

int

否

100

菜品折扣，百分值，8折填80

type

String(32)

否

FAST_FOOD

菜品分类，如等。详见参数规定《菜品类型列表》

priority

int

否

1

当前菜品在服务商平台的顺序，值越小越靠前，取值（1~100）

properties

object

否

菜品属性，详见参数规定《菜品属性列表》

taste

String(128)

是

辣

口味，取值参考参数规定中的“菜品属性”taste字段，可额外补充

cuisine

String(128)

是

炒

做法，取值参考参数规定中的“菜品属性”cuisine字段，可额外补充

main_material

String(128)

是

猪肝

主料，取值参考参数规定中的“菜品属性”main_material字段，可额外补充，以竖线(|)分隔

ingredients

String(128)

是

青椒|辣椒|葱|八角

配料，取值参考参数规定中的“菜品属性”ingredients字段，可额外补充，以竖线(|)分隔

others

String(128)

否

有机|农家

其他，取值参考参数规定中的“菜品属性”others字段，可额外补充，以竖线(|)分隔

code

String(32)

是

PARAM_ERROR

错误码，枚举值见错误码列表

message

String(256)

是

参数格式校验错误

返回信息，如非空，为错误原因，比如签名失败，参数为空等

detail

Object

是

{

"field":"unit",

"value":"BYSHARE",

"issue":"currency code is invalid",

"location":"body"

}

具体错误情况，见下面说明

field

String

是

unit

错误的参数名

value

String

是

BYSHARE

错误的值

issue

String

是

currency code is invalid

具体错误情况

location

String

是

body

body：错误参数位于请求body的JSON中；

url：错误参数位于请求url中

query：错误参数位于请求的querystring中