请求参数:
字段名称 | 类型 | 可空 | 说明 | 最长长度 | 备注 |
---|---|---|---|---|---|
appid | String | 否 | 收银宝APPID | 8 | |
cusid | String | 否 | 收银宝商户号 | 15 | |
trxcode | String | 否 | 接口编号 | 4 | 必须填:T001 |
version | String | 否 | 接口版本编号 | 2 | 1 |
timestamp | String | 否 | 调用时间戳 | 14 | yyyymmddhhmmss |
randomstr | String | 否 | 随机字符串 | 32 | 主要用于随机加签 |
signtype | String | 否 | 签名类型 | 8 |
RSA SM2 |
sign | String | 否 | sign校验码 | 32 | |
termid | String | 否 | 终端/二维码编码 | 32 | |
source | String | 是 | 请求来源 | 1 |
1或者空为传统终端 2:当面付二维码 |
bizseq | String | 否 | 业务流水号 | 50 | 如订单号,保单号,缴费编号等 |
trxreserve | String | 否 | 业务关联内容 | 250 | 详见附录终端POS业务关联内容填写规范 |
响应参数:
字段名称 | 类型 | 可空 | 说明 | 最长长度 | 备注 |
---|---|---|---|---|---|
appid | String | 否 | 收银宝APPID | 8 | |
cusid | String | 否 | 收银宝商户号 | 15 | |
trxcode | String | 否 | 接口编号 | 4 | 必须填:T001 |
timestamp | String | 否 | 调用时间戳 | 14 | yyyymmddhhmmss |
randomstr | String | 否 | 随机字符串 | 32 | 主要用于随机加签 |
sign | String | 否 | sign校验码 | 32 | |
bizseq | String | 可 | 业务流水号 | 50 | 参见请求参数字段说 |
retcode | String | 否 | 响应码 | 4 |
0000表示成功 9999 查询失败,错误提示详见响应信息 |
retmsg | String | 可 | 响应消息 | 128 | 错误提示信息,响应码为9999时,此字段不能为空 |
amount | String | 可 | 金额 | 20 | 单位为分,如是订单查询,返回不可为空 |
trxreserve | String | 可 | 业务关联内容 | 250 | 详见附录终端POS业务关联内容填写规范 |
extreserve | String | 可 | 业务扩展内容 | 999 |
本字段为个性化项目需要透传较多信息时候使用 本字段不保留到交易数据库,系统不提供查询功能 |
asinfo | String | 可 | 分账信息 | 1024 |
格式:cusid:type:amount 其中 cusid:接收分账的通联商户号 type分账类型(01:按金额 02:按比率) 如果分账类型为02,则分账比率为0.5表示50% 如果分账类型为01,则分账金额以元为单位表示 开通此业务需开通分账配置 |
样例数据:通联商户号:990605055336000,appid:00000155,交易密钥key:43df939f1e7f5c6909b3f4b63f893994
请求样例:
appid=00000155
bizseq=7654321
cusid=990605055336000
key=43df939f1e7f5c6909b3f4b63f893994
randomstr=000004
termid=00000013
timestamp=20171218181137
trxcode=T001
trxreserve=05#
version=01
sign=3f6f87ad04be874e15ea820f98c8cb2f
组织后的加密明文:appid=00000155&bizseq=7654321&cusid=990605055336000&key=43df939f1e7f5c6909b3f4b63f893994&randomstr=000004&termid=00000013×tamp=20171218181137&trxcode=T001&trxreserve=05#&version=01
返回样例:
{"amount":"100","appid":"00000155","asinfo":"990581053996001:01:0.03","bizseq":"7654321","cusid":"990605055336000","randomstr":"77893244","retcode":"0000","retmsg":"处理成功","sign":"79fddbfc42bafbd6cfffdf030f4a133c","timestamp":"20171218182221","trxcode":"T001","trxreserve":"05##文西#广州体育西#15820335584#TN000001#01#440992198709257433####"}
其中asinfo表示该笔交易金额1元,需要分账3分钱到指定收银宝商户990581053996001。