商米开发者文档

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

商米电子发票为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）商米非金融收银台及接口文档（支持T系列、D系列、S系列、X系列、K系列、H系列、V系列、M系列、L系列的机型）

2）商米P系列设备收银台及接口文档（支持P1-4G、P2lite和P2机型）

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

重要提醒!!!

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/

关于扫脸支付的说明

商户授权流程

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

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

用户扫脸支付流程

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

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

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

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

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

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

扫脸支付主屏

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

扫脸支付副屏