开发指南
API
官网
API 2.0
API 2.0 > 10.1 线上支付 > 10.1.4 支付统一入口

10.1.4 支付统一入口

开启令牌和权限后可调用。签名方式请查看开发指南
场景说明：订单支付统一入口，attach点餐上送必填
零售 餐饮 店小铺

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 communal.order.pay-entrance-request 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
order_no string 是 订单号
total Money(元) 是 支付总金额
scene string 是 标识支付场景，mini
order_type string 是 wechat/alipay/union
fenqi_num int 否 花呗分期支付的分期数
open_id string 是 第三方用户标识
appid string 是 （支付宝或微信小程序的appid）
original string 否 原样返回的参数，字符串，可以是普通字符串或json字符串，为了方便扩展，建议使用json字符串
auth_code string 否 扫码付的支付码
back_url string 否 回跳URL,针对有同步回调的支付方式，客户端传递
plugin_id string 否 支付宝小程序插件的plugin_id
attach array 否
 ├user_amount string 是 点餐上送必填,用户实付金额（包括余额和现金，单位：分），total_amount=discount_amount+user_amount
 ├total_amount string 是 点餐上送必填,订单总金额（单位：分）
 ├discount_amount string 是 点餐上送必填,商家优惠金额（单位：分）
 ├user_id string 否 传空
 ├order_type string 是 点餐上送必填,订单类型，独立有用
 ├food_order_type string 是 点餐上送必填,点餐类型（小程序：堂食qr_order，自提pre_order，外卖home_delivery）
 ├goods_tag string 是 点餐上送必填,优惠标记
 ├order_id string 是 点餐上送必填,订单id
 ├sourcePath string 是 点餐上送必填,点餐页面 path 路径
 ├goods array 否
  ├0 array 否
   ├sku_id string 是 点餐上送必填,商品 sku id 支付宝-点餐上送必填
   ├item_id string 是 点餐上送必填,商品 id 支付宝-点餐上送必填
   ├item_name string 是 点餐上送必填,商品名称 支付宝-点餐上送必填
   ├unit_price string 是 点餐上送必填,商品单价（单位：元）支付宝-点餐上送必填
   ├quantity string 是 点餐上送必填,商品数量（单位：自拟）支付宝-点餐上送必填
   ├ext_info array 否
    ├0 array 否
     ├ext_key string 是 点餐上送必填,键值 dish_type 菜品，flavor 口味，cooking_method 做法，image_material_id图片
     ├ext_value string 是 点餐上送必填,值 菜品，口味，做法值枚举
   ├out_dish_no string 是 点餐上送必填,商户菜品ID 微信-点餐上送必填
   ├name string 是 点餐上送必填,菜品名称 微信-点餐上送必填
   ├price string 是 点餐上送必填,菜品单价，单位为分 微信-点餐上送必填
   ├unit string 是 点餐上送必填,菜品单位，BY_SHARE-按份 BY_WEIGHT-按重量 微信-点餐上送必填
   ├count string 是 点餐上送必填,菜品数量，保留小数点后2位有效数字 微信-点餐上送必填
 ├login_token string 是 微信用户登录接口返回的登录票据 session_key 获取方式参考链接 https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html
is_multi string 是 标识需要多门店支付，1是，0否
subject string 是 支付标题
FoodOrder int 是 1 表示扫码点餐 0 表示 非扫码点餐

响应参数

参数 参数类型 描述
out_trade_no string T开头订单号
trade_no string 三方订单号
appId string 微信或支付宝等的appid
timeStamp ttimeStamp 时间
nonceStr string 随机数
package_str string package_str
signType string SRA
paySign string paySign
ali_trade_no string 2018121422001484520509556093，支付宝统一单号
html string 支付宝PC支付返回的提交到支付宝收银台的html，url_encode后的结构，可直接给前端
code_url string 微信PC支付返回的微信支付二维码地址，可直接给前端

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.order.pay-entrance-request",
    "Params": {
        "order_no": "A5CEE00CCE0C9E8364",
        "total": "2",
        "scene": "mini",
        "order_type": "wechat",
        "fenqi_num": "3",
        "open_id": "",
        "appid": "",
        "original": "",
        "auth_code": "134767396697090653",
        "back_url": "",
        "plugin_id": "",
        "attach": {
            "user_amount": "",
            "total_amount": "",
            "discount_amount": "",
            "user_id": "",
            "order_type": "",
            "food_order_type": "",
            "goods_tag": "",
            "order_id": "",
            "sourcePath": "",
            "goods": [
                {
                    "sku_id": "9165508549408502",
                    "item_id": "84505",
                    "item_name": "item_name",
                    "unit_price": "35.00",
                    "quantity": "1",
                    "ext_info": [
                        {
                            "ext_key": "image_material_id",
                            "ext_value": "other"
                        }
                    ],
                    "out_dish_no": "9165508549408502",
                    "name": "50元全场代金券",
                    "price": "3500",
                    "unit": "BY_SHARE",
                    "count": "1"
                }
            ],
            "login_token": ""
        },
        "is_multi": "",
        "subject": "",
        "FoodOrder": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "out_trade_no": "T180928093950153153809879045054118",
        "trade_no": "100022343f342432",
        "appId": "",
        "timeStamp": "1543235677",
        "nonceStr": "",
        "package_str": "",
        "signType": "SRA",
        "paySign": "",
        "ali_trade_no": "2018121422001484520509556093",
        "html": "",
        "code_url": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 communal.order.pay-entrance-request 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
order_no string 是 订单号
total Money(元) 是 支付总金额
scene string 是 标识支付场景，mini
order_type string 是 wechat/alipay/union
fenqi_num int 否 花呗分期支付的分期数
open_id string 是 第三方用户标识
appid string 是 （支付宝或微信小程序的appid）
original string 否 原样返回的参数，字符串，可以是普通字符串或json字符串，为了方便扩展，建议使用json字符串
auth_code string 否 扫码付的支付码
back_url string 否 回跳URL,针对有同步回调的支付方式，客户端传递
plugin_id string 否 支付宝小程序插件的plugin_id
attach array 否
 ├user_amount string 是 点餐上送必填,用户实付金额（包括余额和现金，单位：分），total_amount=discount_amount+user_amount
 ├total_amount string 是 点餐上送必填,订单总金额（单位：分）
 ├discount_amount string 是 点餐上送必填,商家优惠金额（单位：分）
 ├user_id string 否 传空
 ├order_type string 是 点餐上送必填,订单类型，独立有用
 ├food_order_type string 是 点餐上送必填,点餐类型（小程序：堂食qr_order，自提pre_order，外卖home_delivery）
 ├goods_tag string 是 点餐上送必填,优惠标记
 ├order_id string 是 点餐上送必填,订单id
 ├sourcePath string 是 点餐上送必填,点餐页面 path 路径
 ├goods array 否
  ├0 array 否
   ├sku_id string 是 点餐上送必填,商品 sku id 支付宝-点餐上送必填
   ├item_id string 是 点餐上送必填,商品 id 支付宝-点餐上送必填
   ├item_name string 是 点餐上送必填,商品名称 支付宝-点餐上送必填
   ├unit_price string 是 点餐上送必填,商品单价（单位：元）支付宝-点餐上送必填
   ├quantity string 是 点餐上送必填,商品数量（单位：自拟）支付宝-点餐上送必填
   ├ext_info array 否
    ├0 array 否
     ├ext_key string 是 点餐上送必填,键值 dish_type 菜品，flavor 口味，cooking_method 做法，image_material_id图片
     ├ext_value string 是 点餐上送必填,值 菜品，口味，做法值枚举
   ├out_dish_no string 是 点餐上送必填,商户菜品ID 微信-点餐上送必填
   ├name string 是 点餐上送必填,菜品名称 微信-点餐上送必填
   ├price string 是 点餐上送必填,菜品单价，单位为分 微信-点餐上送必填
   ├unit string 是 点餐上送必填,菜品单位，BY_SHARE-按份 BY_WEIGHT-按重量 微信-点餐上送必填
   ├count string 是 点餐上送必填,菜品数量，保留小数点后2位有效数字 微信-点餐上送必填
 ├login_token string 是 微信用户登录接口返回的登录票据 session_key 获取方式参考链接 https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html
is_multi string 是 标识需要多门店支付，1是，0否
subject string 是 支付标题
FoodOrder int 是 1 表示扫码点餐 0 表示 非扫码点餐

响应参数

参数 参数类型 描述
out_trade_no string T开头订单号
trade_no string 三方订单号
appId string 微信或支付宝等的appid
timeStamp ttimeStamp 时间
nonceStr string 随机数
package_str string package_str
signType string SRA
paySign string paySign
ali_trade_no string 2018121422001484520509556093，支付宝统一单号
html string 支付宝PC支付返回的提交到支付宝收银台的html，url_encode后的结构，可直接给前端
code_url string 微信PC支付返回的微信支付二维码地址，可直接给前端

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.order.pay-entrance-request",
    "Params": {
        "order_no": "A5CEE00CCE0C9E8364",
        "total": "2",
        "scene": "mini",
        "order_type": "wechat",
        "fenqi_num": "3",
        "open_id": "",
        "appid": "",
        "original": "",
        "auth_code": "134767396697090653",
        "back_url": "",
        "plugin_id": "",
        "attach": {
            "user_amount": "",
            "total_amount": "",
            "discount_amount": "",
            "user_id": "",
            "order_type": "",
            "food_order_type": "",
            "goods_tag": "",
            "order_id": "",
            "sourcePath": "",
            "goods": [
                {
                    "sku_id": "9165508549408502",
                    "item_id": "84505",
                    "item_name": "item_name",
                    "unit_price": "35.00",
                    "quantity": "1",
                    "ext_info": [
                        {
                            "ext_key": "image_material_id",
                            "ext_value": "other"
                        }
                    ],
                    "out_dish_no": "9165508549408502",
                    "name": "50元全场代金券",
                    "price": "3500",
                    "unit": "BY_SHARE",
                    "count": "1"
                }
            ],
            "login_token": ""
        },
        "is_multi": "",
        "subject": "",
        "FoodOrder": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "out_trade_no": "T180928093950153153809879045054118",
        "trade_no": "100022343f342432",
        "appId": "",
        "timeStamp": "1543235677",
        "nonceStr": "",
        "package_str": "",
        "signType": "SRA",
        "paySign": "",
        "ali_trade_no": "2018121422001484520509556093",
        "html": "",
        "code_url": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 communal.order.pay-entrance-request 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
order_no string 否 订单号
total Money(元) 否 支付总金额
scene string 是 标识支付场景，mini
order_type string 否 wechat/alipay/union
fenqi_num int 否 花呗分期支付的分期数
open_id string 否 第三方用户标识
appid string 否 （支付宝或微信小程序的appid）
original string 否 原样返回的参数，字符串，可以是普通字符串或json字符串，为了方便扩展，建议使用json字符串
auth_code string 否 扫码付的支付码
back_url string 否 回跳URL,针对有同步回调的支付方式，客户端传递
plugin_id string 否 支付宝小程序插件的plugin_id
attach array 否
 ├user_amount string 是 点餐上送必填,用户实付金额（包括余额和现金，单位：分），total_amount=discount_amount+user_amount
 ├total_amount string 是 点餐上送必填,订单总金额（单位：分）
 ├discount_amount string 是 点餐上送必填,商家优惠金额（单位：分）
 ├user_id string 否 传空
 ├order_type string 是 点餐上送必填,订单类型，独立有用
 ├food_order_type string 是 点餐上送必填,点餐类型（小程序：堂食qr_order，自提pre_order，外卖home_delivery）
 ├goods_tag string 是 点餐上送必填,优惠标记
 ├order_id string 是 点餐上送必填,订单id
 ├sourcePath string 是 点餐上送必填,点餐页面 path 路径
 ├goods array 否
  ├0 array 否
   ├sku_id string 是 点餐上送必填,商品 sku id 支付宝-点餐上送必填
   ├item_id string 是 点餐上送必填,商品 id 支付宝-点餐上送必填
   ├item_name string 是 点餐上送必填,商品名称 支付宝-点餐上送必填
   ├unit_price string 是 点餐上送必填,商品单价（单位：元）支付宝-点餐上送必填
   ├quantity string 是 点餐上送必填,商品数量（单位：自拟）支付宝-点餐上送必填
   ├ext_info array 否
    ├0 array 否
     ├ext_key string 是 点餐上送必填,键值 dish_type 菜品，flavor 口味，cooking_method 做法，image_material_id图片
     ├ext_value string 是 点餐上送必填,值 菜品，口味，做法值枚举
   ├out_dish_no string 是 点餐上送必填,商户菜品ID 微信-点餐上送必填
   ├name string 是 点餐上送必填,菜品名称 微信-点餐上送必填
   ├price string 是 点餐上送必填,菜品单价，单位为分 微信-点餐上送必填
   ├unit string 是 点餐上送必填,菜品单位，BY_SHARE-按份 BY_WEIGHT-按重量 微信-点餐上送必填
   ├count string 是 点餐上送必填,菜品数量，保留小数点后2位有效数字 微信-点餐上送必填
 ├login_token string 是 微信用户登录接口返回的登录票据 session_key 获取方式参考链接 https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html
is_multi string 是 标识需要多门店支付，1是，0否
subject string 是 支付标题
FoodOrder int 是 1 表示扫码点餐 0 表示 非扫码点餐

响应参数

参数 参数类型 描述
out_trade_no string T开头订单号
trade_no string 三方订单号
appId string 微信或支付宝等的appid
timeStamp ttimeStamp 时间
nonceStr string 随机数
package_str string package_str
signType string SRA
paySign string paySign
ali_trade_no string 2018121422001484520509556093，支付宝统一单号
html string 支付宝PC支付返回的提交到支付宝收银台的html，url_encode后的结构，可直接给前端
code_url string 微信PC支付返回的微信支付二维码地址，可直接给前端

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "communal.order.pay-entrance-request",
    "Params": {
        "order_no": "A5CEE00CCE0C9E8364",
        "total": "2",
        "scene": "mini",
        "order_type": "wechat",
        "fenqi_num": "3",
        "open_id": "",
        "appid": "",
        "original": "",
        "auth_code": "134767396697090653",
        "back_url": "",
        "plugin_id": "",
        "attach": {
            "user_amount": "",
            "total_amount": "",
            "discount_amount": "",
            "user_id": "",
            "order_type": "",
            "food_order_type": "",
            "goods_tag": "",
            "order_id": "",
            "sourcePath": "",
            "goods": [
                {
                    "sku_id": "9165508549408502",
                    "item_id": "84505",
                    "item_name": "item_name",
                    "unit_price": "35.00",
                    "quantity": "1",
                    "ext_info": [
                        {
                            "ext_key": "image_material_id",
                            "ext_value": "other"
                        }
                    ],
                    "out_dish_no": "9165508549408502",
                    "name": "50元全场代金券",
                    "price": "3500",
                    "unit": "BY_SHARE",
                    "count": "1"
                }
            ],
            "login_token": ""
        },
        "is_multi": "",
        "subject": "",
        "FoodOrder": ""
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "out_trade_no": "T180928093950153153809879045054118",
        "trade_no": "100022343f342432",
        "appId": "",
        "timeStamp": "1543235677",
        "nonceStr": "",
        "package_str": "",
        "signType": "SRA",
        "paySign": "",
        "ali_trade_no": "2018121422001484520509556093",
        "html": "",
        "code_url": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075