# 支付平台
# 概述
此文档是腾讯健康支付平台第三方接口文档。网关接入请看网关接入标准。
# 接口说明
- 获取对账单接口
测试环境:
https://med-biz-pre.wecity.qq.com/api/pay/downloadBill/{partnerId}
Request:
{
"billDate": "20181228",
"billType": "ALL",
"appName": ""
}
字段 | 类型 | 是否必填 | 描述 |
---|---|---|---|
billDate | String | 是 | 下载对账单的日期,格式:20140603 |
billType | String | 否 | ALL,返回当日所有订单信息,默认值, SUCCESS,返回当日成功支付的订单,REFUND,返回当日退款订单,RECHARGE_REFUND,返回当日充值退款订单 |
appName | String | 是 | 由平台统一分配 |
Response:
{
"code": 0,
"msg": "SUCCESS",
"data": "交易时间,公众账号ID,商户号,特约商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,微信退款单号,商户退款单号,退款金额,充值券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率,订单金额,申请退款金额,费率备注\r\n`2018-12-28 10:12:25,`wxa5838e226cb3951c,`1800007780,`1493846692,`,`4200000213201812284629720095,`9432170312785511424,`oHy7q0Plu0TWVA-Z3LQR-Vd9mQRo,`JSAPI,`SUCCESS,`CMB_CREDIT,`CNY,`826.25,`0.00,`0,`0,`0.00,`0.00,`,`,`北大医院A套餐(男士),`,`0.00000,`0.00%,`826.25,`0.00,`\r\n`2018-12-28 10:03:55,`wxa5838e226cb3951c,`1800007780,`1493846692,`,`4200000222201812282839106165,`9430078101437101059,`oHy7q0HNar1IiSPG8qDALQOZ18K4,`JSAPI,`SUCCESS,`CFT,`CNY,`0.01,`0.00,`0,`0,`0.00,`0.00,`,`,`体检套餐A1(男士),`,`0.00000,`0.00%,`0.01,`0.00,`\r\n`2018-12-28 10:02:28,`wxa5838e226cb3951c,`1800007780,`1493846692,`,`4200000226201812284732877993,`9429619603335099393,`oHy7q0HNar1IiSPG8qDALQOZ18K4,`JSAPI,`SUCCESS,`CFT,`CNY,`0.01,`0.00,`0,`0,`0.00,`0.00,`,`,`全面防癌体检卡(男士),`,`0.00000,`0.00%,`0.01,`0.00,`\r\n`2018-12-28 00:23:59,`wxa5838e226cb3951c,`1800007780,`1493846692,`,`4200000235201812281075172263,`9284130087752208385,`oHy7q0HCYKandZkEt87PvGdE67yc,`JSAPI,`SUCCESS,`CFT,`CNY,`0.01,`0.00,`0,`0,`0.00,`0.00,`,`,`北大医院A套餐(男士),`,`0.00000,`0.00%,`0.01,`0.00,`\r\n总交易单数,应结订单总金额,退款总金额,充值券退款总金额,手续费总金额,订单总金额,申请退款总金额\r\n`4,`826.28,`0.00,`0.00,`0.00000,`826.28,`0.00\r\n"
}
当返回结果code为0时接口调用成功。
成功时,数据以文本表格的方式返回,第一行为表头,后面各行为对应的字段内容,字段内容跟查询订单或退款结果一致,具体字段说明可查阅相应接口。
- 第一行为表头,根据请求下载的对账单类型不同而不同(由bill_type决定), 目前有:
- 当日所有订单 交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额,代金券或立减优惠金额,微信退款单号,商户退款单号,退款金额, 代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
- 当日成功支付的订单 交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额, 代金券或立减优惠金额,商品名称,商户数据包,手续费,费率
- 当日退款的订单 交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,总金额, 代金券或立减优惠金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额, 代金券或立减优惠退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率
- 从第二行起,为数据记录,各参数以逗号分隔,参数前增加`符号,为标准键盘1左边键的字符,字段顺序与表头一致。倒数第二行为订单统计标题,最后一行为统计数据:总交易单数,总交易额,总退款金额,总代金券或立减优惠退款金额,手续费总金额
- 错误码
名称 | 描述 | 原因 |
---|---|---|
系统异常(异常码:-1) | 系统异常导致的错误 | 系统异常导致的错误 |
SYSTEMERROR | 下载失败 | 系统超时 |
invalid bill_type | 参数错误 | 请求参数未按指引进行填写 |
data format error | 参数错误 | 请求参数未按指引进行填写 |
missing parameter | 参数错误 | 请求参数未按指引进行填写 |
SIGN ERROR | 参数错误 | 请求参数未按指引进行填写 |
NO Bill Exist | 账单不存在 | 当前商户号没有已成交的订单,不生成对账单 |
Bill Creating | 账单未生成 | 当前商户号没有已成交的订单或对账单尚未生成 |