支付Api地址：

测试环境：http://test.ezrpro.cn:3309

正式环境：http://pay.ezrpro.cn

支付宝支付API

签名算法：

API接口请求加签算法：

签名生成的通用步骤如下：

签名生成规则如下：参与签名的字段包括AppId, Timestamp（时间戳），Token 以及业务参数。对所有待签名参数按照字段名的ASCII 码从小到大排序（字典序）后，使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串string1。这里需要注意的是所有参数名均区分大小写（数组类型参数不参与计算）。对string1作sha1加密，然后转换成小写，字段名和字段值都采用原始值，不进行URL 转义。

 即signature=sha1(string1)。 示例：

• AppId = EZP

• Token = HH1232D

• Timestamp = 20160523235959

• ShopCode = HQ01S001

• UserCode = KB1001

步骤1.

对所有待签名参数按照字段名的ASCII 码从小到大排序（字典序）后，使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串string1：

AppId=EZP&AuthCode=130115575166786427&Subject=刷卡支付测试&ShopCode=HQ01S001&Timestamp=20160523235959&Token=1234Tk123&TotalAmount=1&UserCode=323231&VipOldCode=EZ0541688

·              

步骤2. 

对string1进行sha1签名，转成小写，得到signature：e0afdde6ff59081f18609f8d77926d88bc43a3db

注意事项：

• 空值不参与签名

• 属性值区分大小写

• Sha1之后需要转换成小写

接口返回码说明（BusinessCode）：

0 ：成功

500：业务异常

4001：参数错误

1、条码支付下单

接口说明：

收银员使用扫码设备读取用户手机支付宝“付款码”，将二维码或条码信息通过本接口进行支付下单

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/createalipay

请求参数：

GoodsDetail[]：商品明细说明

响应参数：

请求参数示例代码（json对象）：

{
    "AppId": "EZP",
    "Timestamp": "20160523235959",
    "Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
    "TradeNo": "2017050301001",
    "AuthCode": "282078355612576520",
    "ShopCode": "21015",
    "TotalAmount": 0.1,
    "Subject": "鞋子",
    "GoodsDetail": [
        {
            "goods_id": "PR10000",
            "goods_name": "测试商",
            "quantity": 1,
            "price": "0.05"
        }
    ]
}

系统返回参数示例（json对象）：

{
    "Success": true,
    "Msg": "操作成功",
    "Status": 200,
    "BusinessCode": 0,
    "ServerTime": " 2017-04-18T17:57:17.3094616+08:00",
    "Result": {
        "OrderId": 38,
        "TradeNo": " WP01953717041800000004",
        "Code": "10000",
        "IsError": false,
        "Msg": "SUCCESS",
        "SubCode": null,
        "SubMsg": null
    }
}

避免不合法的传参：

原因：传参错误会导致支付异常。

建议方案：对所有返回INVALID_PARAMETER的响应进行监控，一旦发现请停止调用并检查请求参数,修改后重新发起请求。

支付等待(如等待用户输入密码等)：

对所有唤起收银台的交易（支付宝返回状态10003） EZR接口将发起轮询，3秒一次 一共5分钟，直至交易成功。如果轮询结束后还是支付处理中，EZR将会调用撤销接口，取消当前交易。

支付等待返回结果：

Code：10003

Msg：   order success pay inprocess

POS支付结果回调：

交易状态获取完成后会将状态回调到POS支付结果Callback地址，回传的时候如果出现网络超时，会尝试多次回调，同时ezr也提供了查询订单信息的接口（接口详情可以看订单信息查询接口），在出现回调不成功的情况下，可以通过订单查询接口获取订单状态

回调返回参数：

订单状态码(TradeState)：

• SUCCESS—支付成功

• INRROCESS—支付等待

• FAILED--支付失败(其他原因，如银行返回失败)

业务错误码(PayErrorCode)：

     详见 附表1

 2、订单信息查询接口

接口说明：

• 用于获取单个订单的信息（可用于订单callback接收失败获取订单状态）

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/getorderinfo

请求参数：

注意：订单查询时传入的商户订单号,和EZR的商户订单号不能同时为空。 TradeNo,OutTradeNo如果同时存在优先取TradeNo。

返回参数：

请求参数示例代码（json对象）：

{
    "AppId": "EZP",
    "Timestamp": "20160523235959",
    "Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
    "ShopCode": "HQ01S001",
    "TradeNo": "WP01631316101000000017"
}

系统返回结果示例：

{
    "TradeNo": "WP01631316101000000017",
    "OutTradeNo": "",
    "UserCode": "323231",
    "TotalFee": 1,
    "CashFee": 1,
    "RefundFee": 0,
    "CreateDate": "2016-10-10T16:58:15",
    "TradeState": "SUCCESS",
    "PayErrorMsg": "",
    "PayTime": "2016-10-10T16:58:32"
}

3、支付订单列表获取

接口说明：

• 用户获取支付订单列表

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/getorderlist

请求参数：

返回参数：

请求参数示例：

{
    "AppId": "EZP",
    "Timestamp": "20160523235959",
    "Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
    "ShopCode": "HQ01S001",
    "PageIndex": 1,
    "PageSize": 20
}

返回参数示例：

{
  "Success": false,
  "Msg": "操作成功",
  "Status": 200,
  "ServerTime": "2016-09-18T16:39:01.3853029+08:00",
  "Count": 1,
  "Result": [
    {
      "OrderId": 79,
      "PayType": 0,
      "TradeNo": "WP01366216091800000001",
      "UserCode": "323231",
      "TotalFee": 1,
      "CashFee": 0,
      "RefundFee": 0,
      "CreateDate": "2016-09-18T15:15:38",
      "TradeState": "FAILED",
      "PayErrorMsg": 支付失败,请刷新付款码后重试,
      "PayTime": "2016-09-18T15:15:38",
      "VipMobileNo": "18302188990",
      "VipName": "cycle"
    }
  ],
  "PageTotal": 1,
  "BusinessCode": 0
}

 4、退款申请接口

接口说明：

• 用于支付订单进行退款申请，一个订单可以多次退款

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/createalipayrefund

请求参数：

GoodsDetail[]：商品明细说明

返回参数：

返回退款单号

请求参数示例：

{
    "AppId": "EZP",
    "Timestamp": "20160523235959",
    "Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
    "TradeNo": 21,
    "RefundFee": 50
}

返回参数示例：

{
  "Success": true,
  "Msg": "操作成功",
  "Status": 200,
  "BusinessCode": 0,
  "ServerTime": "2016-09-18T17:01:01.3977386+08:00",
  "Result": "WPR01408316091800000001"
}

5、退款单列表查询

接口说明：

• 用户获取支付订单退款列表

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/getorderrefundlist

请求参数：

返回参数：

请求参数示例：

{
    "AppId": "EZP",
    "Timestamp": "20160523235959",
    "Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
    "ShopCode": "HQ01S001",
    "PageIndex": 1,
    "PageSize": 20
}

返回参数示例：

{
  "Success": false,
  "Msg": "操作成功",
  "Status": 200,
  "ServerTime": "2016-09-18T17:07:36.1546628+08:00",
  "Count": 2,
  "Result": [
    {
      "OrderRefundId": 6,
      "RefundType": 0,
      "RefundNo": "WPR01408316091800000001",
      "UserCode": "323231",
      "CashFee": 1,
      "RefundFee": 1,
      "CreateDate": "2016-09-18T17:01:01",
      "RefundStatus": "PROCESSING",
      "VipMobileNo": "18302188990",
      "VipName": "cycle"
    },
    {
      "OrderRefundId": 5,
      "RefundType": 0,
      "RefundNo": "WPR01944916091300000003",
      "UserCode": null,
      "CashFee": 1,
      "RefundFee": 1,
      "CreateDate": "2016-09-13T19:40:01",
      "RefundStatus": "PROCESSING",
      "VipMobileNo": "18302188990",
      "VipName": "cycle"
    }
  ],
  "PageTotal": 1,
  "BusinessCode": 0
}

退款单状态：

• SUCCESS—退款成功

• FAIL—退款失败

• PROCESSING—退款处理中

6、支付订单取消接口

接口说明：

• 支付交易返回失败或支付系统超时，调用该接口撤销交易。如果此订单用户支付失败，支付宝系统会将此订单关闭；如果用户支付成功，支付宝系统会将此订单资金退还给用户。 注意：只有发生支付系统超时或者支付结果未知时可调用撤销，其他正常支付的单如需实现相同功能请调用申请退款API。提交支付交易后调用【查询订单API】，没有明确的支付结果再调用【撤销订单API】。

请求说明：

• http请求方式：POST

• 返回数据格式：JSON

• 请求路径：/alipay/open/tradecancel

请求参数：

注意：订单取消时传入的商户订单号,和EZR的商户订单号不能同时为空。 TradeNo,OutTradeNo如果同时存在优先取TradeNo。

返回参数：

请求参数示例代码（json对象）：

{
"AppId": "EZP",
"Timestamp": "20160523235959",
"Sign": "AB52DAC1832949EAC322FCFD7F515A987C9E8A67",
"ShopCode": "HQ01S001",
"TradeNo": "WP01631316101000000017"
}

系统返回结果示例：

{
    "TradeNo": "AP01631316101000000017",
    "OutTradeNo": "",
    "RetryFlag": "N",
    "Action": "close",
    "Code": 1000,
    "Msg": "Success"
}

 业务错误码：

附表1