支付接口对接常见问题解答

  • 收不到交易结果广播怎么办?
    • 原因:收不到交易结果广播主要原因是SaaS程序发送交易请求到收银台后程序奔溃或被人为关闭
    • 如何解决:
      • 应用再次启动,对于没有结果的订单,应该要有查询机制
      • 对接商米云端回调接口,交易结果最好以云端交易通知为最终结果
  • 个别返回码、异常处理方案是什么?
    • 返回码为D01、D07、F01、F02、Q02、Q04、Q07、Q11、S01、S02、S03的交易需要设计一个状态不明的订单状态,可以在交易结果页放置一个查询按钮,点击后发起查询
    • D05表示交易已经成功,当作成功处理就可以了,这个返回码不用当异常处理
    • Q09表示重复请求,业务方自定义处理方式,不处理或者设计一个防止连续点击的机制都可以
    • 其他错误码:根据不同的错误码提示收银员和消费者对应的文案即可(见Excel)
  • 目前没有支付撤销接口?
    • 退款接口即支付撤销也支持退货,调用方不需要区分直接调用即可。
  • 用户发起10元的支付,收银台返回【网络超时】,但实际用户支付成功,如果用户支付成功,商米是否主动发起退款?建议业务方如何处理?
    • 商米不会主动发起退款,业务方可以调用云端的关单接口(正在开发中)关闭订单退回款项,也可以调用查询接口查明订单状态后做对应处理。
  • 支付时,通过广播拿到的支付结果到底有多精准?若是有广播拿到的结果是失败或者超时,但是客户那边已经扣款了,怎么处理此种情况?
  • 正常情况结果广播的到达率和准确率都是100%,除非在接到结果之前设备断电了,业务方可以调用云端的关单接口(正在开发中)关闭订单退回款项,也可以调用查询接口查明订单状态后做对应处理。
  • 目前的支付超时是120秒,正常来讲,哪怕用户没事,等120秒也会有些焦躁,那么怎么可以取消当前进行的支付,重新发起支付呢?
    • 商米会提供关单接口(正在开发中)
  • 接口返回错误码Q09请求正在处理中,这种情况,再发起支付是不是无法发起交易了?
    • 需要等到前一笔交易返回,收银台只允许同时进行一笔交易
  • Q09请求正在处理中,这种情况为什么没有流水号
    • 这个只是告知调用方有正在进行的交易,这次请求不算一笔交易
  • 交易失败为什么有的有交易号,有的没有交易号呢?
    • 如果是终端判断失败,请求没有发送到云端,就不会有交易号。
  • 交易金额/实付金额/优惠金额 具体业务定义
    • 交易金额指的是商户当笔交易的收款金额,在调用支付接口时传入
    • 实付金额是指支付通道方在活动期间补贴消费者一定优惠金额后,消费者的实际付款金额,在交易完成由后返回
    • 优惠金额即支付通道在活动期间的补贴金额,在交易完成由后返回

注册合作伙伴

注册流程说明

1.打开合作伙伴平台网址:https://partner.sunmi.com,点击“立即注册”。建议通过谷歌浏览器使用合作伙伴平台的功能。

1

2.在注册页面的输入框中依次输入相应的内容,点击“立即注册”。

2

3.系统提示已发送激活邮件到您注册时所填写的邮箱,请点击“立即查收邮件”从邮箱中激活账号。

3

4.激活邮件如下图所示,请点击“激活账号”激活您的帐号。(还没收到确认邮件? 尝试到广告邮件、垃圾邮件目录里找找看)

4

5.激活后登录合作伙伴页面,并完善相关信息(所有栏位必须正确、完整填写),公司身份请提交营业执照,点击“保存”。等待商米审核(审核时间为一个工作日),审核完成后会给您发一封通知邮件。

5

6.商米会在审核的时候为用户分配相应的角色。收到审核通知邮件后您就成为正式的合作伙伴了。您可以使用该账号登录合作伙伴平台。

6

主要概念

商米科技

上海商米科技有限公司是一家专注为O2O互联网平台,软件开发商、中小型商户提供专业的、高性价比的智能商用硬件设备的创新型科技企业。

商米硬件设备

目前商米主推的智能商用硬件包括 V1 , T1 , M1 ,D1 。设备应用于包括外卖接单,打印小票,扫描,收款,团购核销,点餐预约等一系列商业场景。

SUNMI OS

商米设备运行的是SUNMIUI系统,SUNMIUI是基于Android深度优化改良的操作系统,支持安装普通基于Android系统的app,专为智能商用场景深度定制,从操作体验、性能提升与产品外观设计内外呼应,相得益彰。让用户在使用硬件的同时能享受更加专业系统的软件服务体验。

应用市场

SUNMIUI内部有一个应用市场,合作伙伴可以通过应用市场将自己的应用大规模分发到商米的设备上。部分合作伙伴可以有一个自己管理的应用市场,默认旗下设备用户只能通过应用市场为设备安装应用。

商米合作伙伴

在 注册合作伙伴 审核的时候商米会为注册者设置相应的角色,合作伙伴可以联系商米客服400-6666-509(每天9:00~21:00,节日除外)咨询相关权限的授予。目前商米有三种类型合作伙伴:

1.平台合作伙伴

可以开发适配商米设备的应用,管理自己独有的应用市场,可以控制应用市场只出现自己想要的应用,也可以上传应用,上传的应用不需要商米审核即可在自己应用市场出现,默认商米可以审核决定该应用是否在其他应用市场下载,平台合作伙伴也可以设置自己的应用不在其他应用市场出现。

2.普通开发者

可以开发适配商米设备的应用,上传应用到商米的应用库中,通过商米审核后普通用户可以下载。

3.普通渠道合作伙伴

可以为旗下的设备维护一个自己独有的应用市场,选择应用市场中只出现自己想要的应用,不能上传应用。

每个商米合作伙伴都可以在商米官网注册商米合作伙伴帐号,有一个自己的操作后台,原则上每一台商米的设备在卖出去的时候都会和一个合作伙伴账号绑定,商米会以合作伙伴为粒度提供部分功能和权限的控制服务。