4.1数据同步接口


请求参数:

字段名称 类型 可空 说明 最长长度 备注
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&timestamp=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。


yinjr 2024年9月25日 14:47 收藏文档