欢迎光临合肥新店商信息技术咨询有限公司官方网站!
  咨询电话:400-0551-517

新闻相关

Windows SDK 概述

1. Windows SDK 概述


1.2 收银机扫码支付流程1.1 SDK 概述

该 SDK 插件由新店收提供收银机软件厂商开发使用,可通过该 SDK 插件实现支付宝钱包交易、微信支付交易等功能。 SDK 插件名称:MISCIL.DLL

1.收银机软件平台在购物结算时,在现有支付方式(现金、刷卡、会员卡等)基础上,增加“扫码支付”支付方式,并在收银机键盘上,绑定快捷入口功能键;

2.当消费者选择支付宝或微信支付时,收银员通过快捷键,调起扫码支付界面,同时屏幕提示收银员扫描消费者手机条码;收银机界面如下(仅供参考),该界面由收银软件厂商实现。

3.扫码成功后,收银软件通过扫码支付接口,发起支付交易请求;

4.支付交易请求返回成功后,收银软件进行小票打印处理;并将扫码核销信息附加打印到消费者小票上;

5.对于扫码支付交易,可以免签名;考虑收银员对帐需求,要求收银软件调用打印一份商家小票。

2. SDK 插件说明

2.1 接口说明

SDK 插件内部函数定义如下: int SCPayFix( void inStr, void outStr );

参数说明如下:

inStr : 输入字符串的缓冲区,格式定义如下:数据值1数据值2数据值3数据值N…

outStr: 返回字符串的缓冲区,格式同输入字符

注:入参 outStr 须由调用者分配空间,请至少分配 2048 Byte 的内存

返回值为int型,0为成功,非0为失败,具体返回代码如下:

0:函数正常返回

1:超时

2:输入字符串无效

4:输入字符串数据长度错误

5:输入字符串必填项缺失

6:输出缓冲区无效

7:输出字符串内存分配不够

8:返回报文为空

9:返回报文错误

10:解包失败

11:加载配置文件失败或关键配置项错误

12:设置超时时间失败

14:创建连接失败

15:发送数据失败

16:生成签名失败

17:验签失败

18:终端号为空

19:域名转IP失败

(一)输入参数接口(inStr)

下表中每个字段的长度固定,实际值长度不足时,后补空格,字段会有拓展请兼容返回更多字段的情况;

某个字段没有值的时候,以空格填充;

将各个字段按顺序拼接成一个字符串,作为inStr参数。

必要性说明:M-必填,C-满足条件则必填,O-选填。

数据名称数据长度起始位置必要性取值说明
订单号640M同商户号下不可重复,格式建议:交易时间+随机串,例如:201505121220210009654
关联订单号6464C源交易订单号,撤消、退款、查询、取消交易必填;
交易类型4128MPURC:下单支付,适用于手机被扫场景,生成订单并直接支付。VOID:撤消;REFD:退款;INQY:查询;PAUT:预下单,适用于手机主动扫场景,用户获取生成二维码的字符串并生成订单;VERI:卡券核销CANC:取消,对成功支付订单进行撤销,对未成功支付订单进行关闭订单。
关联交易类型4132C指当前交易的关联交易的交易类型,例如查询交易,如查下单支付交易,其关联交易类型则为:PURC查询交易中必填写,其他交易可填可不填;
渠道5136M填写空格:表示不指定渠道;返回数据中会返回支付渠道
订单金额12141C1、交易金额单位为元,如有小数点,小数点占一个字符,格式示例:123.88;2、卡券核销时不需要;
条码值32153C1、下单支付时必须填写有效值,该值由收银平台通过扫码枪或其他输入方式获取;2、预下单时不需要;
操作员号8185O
门店号/终端号8193O此字段上门店号或终端号
商品名称512201C条件允许时,由收银软件上送,该信息可以提供消费者在支付宝和微信平台上查阅。商品名称上送格式如下:商品名称1,单价,数量;…;商品名称n,单价,数量。各要素之间逗号分隔,每条之间分号分隔。内容之间不能有空格
交易币种3713C交易币种为外币时上送,按照ISO 4217标准填写三位字母代码,默认人民币:CNY

(二)返回参数接口(outStr)

下表中每个字段的长度固定,实际值长度不足时,后补空格;

某个字段没有值的时候,以空格填充;

将各个字段按顺序拼接成一个字符串,作为outStr参数;

必要性说明:M-必填,C-满足条件则必填,O-选填。

数据名称数据长度起始位置必要性取值说明
订单号640M
订单金额1264C
交易结果276M00:交易成功;09:交易处理中,需要另外发起查询
错误信息51278M失败时返回错误信息
渠道交易号64590C交易成功时返回
渠道账号100654C交易成功时返回
渠道账号ID16754C交易成功时返回
优惠信息60770O
返回QR信息60830O
说明信息60890O
卡券类型40950C卡券核销成功时返回
卡券详情512990C卡券核销成功时返回
渠道51502M返回ALP表示支付宝,WXP表示微信支付。

2.2 签购单说明

SDK 插件将签购单文件生成到应用程序所在,文件名格式为:SCprint.txt。 签购单文件可按配置文件生成,可生成商户联和顾客联,支持免签;

2.3 配置文件说明

文件名:scSys.ini, SDK 插件使用该配置文件,进行相关参数的配置和控制。 文件内容如下,具体可查看插件包

[基础信息] 
机构号= 99911888                        //机构号
商户编号= 100000000000011               //商户代码
收银台号=00792289                       //终端号
商户名称=测试商户                       //商户名称,签购单打印名称
MKEY= zsdfyreuoyamdphhaweyrjbvzkgfdycs  //商户KEY 

[讯联应用] 
服务器转发=0                        //是否在商户处设置后台服务器
服务器地址= 211.147.72.70              //服务器转发打开时为服务器地址,关闭时此设置无效
服务端口=10002                    //服务器转发打开时为服务器监听端口,关闭时此设置无效
超时时间=65                      //通讯超时时间
最大连接数=9                          //并发连接数限制
中文编码方式=1                        //1-GB2312
应用版本=2.2

[打印控制] 
打印商户联=1
打印顾客联=0
打印营销信息=1
签购单空行数=4                        //控制签购单尾部输出的空行的个数
打印行宽度=32                         //为兼容汉字的打印,请设置为偶数

[系统信息]
调用热键=113
验证收银员=0
交易后自动退出=0
拨号模式=0
服务器转发=1                            //是否在商户处设置后台服务器,1使用该配置文件的IP


上一条:新店收开发文档 下一条:没有了

新闻中心

联系我们

公 司:合肥新店商信息技术咨询有限公司

联系人:管照红

电话:400-0551-517

手机:13965106133

E-mail:hfxds2018@sina.com

地 址:合肥市蜀山区望江西路69号西湖国际D座1504