电子发票介绍

一、商米电子发票产品介绍

商米电子发票为SaaS软件提供一站式的商户电子发票解决方案,发票电子化、抛开繁琐的纸票管理,顾客自助扫码,无须人工介入。

支持航信与百旺税控设备,提供托管、税控盒子、PC电脑3种安装方案,满足商户多样化需求。SaaS软件可通过调用商米电子发票app,完成开票服务。仅需一次对接开发,即可便捷实用电子发票服务。

商米电子发票对接文档 APP对接版(仅支持商米设备:支持T系列、D系列、S系列、V系列、P系列、L系列、M系列;当前仅支持中国大陆地区开电子发票服务)

电子发票接入对接人:王长海 13585856752

电子发票产品介绍

一、商米电子发票产品介绍

商米电子发票为SaaS软件提供一站式的商户电子发票解决方案,发票电子化、抛开繁琐的纸票管理,顾客自助扫码,无须人工介入。

支持航信与百旺税控设备,提供托管、税控盒子、PC电脑3种安装方案,满足商户多样化需求。SaaS软件可通过调用商米电子发票app,完成开票服务。仅需一次对接开发,即可便捷实用电子发票服务。

商米电子发票对接文档 APP对接版(仅支持商米设备:支持T系列、D系列、S系列、V系列、P系列、L系列、M系列;当前仅支持中国大陆地区开电子发票服务)

电子发票接入对接人:王长海 13585856752

产品介绍

商米收银管家产品介绍

商米收银管家为SaaS软件提供一站式的支付解决方案。可受理微信、支付宝、支付宝人脸、银联钱包等扫码或刷脸支付方式。商米收银管家已对接多条支付通道。商米收银管家已适配商米全部机型。SaaS软件可通过调用商米收银管家,完成支付。仅需一次对接开发,即可便捷使用多条支付通道。

以下为相关开发文档和SDK,请根据实际调试设备下载使用

1)商米支付终端对接文档(非金融机型:支持T系列、D系列、S系列、X系列、K系列、H系列、V系列、M系列、L系列的机型;金融机型: 支持P1-4G、P2lite和P2机型 )

2)商米收银管家云对云接口(目前支持查询、退款、微信小程序公众号支付和支付回调操作)

支付业务接入对接人:赵琨 18101811986

商米收银管家-业务对接FAQ

商米收银管家-技术对接FAQ

接口调用,重要提醒

接口调用说明: 调用方法、代码示例

重要提醒!!!

1. 接口调用重连机制

SaaS软件与支付服务是通过AIDL机制建立链接的,SaaS软件更新或者支付服务更新都会导致通讯链接断开,此时调用接口时会返回调用失败,需要设计重连机制保证通讯链接的健壮性,否则会导致交易失败,影响商户正常营业,具体见重连机制代码示例

2. 收不到交易结果怎么办?

原因:

收不到交易结果主要原因是SaaS程序发送交易请求到收银台后, SaaS程序奔溃或被人为关闭或设备断电。

如何解决:

  • SaaS软件发起交易请求后应立即保存订单信息并将订单状态置为状态不明,如果发生异常情况(SaaS程序奔溃或被人为关闭或断电)导致接收不到交易结果, 那么SaaS软件再次启动时,对于状态不明的订单,应该要有查询机制(主动查询或给出查询按钮让用户触发都可以)调用查询接口,查询订单的最终状态。
  • 对接商米云端回调接口,交易结果以云端交易通知为最终结果(可选)

安装商米收银台更新APK与Demo

开发阶段由商米技术支持推送apk,,上线后由商米运营推送或者ROM自带。

选择支付方式

— — 银行卡支付: 消费退款 (包括退货,消费撤销、预授权撤销、预授权完成撤销) 、预授权预授权完成结算 

— — 聚合扫码支付:消费退款

— — 刷脸:消费退款 ( 刷脸支付过程无法进行debug调试,请拔出调试线)

— — 通用: 打印单笔查询批量查询

银行卡交易类型说明

— — 消费及反向交易:包括消费、退款( 包括退货,消费撤销、预授权撤销、预授权完成撤销)交易;

— — 预授权类及反向交易:预授权、预授权完成;

— — 结算(换班):在结算过程当中,将暂时禁止发生新的交易。结算完成后,支付外接设备自动签退;

— — 打印(重打印):补打最后一笔交易或者指定流水的签购单,重打印的签购单上须具有补打标记字样。重打印功能只适用于当批次结算前的交易

— — 交易记录查询:用于查阅受理终端(或支付集成软件)上存储的当批次交易。

其他说明(金融设备,打印和常见问题)

关于金融设备(P系列)的说明

1、第三方调用时会判断签到状态,如非签到状态会需要先签到。首次签到流程会自动化进行终端主密钥下载,终端参数下载等步骤的操作。签到时如果失败会将相应的错误信息返回 APP。

2、交易成功但打印签购单失败,视为交易未结束,必须打印成功后再发起成功交易回调。

3、POS外设断电、POS应用奔溃等异常情况下,接收不到交易结果,出现长短款现象,需要调用查询接口查询该笔交易,避免打印失败但收单交易成功情况下的影响。

 关于打印

详见商米打印文档: https://docs.sunmi.com/htmls/index.html?lang=zh

常见问题

常见业务问题解答: https://docs.sunmi.com/others/sunmi-pay-manage-faq/

接口对接常见问题解答https://docs.sunmi.com/developers/%E6%94%AF%E4%BB%98%E6%8E%A5%E5%8F%A3%E5%AF%B9%E6%8E%A5%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94/

刷脸和扫码二合一支付UI的说明

刷脸和扫码二合一支付UI的说明

在商米双屏台式设备上,同时开启扫码或刷脸,过程中可切换支付方式,满足用户在不同场景下的支付需求(D2-d、X2、S2、T2、T2lite),此产品功能设计属于全球首创,旨在提高设备刷脸能力的利用率。

a收银员收款时可灵活使用、切换收款方式,

可主动发起扫码或刷脸支付方式, 可中断刷脸,可重新发起刷脸 

b消费者在副屏可自主选择支付方式:扫码或刷脸

c刷脸时主屏会播放副屏的刷脸动态、进度,

在出现状况时收银员可以做出指导或改用扫码方式收款

刷脸支付说明

关于扫脸支付的说明

商户授权流程

在真实的生成环境中,发起扫脸支付前,商家需要使用支付宝客户端(登录进件时提交的收款账户)扫码授权商米收银台,表示商家同意使用收银台做收单业务。

在开发测试阶段,商米会提供测试的商家支付宝账号并远程完成设备授权,开发者只需要提供设备的SN给到商米的技术支持人员即可开通。

用户扫脸支付流程

扫脸支付时输入几位手机号由支付宝云端算法控制终端程序无法控制,扫脸收到的款项汇会实时结算到商家的支付宝账户。

主屏同步显示副屏刷脸界面(限台式双屏设备)

双屏设备在使用扫脸支付时,主屏幕上会实时显示副屏的刷脸界面(效果见下图),方便操作员了解用户当前的刷脸支付状态并做出相应引导。

该功能在收银台版本≥1.4存在,且需rom支持才能生效,在不支持该功能的rom上表现为显示缺省页面(效果见下图)。

该功能对Saas软件开放,调用方在调用消费接口时,即可使用。

注意:使用此功能时,SaaS软件程序在副屏需要有默认的UI界面(广告页或其他),否则主屏内容会投射到副屏影响显示效果,进而影响消费者使用体验。

扫脸支付主屏

不支持录屏功能的扫脸支付主屏

扫脸支付副屏

附录C

(金融设备调用额外返回码定义)

Result Code Result Msg
401 交易失败
402 无效的应用类型
403查询不到此笔交易
404超过最大交易金额
405无效的原交易参考号
406无效的原交易凭证号
407无效的交易类型
408查询不到末笔交易
409无效的金额
410刷卡失败,请重试(POS外设获取不到卡信息)
411交易本地处理失败
412签到失败
413交易超时
414应用初始化失败,请重试
416无效的交易日期
417无效的MIS订单号
418交易取消
420流水未结算,请先完成结算
421签退失败
422TMK下载失败
423终端参数下载错误
424参数校验错误
425交易笔数达到上限
426交易关闭

附录B

(调用返回码定义)

Result CodeResult Msg建议显示内容
T00交易成功交易成功
T01无效交易(T01)无效交易,请重试
T02余额不足(T02)余额不足,请更换支付方式
T03交易金额超限(T03)交易金额超限,确认后重试
T04商户余额不足(T04)商户余额不足,请检查后重试
T05密码错误(T05)密码错误,请重试
T06重复交易(T06)重复交易,请重新发起交易
T07交易失败(T07)交易失败,请稍后重试
T08无效交易(T08)暂不支持当日退款,请隔日再试
T09有作弊嫌疑(T09)状态异常,请稍后重试或更换支付方式
T10MAC校验失败(T10)MAC校验失败,请稍后重试
T11舞弊嫌疑(T11)有舞弊嫌疑,请更换支付方式重试
T12支付失败,简易客户使用其他支付方式(T12)支付失败,请稍后重试或更换支付方式
T13针对盛付通不支持当日部分退款情况(T13)当日交易不支持部分退款,请隔日再试
E01无效商户(E01)无效商户,请向您的供货商确认商户状态
E02无效金额(E02)无效金额,请确认后重试
E04终端号无效(E04)无效终端,请向您的供货商确认终端状态
E05验签失败(E05)验签失败
E06SN号无效(E06)无效SN,请向您的供货商检查SN状态
E07初始化失败未开户!1. 您可尝试在设置内更新终端参数 2. 联系您的供货商确认是否开通支付服务,或咨询客服4009021168
E08SN号不存在(E08)SN不存在,请向您的供货商确认后重试
E09无效门店(E09)无效门店,请向您的供货商确认门店状态
E10SN号不能为空(E10)SN号不能为空
E11商户号不能为空(E11)商户号不能为空
E12交易日期不能为空(E12)交易日期不能为空
E13交易日期无效(E13)交易日期无效
E14终端未登记(E14)终端未登记,请向您的供货商确认后重试
E15参数校验错误(框架返回码 -1)(E15)参数校验错误
E16付款码已过期(E16)付款码已过期,请刷新后重试
E17付款码无效(E17)付款码无效,请确认后重试
E18无效的应用类型(E18)无效的应用类型
E19查询不到此笔交易(E19)找不到原交易,请确认后重试
E20无效的交易类型(E20)无效的交易类型
E21无效的MIS订单号(E21)无效的MIS订单号
E22退款金额有误(E22)退款金额超限,请确认后重试
E23查询不到设备支付宝授权信息(E23)查询不到设备支付宝授权信息
E24查询不到支付宝授权信息(E24)查询不到支付宝授权信息
E25查询设备进件信息失败或未进件(E25)查询设备进件信息失败或未进件
E26查询商户信息失败或商户信息不存在(E26)查询商户信息失败或商户信息不存在
E27查询退款订单信息参数缺少(E27)查询退款订单信息参数缺少
E28不是退款订单(E28)退款订单无效,请重试
E29查询订单列表信息失败(E29)查询订单列表信息失败
E30应用APPID填写错误(E30)联系支付宝,确认APP_ID的状态
E31商户收款额度超限(E31)收款额度超限,可联系支付宝95188提额
E32商户收款金额超过月限额(E32)月收款额超限,联系支付宝95188提额
E33商家账号被冻结(E33)商户账号被冻结,请咨询支付宝95188
E34二级商户信息创建失败(E34)商户信息有误,请检查商户信息是否有效
E35二级商户类型非法(E35)商户类型不合规,请检查商户信息是否有效
E36商户协议状态非正常状态(E36)商户与支付宝的合同非正常状态
E37请求退款的交易被冻结(E37)退款交易被冻结,联系支付宝确认
E38交易已完结(E38)交易已完结无法退款,请确认退款交易信息是否正确
E39当前交易不允许退款(E39)退款失败,请检查交易是否成功或商户是否支持退款
D01系统错误(如果当前为支付交易POS无需显示,此返回码仅为状态,可调用查询订单API,查询当前订单的状态)
D02记录订单号失败如果当前为退款或查询交易,pos显示:系统错误,请重试
D03原交易已撤销(D03)原交易已撤销,请确认后重试
D04订单已关闭(D04)订单已关闭,请重新发起交易
D05订单已支付(D05)订单已支付
D06订单已撤销(D06)订单已撤销
D07用户支付中(D07)用户支付中,需要输入密码
D08订单未支付(D08)订单未支付
D09订单支付失败(D09)订单支付失败
D10订单异常(D10)订单异常
D11订单号重复(D11)订单号重复
D12记录订单号失败(D12)记录订单号失败
D13更新订单号信息失败(D13)更新订单号信息失败
D14查询不到订单信息(D14)查询不到订单信息
D15记录退款信息失败(D15)记录退款信息失败
D16更新退款信息失败(D16)更新退款信息失败
D17查询总额失败(包含收款,退款,交易统计等)(D17)总额查询失败,请稍后重试
D18订单信息有误(D18)订单信息有误,请修改后重试
S01系统错误(S01)系统错误
S02未知错误(S02)未知错误
S03系统异常(S03)系统异常
S04未开通支付通道未开户!1. 您可尝试在设置内更新终端参数 2. 联系您的供货商确认是否开通支付服务,或咨询客服4009021168
C01参数下载失败(C01)参数下载失败
F01交易超时(F01)交易超时,请重试
F02系统异常(F02)系统异常
F03请求支付宝支付接口失败(F03)请求支付宝支付接口失败
F04请求支付宝退款接口失败(F04)请求支付宝退款接口失败
F05请求支付宝订单详情接口失败(F05)请求支付宝订单详情接口失败
F06请求支付宝退款详情接口失败(F06)请求支付宝退款详情接口失败
F07请求盛付通支付接口失败(F07)请求盛付通支付接口失败
F08交易异常,联系收单行或发卡行(F08)交易异常,联系收单行或发卡行
B00调用成功成功
Q01网络异常网络异常
Q02网络超时网络超时
Q03参数异常参数异常
Q04服务器异常服务器异常
Q05网络异常网络异常
Q06请求取消请求取消
Q07网络或服务器异常网络或服务器异常,请重试
Q08交易取消交易取消
Q09请求正在处理中请求正在处理中
Q10功能暂不支持功能暂不支持
Q11交易超时交易超时
Q12支付宝人脸未授权未授权,请打开商米收银台完成人脸授权后重试
Q13人脸支付手机号无效无效的手机号,请重新输入
Q14收银台程序被关闭,交易状态未知收银台服务已终止,您可通过查询接口获取交易状态
Q15未安装人脸支付组件人脸支付服务未安装,请安装后重试
Q16打印机异常打印机异常,请检查
Q17调用权限不足调用权限不足
Q18取消交易成功 
Q19取消交易失败取消失败