1.     支付宝类

交易地址:http://IP:9900/ZlAliPay/ZlAliPay.asmx?wsdl

1.1.    支付宝初始化 HelloAliPay

业务代码

HelloAliPay

业务名称

支付宝初始化

接口描述

检测支付宝服务是否正常。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string HelloAliPay()

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

 

 

 

 

 

V1.0

无入参信息

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

Type

加密类型

String

200

1.明文 2.BASE64 3.SM4

V1.0

Key

交易密钥

String

16

SM4服务采用加密时返回密钥,具体加密方式。

V1.0

{

  "Code": "0",

  "Note": "支付宝初始化成功!",

  "Type": "NO",

  "Key": "6963117176135678"

}

1.2.    统一收单交易创建接口 NativePay

业务代码

NativePay

业务名称

统一收单交易创建接口

接口描述

向支付宝下单,返回支付宝扫描的二维码地址。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string NativePay(string subject, string body, string total_fee, string goods_id, string out_trade_no, string store_id, string operator_id)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

subject

订单标题

String

20

 

V1.0

body

对交易或商品的描述

String

50

 

V1.0

total_fee

订单总金额

String

10

单位为元,精确到小数点后两位,取值范围[0.01,100000000]

V1.0

goods_id

商品的编号

String

50

 

V1.0

out_trade_no

商户订单号

String

64

64个字符以内、只能包含字母、数字、下划线;需保证在商户端不重复

V1.0

store_id

商户门店编号

String

20

传医院院区编号

V1.0

operator_id

商户操作员编号

String

20

传自助设备编号

V1.0

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

Url

扫码地址

String

200

当前预下单请求生成的二维码码串,可以用二维码生成工具根据该码串值生成对应的二维码

V1.0

{

      "Code": "0",

      "Note": "统一收单交易创建接口成功!",

      "Url": "https://qr.alipay.com/bax05969gryv2bgsqard00b6"

}

1.3.    统一收单线下交易查询接口 OrderQuery

业务代码

OrderQuery

业务名称

统一收单线下交易查询

接口描述

根据商户订单号查询二给码扫码交易是否成功。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string OrderQuery(string out_trade_no)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

out_trade_no

商户订单号

String

64

 

V1.0

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

OutTradeNo

支付宝交易号

String

64

 

V1.0

OutTradeNo

商家订单号

String

64

 

V1.0

BuyerLogonId

买家支付宝账号

String

50

 

V1.0

BuyerUserId

买家在支付宝的用户id

String

50

 

V1.0

TotalAmount

交易的订单金额

String

10

单位为元,两位小数。该参数的值为支付时传入的total_amount

V1.0

TradeStatus

交易状态

String

20

WAIT_BUYER_PAY(交易创建,等待买家付款)

TRADE_CLOSED(未付款交易超时关闭,或支付完成后全额退款)、TRADE_SUCCESS(交易支付成功)

TRADE_FINISHED(交易结束,不可退款)

V1.0

SendPayDate

本次交易打款给卖家的时间

String

 

YYYY-MM-DD HH:MM:SS

V1.0

{

      "Code": "0",

      "Note": "统一收单线下交易查询成功!",

      "TradeNo": "2018102922001415251008407630",

      "OutTradeNo": "1481739332mz1262018102909434471",

      "BuyerLogonId": "186****8986",

      "BuyerUserId": "2088902127515251",

      "TotalAmount": "159.39",

      "TradeStatus": "TRADE_SUCCESS",

      "SendPayDate": "2018-10-29 09:44:00"

}

1.4.    统一收单交易退款接口 Refund

业务代码

Refund

业务名称

统一收单交易退款接口

接口描述

根据商户订单号申请退款。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string Refund(string out_trade_no, string out_request_no, string refund_amount, string refund_reason)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

out_trade_no

商户订单号

String

64

 

V1.0

out_request_no

退款请求单号保持唯一性

String

64

 

V1.0

refund_amount

退款金额

String

10

单位为元,两位小数。该参数的值为支付时传入的total_amount

V1.0

refund_reason

退款原因

String

50

 

V1.0

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

TradeNo

支付宝交易号

String

64

 

V1.0

OutTradeNo

商家订单号

String

64

 

V1.0

BuyerLogonId

买家支付宝账号

String

 

 

V1.0

BuyerUserId

买家在支付宝的用户id

String

 

 

V1.0

RefundFee

退款总金额

String

 

单位为元,两位小数。该参数的值为支付时传入的total_amount

V1.0

FundChange

本次退款是否发生了资金变化

String

 

 

V1.0

GmtRefundPay

退款支付时间

String

 

YYYY-MM-DD HH:MM:SS

V1.0

{

      "Code": "0",

      "Note": "统一收单线下交易退款接口成功!",

      "TradeNo": "2018102922001415251008407630",

      "OutTradeNo": "1481739332mz1262018102909434471",

      "BuyerLogonId": "186****8986",

      "BuyerUserId": "2088902127515251",

      "RefundFee": "0.01",

      "FundChange": "Y",

      "GmtRefundPay": "2018-11-01 15:32:01"

}

1.5.    统一收单获取对帐单接口 GetAllOrder

业务代码

Refund

业务名称

统一收单交易退款接口

接口描述

根据商户订单号申请退款。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string Refund(string out_trade_no, string out_request_no, string refund_amount, string refund_reason)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

strDate

交易日期

String

10

YYYY-MM-DD

 

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

TotalInfo 汇总信息

 

门店编号

门店编号

String

 

院区编号

 

门店名称

门店名称

String

 

 

 

交易订单总笔数

交易订单总笔数

String

 

 

 

退款订单总笔数

退款订单总笔数

String

 

 

 

订单金额

订单金额

String

 

 

 

商家实收

商家实收

String

 

 

 

商家优惠

商家优惠

String

 

 

 

卡消费金额

卡消费金额

String

 

 

 

服务费

服务费

String

 

 

 

分润

分润

String

 

 

 

分润

分润

String

 

 

 

DetailInfo 明细信息

 

支付宝交易号

支付宝交易号

String

 

 

 

商户订单号

商户订单号

String

 

 

 

业务类型

业务类型

String

 

 

 

商品名称

商品名称

String

 

 

 

创建时间

创建时间

String

 

 

 

完成时间

完成时间

String

 

 

 

门店编号

门店编号

String

 

 

 

门店名称

门店名称

String

 

 

 

操作员

操作员

String

 

 

 

终端号

终端号

String

 

 

 

对方账户

对方账户

String

 

 

 

订单金额

订单金额

String

 

 

 

商家实收

商家实收

String

 

 

 

支付宝红包

支付宝红包

String

 

 

 

集分宝

集分宝

String

 

 

 

支付宝优惠

支付宝优惠

String

 

 

 

商家优惠

商家优惠

String

 

 

 

券核销金额

券核销金额

String

 

 

 

券名称

券名称

String

 

 

 

商家红包消费金额

商家红包消费金额

String

 

 

 

卡消费金额

卡消费金额

String

 

 

 

退款批次号请求号

退款批次号请求号

String

 

 

 

服务费

服务费

String

 

 

 

分润

分润

String

 

 

 

备注

备注

String

 

 

 

{

      "Code": "0",

      "Note": "获取交易明细成功!",

      "TotalInfo": [{

            "门店编号": "mz122",

            "门店名称": "mz122 ",

            "交易订单总笔数": "1",

            "退款订单总笔数": "0",

            "订单金额": "20.00",

            "商家实收": "20.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "卡消费金额": "0.00",

            "服务费": "0.00",

            "分润": "-20.00",

            "实收净额": "0.00"

      }, {

            "门店编号": "mz124",

            "门店名称": "mz124 ",

            "交易订单总笔数": "1",

            "退款订单总笔数": "0",

            "订单金额": "110.00",

            "商家实收": "110.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "卡消费金额": "0.00",

            "服务费": "0.00",

            "分润": "-110.00",

            "实收净额": "0.00"

      }, {

            "门店编号": "mz125",

            "门店名称": "mz125 ",

            "交易订单总笔数": "2",

            "退款订单总笔数": "0",

            "订单金额": "330.61",

            "商家实收": "330.61",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "卡消费金额": "0.00",

            "服务费": "0.00",

            "分润": "-330.61",

            "实收净额": "0.00"

      }, {

            "门店编号": "mz126",

            "门店名称": "mz126 ",

            "交易订单总笔数": "1",

            "退款订单总笔数": "0",

            "订单金额": "159.39",

            "商家实收": "159.39",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "卡消费金额": "0.00",

            "服务费": "0.00",

            "分润": "-159.39",

            "实收净额": "0.00"

      }, {

            "门店编号": "mz127",

            "门店名称": "mz127 ",

            "交易订单总笔数": "1",

            "退款订单总笔数": "0",

            "订单金额": "233.16",

            "商家实收": "233.16",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "卡消费金额": "0.00",

            "服务费": "0.00",

            "分润": "-233.16",

            "实收净额": "0.00"

      }],

      "DetailInfo": [{

            "支付宝交易号": "2018102922001486185415997487",

            "商户订单号": "1481739332mz12520181029081345115",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 08:13:59",

            "完成时间": "2018-10-29 08:14:03",

            "门店编号": "mz125",

            "门店名称": "mz125",

            "操作员": "mz125",

            "终端号": "",

            "对方账户": "*洋(150***@qq.com)",

            "订单金额": "255.61",

            "商家实收": "255.61",

            "支付宝红包": "4.16",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "线下_线下兜底红包模板",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-255.61",

            "备注": "1481739332mz12520181029081345115"

      }, {

            "支付宝交易号": "2018102922001425675409216141",

            "商户订单号": "1481739332mz12420181029085714554",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 08:57:20",

            "完成时间": "2018-10-29 08:57:24",

            "门店编号": "mz124",

            "门店名称": "mz124",

            "操作员": "mz124",

            "终端号": "",

            "对方账户": "*越(153****1242)",

            "订单金额": "110.00",

            "商家实收": "110.00",

            "支付宝红包": "0.00",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-110.00",

            "备注": "1481739332mz12420181029085714554"

      }, {

            "支付宝交易号": "2018102922001415251008407630",

            "商户订单号": "1481739332mz1262018102909434471",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 09:43:51",

            "完成时间": "2018-10-29 09:44:00",

            "门店编号": "mz126",

            "门店名称": "mz126",

            "操作员": "mz126",

            "终端号": "",

            "对方账户": "*慧玲(186****8986)",

            "订单金额": "159.39",

            "商家实收": "159.39",

            "支付宝红包": "0.00",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-159.39",

            "备注": "1481739332mz1262018102909434471"

      }, {

            "支付宝交易号": "2018102922001400385416520299",

            "商户订单号": "1481739332mz12720181029095913427",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 09:59:25",

            "完成时间": "2018-10-29 09:59:31",

            "门店编号": "mz127",

            "门店名称": "mz127",

            "操作员": "mz127",

            "终端号": "",

            "对方账户": "*鑫(nb0***@sina.com)",

            "订单金额": "233.16",

            "商家实收": "233.16",

            "支付宝红包": "0.00",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-233.16",

            "备注": "1481739332mz12720181029095913427"

      }, {

            "支付宝交易号": "2018102922001481825425778037",

            "商户订单号": "1481739332mz12520181029100012594",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 10:00:17",

            "完成时间": "2018-10-29 10:00:21",

            "门店编号": "mz125",

            "门店名称": "mz125",

            "操作员": "mz125",

            "终端号": "",

            "对方账户": "*拉吉哈木(584***@qq.com)",

            "订单金额": "75.00",

            "商家实收": "75.00",

            "支付宝红包": "0.00",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-75.00",

            "备注": "1481739332mz12520181029100012594"

      }, {

            "支付宝交易号": "2018102922001416051009080323",

            "商户订单号": "1481739332mz12220181029154130715",

            "业务类型": "交易",

            "商品名称": "呼伦贝尔市中蒙医院自助机支付",

            "创建时间": "2018-10-29 15:41:34",

            "完成时间": "2018-10-29 15:41:48",

            "门店编号": "mz122",

            "门店名称": "mz122",

            "操作员": "mz122",

            "终端号": "",

            "对方账户": "*纯厚(136****5575)",

            "订单金额": "20.00",

            "商家实收": "20.00",

            "支付宝红包": "0.00",

            "集分宝": "0.00",

            "支付宝优惠": "0.00",

            "商家优惠": "0.00",

            "券核销金额": "0.00",

            "券名称": "",

            "商家红包消费金额": "0.00",

            "卡消费金额": "0.00",

            "退款批次号请求号": "",

            "服务费": "0.00",

            "分润": "-20.00",

            "备注": "1481739332mz12220181029154130715"

      }]

}

1.6.    统一收单交易关闭接口 CloseOrder

业务代码

Refund

业务名称

统一收单交易退款接口

接口描述

根据商户订单号申请退款。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string Refund(string out_trade_no, string out_request_no, string refund_amount, string refund_reason)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

out_trade_no

商户订单号

String

64

 

V1.0

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.0

Note

交易说明

String

200

 

V1.0

{

      "Code": "0",

      "Note": "统一收单线下交易关闭接口成功!"

}

1.7.    统一收单支付通知接口 ResultNotify

业务地址

http://IP:Port/ZlWeiXinPay/example/ResultNotifyPage.aspx

业务名称

统一收单支付通知接口

接口描述

由于三方扫码后,将订单信息将由此页面,处理后的结算再通过三方,进行二次开发及数据服务处理。

主要使用者

三方机构特色平台,自助终端,移动终端。

转发回调服务

http://192.168.0.99:8099/zlPay.asmx?wsdl

接口原型

public string ResultNotifys(string strJson)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

appid

公众账号ID

String

32

微信分配的公众账号ID(企业号corpid即为此appId)

V1.2

mch_id

商户号

String

32

微信支付分配的商户号

V1.2

device_info

设备号

String

32

微信支付分配的终端设备号,

V1.2

nonce_str

随机字符串

String

32

随机字符串,不长于32位

V1.2

sign

签名

String

32

签名,详见签名算法

V1.2

{

  "appid": "wx04ce0d0b70ee7ead",

  "attach": "test",

  "bank_type": "CFT",

  "cash_fee": "1",

  "fee_type": "CNY",

  "is_subscribe": "Y",

  "mch_id": "1461693802",

  "nonce_str": "1125519735",

  "openid": "oFPLe0aohaXLkkRiurBwpMbHnM5w",

  "out_trade_no": "146169380220191031142321473",

  "result_code": "SUCCESS",

  "return_code": "SUCCESS",

  "sign": "228CD6B448EDFF72552F6F9692E036441A63A94A1A9B619947A7AD7C421A81CB",

  "time_end": "20191031142331",

  "total_fee": "1",

  "trade_type": "NATIVE",

  "transaction_id": "4200000417201910317602015709"

}

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.2

Note

交易说明

String

200

 

V1.2

 

 

1.8.    统一收单交易付款码支付接口 BarPay

业务代码

BarPay

业务名称

统一收单交易创建接口

接口描述

向支付宝下单,返回支付宝扫描的二维码地址。

主要使用者

三方机构特色平台,自助终端,移动终端。

接口原型

public string NativePay(string barCode, string subject, string body, string total_fee, string goods_id, string out_trade_no, string store_id, string operator_id)

请求消息

XML节点

字段说明

数据类型

长度

说明

版本

barCode

付款码

String

20

支付宝付款码

V1.3

subject

订单标题

String

20

 

V1.3

body

对交易或商品的描述

String

50

 

V1.3

total_fee

订单总金额

String

10

单位为元,精确到小数点后两位,取值范围[0.01,100000000]

V1.3

goods_id

商品的编号

String

50

 

V1.3

out_trade_no

商户订单号

String

64

64个字符以内、只能包含字母、数字、下划线;需保证在商户端不重复

V1.3

store_id

商户门店编号

String

20

传医院院区编号

V1.3

operator_id

商户操作员编号

String

20

传自助设备编号

V1.3

 

应答消息

XML节点

字段说明

数据类型

长度

说明

版本

Code

交易结果

String

4

0.成功 -1失败

V1.3

Note

交易说明

String

200

 

V1.3

TradeNo

支付订单号

String

200

扫码支付后,返回的三方支付平台的流水号。

V1.3

{

    "Code": "0",

    "Note": "统一收单交易创建接口成功!",

    "ThreeNo": "2019121722001428770596152906"

}