Yoho-Documents / API-Interfaces · Files

请求地址：

环境	请求地址
测试环境	http://api-test1.yohops.com:9999
正式环境	https://api.yoho.cn

公共请求参数：

参数	类型	是否必填	最大长度	描述	示例值
app_id	String	是	32	分配给开发者的应用ID	2014072300007148
shop_id	String	是	32	商户门店编号	1001
terminal_id	String	是	32	商户机具终端编号	1001
operator_id	String	是	28	商户操作员编号	1001
method	String	是	128	接口名称	yohopay.trade.create
charset	String	否	10	仅支持utf-8	utf-8
sign	String	是	256	请求参数的签名串，详见签名	详见示例
timestamp	String	是	19	发送请求的时间，格式"yyyyMMddHHmmss"	20140724030750

公共响应参数

参数	类型	是否必填	最大长度	描述	示例值
code	String	是	-	网关返回码,详见文档	40004
message	String	否	-	网关返回码描述,详见文档	Business Failed
md5	String	是	-	相应参数MD5值 fd4ad5fcsa0de589af23234ks1923ks
data	JSON	否	-	业务执行成功数据包

yohopay.trade.listUnpayOrder (未收银订单列表信息)

该接口用于查询未收银订单列表信息

请求参数：

参数	类型	是否必填	最大长度	描述	示例值
method	String	是	128	接口名称	yohopay.trade.listUnpayOrder
shop_id	String	是	32	商户门店编号	1001

响应参数

参数	类型	是否必填	最大长度	描述	示例值
total	String	是	8	未收银订单个数	2
order_list	order_list[]	可选	64	-	商品列表信息.Json格式. 详见：“商品明细说明”
└ trade_no	String	必填	64	有货交易号	2014112611001004680073956707
└ order_code	int	必填	20	订单号	1617613279
└ out_trade_no	String	必填	64	商户订单号	20150423001001
└ buyer_pay_amount	Price	必填	11	买家实付金额，单位为元，两位小数。	15.25
└ create_time	int	必填	10	订单创建时间，可用于倒计时	1452240715
└ order_goods	order_goods []	可选	-	商品列表信息.Json格式. 详见：“商品明细说明”
└ goods_id	String	必填	32	商品的编号	apple-01
└ goods_name	String	必填	256	商品名称	ipad
└ quantity	Number	必填	10	商品数量	1
└ price	Price	必填	9	商品单价，单位为元	2000
└ goods_category	String	可选	24	商品类目	34543238
└ body	String	可选	1000	商品描述信息	特价手机
└ show_url	String	可选	400	商品的展示地址 http://www.xxx.com/xxx.jpg

正常返回结果示例

{
  "code": 200,
  "data": {
    "order_list": [
      {
        "trade_no": "1519273880",
        "order_code":"1617613279",
        "out_trade_no":"20150423001001",
        "buyer_pay_amount":"2000",
        "create_time":"1452240715",
        // 商品明细
        "order_goods": [
          {
            "goods_id": 125106,
            "goods_name":"ipad",
            "quantity":1,
            "price":2000,
            "goods_category":"34543238",
            "body":"特价手机",
            "show_url":"http://www.xxx.com/xxx.jpg"           
          }
        ]  
      },
      {
        "trade_no": "1519273880",
        "order_code":"1617613279",
        "out_trade_no":"20150423001001",
        "buyer_pay_amount":"2000",
        "create_time":"1452240715",
        // 商品明细
        "order_goods": [
          {
            "goods_id": 125106,
            "goods_name":"ipad",
            "quantity":1,
            "price":2000,
            "goods_category":"34543238",
            "body":"特价手机",
            "show_url":"http://www.xxx.com/xxx.jpg"           
          }
        ]  
      }
    ],
    "total": 2
  },
  "message": "ok"
}