shebao-server/docs/proto/md/3社保流水.md

###社保流水

1. 流水列表接口

流水列表数据，共有两个接口，未付款的接口和已付款的接口。

1.1 未付款的接口请求

• URI

  /sbl/order/wage/list0/v1    POST    //未付款的接口
  

• 未付款的接口参数:

  String key;    // 当前用户的登录标识
  

1.2 已付款的接口请求

• URI

  /sbl/order/wage/list1/v1    POST    //已付款的接口
  

• 已付款的接口参数:

  String key;    // 当前用户的登录标识
  

1.3 响应数据是一样的

返回登录是否有效;
返回流水的列表数据。

• 响应状态码

  200      处理成功,带有列表数据.
  10004    登录超时.  
  

• 响应字段

  /** 单号 */
  private String order_no;
  /** 核算(操作)月份 */
  private int opt_month;
  /** 服务费 */
  private double charge;
  /** 流水金额 */
  private double wage;
  /** 支付金额 */
  private double total_fee;
  /** 最晚支付日期 */
  private String pay_date;
  /** 支付状态 */
  private int pay_status;
  /** 生成时间 */
  private String gen_time;
  /** 支付时间 */
  private String pay_time;  // 用户付款成功后，才有时间值
  /** 返还时间 */
  private String hf_time;  // 专员做了返还，才有时间值
  
  /** 参保用户的ID */
  private int sbu_id;
  /** 参保用户 */
  private String uname;
  /** 城市名称 */
  private String city;
  

• 支付状态码 （pay_status）

  1        待支付
  2        支付成功
  4        返还成功
  11       全额退款
  

• 响应数据范例

  {
      "msg": "",
      "data": [{
          "order_no": "0110010000000023201812",
          "opt_month": 201812,
          "charge": 35.0,
          "wage": 2900.0,
          "total_fee": 2935.0,
          "pay_date": "2018-12-14",
          "pay_status": 2,
          "gen_time": "2018-12-11 16:26:16",
          "pay_time": "2018-12-11 17:26:16",
          "hf_time": null,
          "sbu_id": 23,
          "uname": "囡囡",
          "city": "广州"
      }],
      "code": 200
  }
  

---

2. 流水单支付接口

在流水列表数据里，传递 order_no 字段的值到接口，获取支付前的数据。

2.1 接口请求

• URI

  /sbl/order/wage/pay/v1    POST    
  

• 接口参数:

  String key;    // 当前用户的登录标识
  String order_no;    // 流水单号
  int pay_channel;    // 支付渠道标识（类同社保支付）
  

2.2 响应数据

响应支付准备的数据，分 微信 与 支付宝

• 支付宝下单的响应

   {
      "msg": "",
      "data": "partner=\"2088021344618397\"
          &seller_id=\"service@shanp.com\"
          &out_trade_no=\"W11524372652587\"
          &subject=\"“我的社保-” 支付\"
          &body=\"社保流水"
          &total_fee=\"0.04\"
          &notify_url=\"http://192.168.2.199/pay/ali/app/notify/v1\"
          &service=\"mobile.securitypay.pay\"
          &payment_type=\"1\"
          &_input_charset=\"utf-8\"
          &it_b_pay=\"30m\"
          &sign=\"this is sign str base64\"
          &sign_type=\"RSA2\"",
      "code": 200
  }
  

• 微信支付下单的响应

  {
      "data": {
          "order_no": "W11524372652587",
          "wx": {
              "appid": "wxb7ae6e9f32e0bdb2",
              "noncestr": "08xVtTSFCuYsZmhF",
              "timestamp": "1441879029",
              "partnerid": "1268473701",
              "prepayid": "wx201509101757102b1fd039c50530073556",
              "sign": "6F2371A7C9917D866485C5E7BA97D1DB",
              "package": "Sign=WXPay"
          },
      "msg": "",
      "code": 200
  }
  

---