开发平台

电话咨询 400-000-7749

QQ咨询

预付卡API

更新时间:2018-08-03

1. 分页查询预付卡规则

2. 分页查询预付卡制卡明细

3. 分页查询预付卡售卡明细

1. 分页查询预付卡规则

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/PrepaidCardOpenApi/queryPrepaidCardRulePages
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn" "postBackParameter": { "parameterType":"abcdef", 从返回结果中直接取出 "parameterValue":"abcdef" 从返回结果中直接取出 } }
appId	是	String	Pospal配置的访问凭证
postBackParameter	否	Json	查询首页时可以不传，之后的内容从返回结果中取出
parameterType	是	String	从返回结果中取出
parameterValue	是	String	从返回结果中取出
返回结果	{ "status": "success", "messages": [], "data": { "postBackParameter": { "parameterType": "LAST_RESULT_MAX_ID", "parameterValue": "70" }, "result": [{ "uid": 1519463111647991736, "name": "预付卡名称", "company": "门店名称", "cardAmount": 100.00, "depositAmount": 0.00, "sellPrice": 80.00, "enable": 1, "dateTime": "2018-02-24 17:46:24" }], "pageSize": 100 } }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
data	Json
postBackParameter	Json	分页查询回传到服务器的参数结构从第二页开始必须回传，如果没传，每次查询都是第一页
parameterType	String	从返回结果中直接取出用于回传，不能变其值
parameterValue	String	从返回结果中直接取出用于回传，不能变其值
uid	Long	预付卡规则唯一标识
name	String	预付卡名称
company	String	规则所属门店名称
cardAmount	Bigdecimal	卡面金额
depositAmount	Bigdecimal	押金金额
sellPrice	Bigdecimal	销售价
enable	Int	1：可制卡 -1：不可制卡
dateTime	String	规则创建时间

2. 分页查询预付卡制卡明细

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/PrepaidCardOpenApi/queryPrepaidCardPages
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn", "startTime": "2017-05-01 00:00:00", "endTime": "2017-05-05 23:59:59", "postBackParameter": { "parameterType":"abcdef", "parameterValue": "abcdef" } }
appId	是	String	Pospal配置的访问凭证
startTime	是	String	开始时间，格式为yyyy-MM-dd HH:mm:ss
endTime	是	String	结束时间，格式为yyyy-MM-dd HH:mm:ss endTime - startTime <= 5天
postBackParameter	否	Json	查询首页时可以不传，之后的内容从返回结果中取出
parameterType	是	String	从返回结果中取出
parameterValue	是	String	从返回结果中取出
返回结果	{ "status": "success", "messages": [], "data": { "postBackParameter": { "parameterType": "LAST_RESULT_MAX_ID", "parameterValue": "7444" }, "result": [{ "uid": 1519624652661444544, "company": "制卡门店", "cardNumber": "T2018022613550001", "idNumber": "TX001", "balance": 92.00, "enable": 1, "createDateTime": "2018-02-26 13:57:32", "activateDateTime": "2018-02-26 14:00:50" }], "pageSize": 100 } }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
data	Json
postBackParameter	Json	分页查询回传到服务器的参数结构从第二页开始必须回传，如果没传，每次查询都是第一页
parameterType	String	从返回结果中直接取出用于回传，不能变其值
parameterValue	String	从返回结果中直接取出用于回传，不能变其值
uid	Long	预付卡唯一标识
company	String	门店名称
cardNumber	String	预付卡卡号
idNumber	String	预付卡芯片号
balance	Bigdecimal	预付卡余额
enable	int	0-未激活 1-已激活
createDateTime	String	制卡时间
activateDateTime	String	售卡时间

3. 分页查询预付卡售卡明细

参数名	是否必须	类型	说明
接口地址	http://host:port/pospal-api2/openapi/v1/PrepaidCardOpenApi/queryPrepaidCardSalePages
请求头	User-Agent: openApi Content-Type: application/json; charset=utf-8 accept-encoding: gzip,deflate time-stamp: 1437528688233 data-signature: BF706E6AC693BA3B1BABD32E6713431D
请求方式	POST
请求体	{ "appId": "abcdefghijklmn", "startTime": "2017-05-01 00:00:00", "endTime": "2017-05-05 23:59:59", "postBackParameter": { "parameterType":"abcdef", "parameterValue": "abcdef" } }
appId	是	String	Pospal配置的访问凭证
startTime	是	String	开始时间，格式为yyyy-MM-dd HH:mm:ss
endTime	是	String	结束时间，格式为yyyy-MM-dd HH:mm:ss endTime - startTime <= 5天
postBackParameter	否	Json	查询首页时可以不传，之后的内容从返回结果中取出
parameterType	是	String	从返回结果中取出
parameterValue	是	String	从返回结果中取出
返回结果	{ "status": "success", "messages": [], "data": { "postBackParameter": { "parameterType": "LAST_RESULT_MAX_ID", "parameterValue": "7444" }, "result": [{ "uid": 1519624652661444544, "company": "售卡门店名称", "cashierUid": 832101480292933201, "cardUid": 1519624652661444544, "receiveAmount": 80.00000, "initialAmount": 100.00000, "payMethod": "现金", "activateType": 1, "activateTime": "2018-02-26 14:00:50", "remark": "" }], "pageSize": 100 } }
字段名	类型	说明
status	String	是否正确处理请求，返回success或error，不区分大小写
messages	String[]	处理结果的消息
errorCode	int	业务处理的错误代码,参见错误代码表
data	Json
postBackParameter	Json	分页查询回传到服务器的参数结构从第二页开始必须回传，如果没传，每次查询都是第一页
parameterType	String	从返回结果中直接取出用于回传，不能变其值
parameterValue	String	从返回结果中直接取出用于回传，不能变其值
uid	Long	售卡记录唯一标识
company	String	售卡门店名称
cardUid	Long	预付卡唯一标识
cashierUid	Long	售卡收银员唯一标识
receiveAmount	Bigdecimal	预付卡销售金额
initialAmount	Bigdecimal	预付卡初始可用金额
payMethod	Bigdecimal	售卡支付方式
activateType	Int	激活类型 -1：反激活 1：激活
activateTime	String	售卡时间
remark	String	售卡备注