银联手机POS
手机闪付
收单机构
商户
开发者
发卡机构
银联手机POS是中国银联严格依据人民银行的相关标准,并经过银联安全认证,同时通过BCTC等专业机构安全检测的一款新型金融科技产品,集合了二维码、手机闪付、银行卡等目前市面上主流的支付方式,更便于持卡人支付。
服务对象

银联手机POS服务于小微特约商户。

产品详情

【持卡人须知】         

一、参与试验商户名单

目前手机POS已在银联安全可控范围下开展试点活动,该表格为已授权试验商户名单(后续将持续拓展),请您查看并放心使用

商户名称      试点城市商家地址手机型号
一片天餐饮有限公司上海上海市浦东新区顾唐路1699号研发楼二楼餐厅3号窗口华为P30、小米9
上海凤阳路伟丰水果店上海上海市黄浦区凤阳路375号华为P30
上海真瑞眼镜店上海上海市普陀区兰溪路282号1室华为P30
上海福运来烟酒专卖店上海上海市宝山区市台路602号华为P30
上海浙东头餐饮店上海上海市静安区灵石路697号华为P30


【商户须知】

一、商户使用指南


1、商户首先需要注册手机POS APP 用户;

2、成功注册进入使用页面后,商户需要拿身份证件、商户信息、银行卡进行入户开通(在商户注册过程中遇到任何问题,请联系相应的收单机构),已入网商户只需进行身份验证即可直接开通;

3、开通入户后,商户可在页面添加店员信息,与店员的手机POS进行绑定,随时随地查看店铺交易信息;

4、收银员在每日收银前需要进行刷脸签到,签到成功后可以开始收银;

5、手机POS受理多种主流支付方式,包含银行卡、手机闪付、二维码。具体收款方式如下:

·针对使用银联卡支付的消费者(带芯片),进入银联卡收款界面,输入收款金额,贴一贴即可轻松收款。

·针对使用手机闪付支付的消费者,进入手机闪付收款界面,输入收款金额,碰一碰即可轻松收款。

·针对使用主流二维码支付的消费者,进入二维码收款界面,输入收款金额,扫一扫即可轻松收款。

6、手机POS支持交易统计功能,可随时随地查询交易记录,最多可查询30天内的交易明细。

7、使用过程中,请保持手机GPS定位以及NFC功能开启。

 

二、常见问题  


 (一)产品相关问题


1、商户如何申请银联手机POS产品?

  在试验期内暂不开通商户自行注册,若有商户希望使用手机POS产品,请联系各自相应的收单机构。后期在推广过程中,当商户需要开通手机POS业务时,只需在手机渠道商或者电商网站上购买支持手机POS的手机即可,一般而言,支持银联手机闪付的手机就支持手机POS,不过部分存量手机可能需要额外升级系统,具体可根据手机厂商系统上线情况决定。在手机POS的开通使用方面,商户只需通过自持手机下载指定手机POS收单APP或使用手机自带钱包APP,并在线完成小微商户注册开通和机构审核后(一般入网时效为T+1),即可开始使用手机POS功能并通过手机POS对外开展收单服务。在这一使用过程中,手机POS使用体验与现有移动支付APP的体验基本保持一致。如审核没有及时通过,商户有疑问可联系所属收单机构。


2、目前手机POS支持手机型号有哪些?

手机POS目前支持的手机型号有:

华为:P30系列、P20系列和Mate20系列;

小米:Mi9、Mix2s;

OPPO: Reno系列;

后续将会有更多机型上线,敬请期待。


3、商户交易的限额是否可以提高?是否能与刷卡机具额度相同?

    商户交易限额将根据《中国银联小微商户业务管理办法》额度限制进行实施,根据不同商户资质给予不同级别的交易限额,优质商户获得的交易限额越高。例如,能够提供正式营业执照的普通商户将不受额度限制。具体可咨询相应的收单机构。

 

(2)使用相关问题


1、手机丢失怎么办?

  手机丢失后请及时联系各自所属的收单机构。另外,手机POS需要通过人脸识别完成日签到,如果匹配不成功是无法使用的,您还可以在另一台手机上重新开通手机POS,且一旦您重新登录到新手机时,旧手机上的用户就会被迫下线。


2、对于一个收单App,一个用户使用一个商户号注册账号后可以在多台手机上同时使用吗? 

   可以,但同一时间用户只能在一台手机上使用该账号,当用户登录到另一台手机时,旧手机上使用该账号的用户就会被迫下线。


3、对于一个收单App,一个商户号可以给多个用户在多台手机使用吗?

   可以,手机POS支持店主店员场景,开通商户的那台手机作为店主,使用该商户号的其他手机作为店员


4、一个收单App可以开通多个商户吗?

   可以,不过一个身份证在一个收单机构下只能开通一个商户,且一个身份证在不同收单机构下最多可开通5个商户

 

5、手机POS APP到账声音小,或不能打印小票怎么办

    在使用手机POS时可以自由连接蓝牙设备。如有此类需求,请联系相应的收单机构或自行购买蓝牙小音箱、蓝牙打印机进行解决。


6、如老板不在店内,用户每日签到验证怎么办?

  手机POS支持店主店员关系区分功能,请联系各自所属收单机构或者按照商户操作流程完成店员注册绑定,绑定完成后就能由收银员完成每日刷脸签到验证操作,验证时只需按照APP指示进行刷脸即可。

 

(3)交易相关问题


1、手机POS收款的金额何时能够到账?

    原有的收单机构到账时间将保持不变。若商户直接与银联对接,银联保证收款金额将会再下一天到达您的银行卡账户。


2、手机POS的费率是多少?

    手机POS将遵循现有的商户标准费率,各商户具体的费率标准请联系各自所属的收单机构。


3、如果在交易过程中出现交易不畅问题,请查看下列对应解决情况。

(1)由于网络信号的原因导致银行卡信息未读全,请再重新读取一下之前的银行卡、手机闪付或者二维码等信息;

(2)由于卡片移走太快,导致信息未能完全读取,请再次刷卡;

(3)银行卡未开通双免导致交易失败,请用户联系发卡行进行双免功能开通;

(4)如果在使用过程中,出现程序闪退的问题,请用户重启APP再行尝试,如果出现手机卡死问题,请重启手机再行尝试;

(5)如在交易过程中,出现程序闪退和手机卡死等问题而导致金额误扣问题,请在APP内相应菜单下进行交易撤销操作以退回金额;

(6)若出现其他任何问题,请及时反馈给相应的收单机构。


4、手机POS交易撤销功能在哪里?

    一般情况下,手机POS交易撤销功能都在APP内显眼地方,如果没有,请在具体账单界面对想要撤销交易尝试进行操作以确认是否能够撤销。如果仍未找到,请联系所属收单机构进行咨询。

 

如有任何疑问,请及时拨打相应收单机构客服电话或银联官方客服专线95516,我们将竭诚为您提供服务。




应用场景

4.jpg

产品亮点

安全可信

依托多种软硬件安全技术进行保障,使刷卡和二维码收单程序均运行在手机内的TEE可信执行环境和eSE安全芯片上,通过在TEE和eSE上直接实现POS功能,可杜绝收单过程中支付数据和敏感信息被手机操作系统(如Android、iOS等)恶意程序窃取、篡改、破坏等恶意行为的可能,保证了手机POS的安全可信。

 

低成本高便捷

帮助商户低成本便捷地完成收单,依托手机的移动属性使商户可以根据业务需要灵活地开展收单服务。

 

收单方式丰富

支持NFC支付、银行卡支付、二维码支付、“碰一碰”支付、大额线上支付等功能,赋能手机银行、手机钱包,实现多功能收付一体化。


具体开发接入请查看“银联手机POS”常见问题
应答码参照
应答码 描述 解决方案

1. 系统架构

        1)  拓扑图

        手机POS系统可划分为三个子系统,依次为商户系统,手机POS控件系统以及银联后台系统。其中,商户系统由商户的客户端和服务端组成,手机POS系统由手机POS控件和手机POS前置组成,银联后台系统由小微商户系统,二代商户系统,全渠道系统,风控平台等组成。这里的手机POS前置与各个银联后台系统直接联接,这种方式称为银联手机POS的直联模式,本产品所讨论的内容基于这种直联模式。

 

        2) 数据流图

        从数据流的纬度分析,需要开发者注意的是,商户App每调用一个API都是一个耗时操作,业务数据由商户App->POS控件->TA->POS控件->POS前置->银联后台系统->POS前置->POS控件->TA->POS控件->商户App。其中的TATEE可信环境下运行的程序,支持数据处理和页面显示等,提高了安全性,这种安全保障是REE环境下所不具备的。

 

        3) 包图        

1.png

        将架构图简化为上图,蓝色部分属于商户的系统,红色部分属于银联的系统。商户系统集成手机POS控件的方式有API集成(Jar包集成)H5集成两种方式,采用API集成的方式可以让商户App与手机POS深度融合,商户App开发者自行开发界面元素,调用API实现手机POS的底层功能。采用H5集成的方式可以让开发者以最低的开发成本集成手机POS,此时手机POS控件提供所有界面,商户App仅仅通过跳转H5页面就能获得手机POS的全部功能,但是就如上图蓝色箭头所示,商户系统跳转到H5页面以后无法获取返回结果,只能通过后台推送的方式得到业务数据。



2. SDK介绍

 

2.png

        上图虚线部分为手机POSSDK,开发者可以选择API集成或者H5集成手机POS控件。开发者可以在文档下载板块下载Jar包和控件等

 

3. 集成方式

 

        1) API集成

     3.png

        采用API集成的方式,此时的手机POS控件提供的是系统底层服务能力(不提供页面),为商户App赋能。手机POS控件作为一个隐藏的Android App不会出现在桌面,而是长期运行在系统后台。

    

4.png

        商户App集成一个手机POSJar包,Jar包负责与手机POS控件建立绑定关系,并实现进程间通信。

        具体的接入流程请参考“API接入流程板块。

 

        2) H5集成

        方式一:浏览器跳转网页

        商户App通过浏览器跳转网页的方式跳转到手机POS指定URL,这个手机POS的引导页再通过Scheme协议调起手机POS控件App,此时的手机POS控件提供了上层业务逻辑和底层服务能力。(就是一个收单App)

5.png

 

        方式二:JS SDK 集成

        商户系统也可以通过Javascript集成的方式集成手机POS控件,商户的Web App需要调用手机POS提供的js类并集成Jar包来获得收单的能力。 

        6.png

具体的接入流程请参考“H5接入流程板块。

 

4. 功能介绍

            

7.png

          手机POS的功能由三个方面构成:设备管理,交易管理以及商户管理。上图红色部分是需要开发者重点关注的接口。


术语约定

直联商户 - 从银联全渠道角度而言,商户的信息流直联银联。

间联商户 - 从银联全渠道角度而言,商户的信息流间联银联。

银联二维码专业化前置平台- 俗称银联小微商户平台,用于小微商户的开通和管理的平台系统。

银联条码支付前置平台 - 俗称UAT后台,用于条码支付的开通和管理的平台系统。

银联商户信息管理注册公共服务系统  -  俗称银联二代商户平台,用于普通商户的开通和管理的平台系统。

银联全渠道交易平台 - 用于有卡交易和二维码交易的平台。

手机POS的管理平台 - 银联手机POS的后台,用于入网信息的管理和配置和。收单机构可登录平台自行配置。

手机POS的新商户开通 - 是指手机POS的商户注册或商户进件或商户入网的全过程。开通流程包括收单机构在银联小微商户平台的配置和调用手机POS“新商户开通”接口(前端控件接口或后台接口)。通过手机POS“新商户开通”接口开通的新商户需要在银联小微商户平台完成配置。

手机POS的存量商户开通 - 是指已有商户号的商户   在除银联小微商户以外的其他平台开通过的商户,如果希望使用手机POS业务,还需要调用一下手机POS的“存量商户开通”接口。


入网流程中涉及到的平台

1.  小微商户平台    目的:机构录入手机POS商户所属拓展机构相关信息

2.  二代商户平台    目的:机构修改手机POS商户信息

3.  手机POS管理平台    目的:机构完成手机POS后台的配置

4.  银联统一运营服务平台。  目的:机构开通全渠道有卡相关业务

5.  条码支付前置平台    目的:机构开通条码相关业务


入网流程清单

(一)确定试点分支行和试点商户

(二)确定商户接入方式(银联直联商户还是银联间联商户)

(三)确定清算方式(银联直联清算还是银联间联清算)

(四)确定商户开通的方式(新商户开通还是存量商户开通)

对于新小微商户开通,收单机构接入银联小微平台做密钥配置工作,之后将密钥信息提交给银联手机POS运营人员,或者由收单机构在手机POS管理平台自行完成配置。如果选择了直联商户,收单机构要接入银联二代商户平台做预录入配置工作。

对于存量商户开通,将机构的密钥信息提交给银联手机POS运营人员,或者由收单机构在手机POS管理平台自行完成配置。

(五)确定银行APP集成银联手机POS的方式 (H5方式还是API方式)

收单机构将APP的入网信息提交银联手机POS运营人员,或者由收单机构在手机POS管理平台自行完成配置。

对于新商户开通,使用“新商户开通”接口,可以选择控件API或后台API两种调用方式。

对于存量商户开通,使用“存量商户开通”接口,可以选择控件API或后台API两种调用方式,也可以通过在手机POS管理平台批量导入信息完成配置。

(六)确定入网方式(商户入网还是机构入网)

收单机构向银联手机POS运营人员提交商户入网或机构入网申请,银联业务运营中心审核通过后颁发两码,收单机构在中国金融认证中心(CFCA)通过两码下载证书,将证书配置到银联全渠道平台,并将密钥信息提交给银联手机POS运营人员,或者由收单机构在手机POS管理平台自行完成配置。

(七)确定是否支持条码支付

收单机构向银联条码支付前置平台运营人员提交机构入网申请,获取银联为机构分配的相关配置信息,提交银联手机POS运营人员,或者由收单机构在手机POS管理平台自行完成配置。

(八)银行APP实现可信身份认证(商户开通和收银员实名注册)、小微商户开通、刷脸日签到、UATZ和NFC交易,以及其它功能(如交易查询、退货等)

(九)银行如果参加银联的手机补贴和营销,则需要跟银联签署协议

(十)银行总分行自行协调


        本文主要介绍了收单机构在开通商户和开通交易所涉及的所有业务流程的整体描述。如果您对整个入网流程还没思路可先参考上一节"机构入网流程清单"

        业务流程如下图所示,大致可分为三个步骤,依次为收单机构在小微商户平台的信息配置,在手机POS平台的商户开通,在全渠道交易平台的机构入网。收单机构在入网的过程中所需要提交的入网信息,可参考下一节"机构入网信息提交"

屏幕快照 2019-03-13 下午8.04.39.png


0. 术语约定

        

直联商户 - 从银联角度而言,商户的信息流直联银联。

间联商户 - 从银联角度而言,商户的信息流间联银联。

银联二维码专业化前置平台- 俗称银联小微商户平台,用于小微商户的开通和管理的平台系统。

银联条码支付前置平台 - 俗称UAT后台,用于条码支付的开通和管理的平台系统。

银联商户信息管理注册公共服务系统  -  俗称银联二代商户平台,用于普通商户的开通和管理的平台系统。

银联全渠道交易平台 - 用于有卡交易和二维码交易的平台。

手机POS的管理平台 - 银联手机POS的后台,用于入网信息的管理和配置。收单机构可登录平台自行配置。平台地址: https://mobilepos.95516.com/mposmgm/

手机POS的新商户开通 - 是指手机POS的商户注册/商户进件/商户入网的全过程。开通流程包括收单机构在银联小微商户平台的配置和调用手机POS“新商户开通”接口(前端控件接口或后台接口)。通过手机POS“新商户开通”接口开通的新商户需要在银联小微商户平台完成配置。

手机POS的存量商户开通 - 是指已有商户号的商户如果希望使用手机POS业务,还需要调用一下手机POS的“存量商户开通”接口。



1. 收单机构在银联小微商户平台的信息配置

        如果收单机构希望通过银联手机POS开通新商户或存量商户而不是由其他渠道开通,则需要登录银联小微商户平台进行信息配置。收单机构需要在银联小微商户平台上提交公私钥信息,获取AES对称密钥,并将这些信息以邮件的形式发送给手机POS业务人员可参考下一节"提交入网信息",或登录手机POS管理平台配置密钥信息从而完成商户入网如果收单机构通过其他渠道开通新商户或存量商户,则无须登录银联小微商户平台,但需要提供收单机构的公钥并将这些信息以邮件的形式发送给手机POS业务人员或登录手机POS管理平台配置密钥信息

关于银联小微商户入网的流程,请参考“文件下载”版块中的中国银联小微商户管理指引-收单机构版(2018年2月版).docx”,以及机构密钥投产配置手册--小微(后台接口).docx


    

捕获.png


2. 收单机构在手机POS平台的商户开通

        收单机构完成在小微商户平台的信息配置以后,可以通过三种方式开通商户,分别为手机POS的控件API,手机POS的后台API,以及其他渠道开通(比如云闪付商户通,银联二代商户平台等)。根据开通商户的不同(是新商户还是存量商户),流程也随之不同。


注:(1)如果收单机构通过非小微商户平台的其他渠道已开通了商户或新开通了商户,则还需要调用手机POS的API开通存量商户,使商户信息在手机POS系统中完成配置。

        (2)通过H5方式接入的App只能使用后台接口开通商户。


sss00.png


        子流程1 - 通过控件API开通存量商户 (不支持H5方式接入)

s1.png

    

        子流程2 - 通过后台API开通存量商户

s2.png


3. 收单机构在银联全渠道交易平台的机构入网

        机构需要在银联全渠道交易系统进行入网。如果是全渠道间联商户收单机构先与手机POS业务人员沟通确定商户是否适用,由手机POS业务人员向银联业务运营中心提单,获取两码等信息,接着收单机构在CFCA网站上申请机构证书,将机构证书提交到银联全渠道交易平台,并将这些信息以邮件的形式发送给手机POS业务人员或登录手机POS管理平台配置密钥信息如果是全渠道直联商户,无须进行任何操作


捕获.png


关于银联二代商户入网的流程,请参考“文件下载版块中的“银联在线支付商户信息注册指引(全渠道商户).docx

关于全渠道入网的流程,请参考“文件下载”版块中的CFCA证书下载、导出及上传流程-机构.docx




本文主要介绍了收单机构需要提供的入网信息,具体的入网流程请参考上一节"机构入网流程详情"

请在“文档下载”版块下载并填写APP入网信息(模版).xlsx机构入网信息(模版).xlsx,将信息表发送邮件至qianjin@unionpay.com, chenchengqian@unionpay.com


1.   APP入网

1.1  目的

手机POS在运行时,需要对收单APP进行合法性操作,确保只有与银联合作的收单机构APP具备权限调用手机POS控件,因而,对每一个接入手机POS控件的APP,收单机构需预先在手机POS前置上录入APP相关各项信息。


1.2  要求

收单机构需提供以下APP信息给手机POS前置平台(当前只定义Android版):


序号

信息名

说明

1

APP名称

标识APP的名称,不超过32字符

2

APP运营方名称

标识APP所属运营机构名称,不超过32字符

3

APP包名

Android应用包名,不超过64字符

4

App证书指纹

APP签名哈希结果,取SHA256,去掉冒号

5

收单机构代码

APP需指定一个默认所属的收单机构代码

6

收单机构名称

收单机构的全称,不超过64字符

7

交易结果通知url

对于需要以后台方式接收手机POS每笔交易结果的,需配置此项


2.   机构入网


2.1  目的

判断收单机构的合法性。

手机POS在商户开通和交易时,需要使用收单机构相关密钥信息,并判断该商户所属的收单机构是否已在手机POS中录入。收单机构需在手机POS前置中配置之后,方可使用手机POS。 

2.2  要求

收单机构需预先通过银联业务运营中心申请开通银联全渠道功能,针对使用手机POS小额双免支付的情况,需依据业务运营中心要求,授权业务运营中心打开具体的相关权限标志。

收单机构需提供以下信息给手机POS前置平台:

序号

信息名

说明

1

收单机构名称

标识收单机构的名称,不超过32字符

2

收单机构代码

收单机构在银联系统中的机构代码

3

收单机构全渠道机构私钥

对于支持存量间联商户使用手机POS交易功能的情况,收单机构需提供银联全渠道平台上的机构私钥,也可提供相关文件

4

收单机构小微商户平台私钥

对于通过手机POS控件开通新商户的情况,收单机构需提供在银联二维码专业化前置上配置的机构私钥,也可提供相关文件

5

收单机构小微商户平台公钥

对于通过手机POS控件开通新商户和开通存量商户的情况,收单机构需提供在银联二维码专业化前置上配置的机构公钥,也可提供相关文件

6

收单机构小微商户平台AES密钥

对于通过手机POS控件开通新商户和开通存量商户的情况,收单机构需提供在银联二维码专业化前置上获取的AES密钥

注:

        对于收单机构的全渠道机构私钥,建议收单机构为银联申请专属版的全渠道私钥,与收单机构原有已使用的全渠道私钥予以分开。关于全渠道机构私钥转及其对应的公钥上传等相关操作,请参看银联全渠道系统的相关文档,如《证书下载、导出及上传流程——机构》等,具体可咨询银联业务运营中心。

        对于小微商户平台的机构私钥转及其对应的公钥上传等相关操作,请参看银联二维码专业化前置平台的相关文档,具体可咨询银联业务运营中心。其中,对于选择银联代理清算模式的,需在银联二代商户系统进行商户的预录入操作。


3.   拓展机构入网

3.1  目的

判断拓展机构的合法性。

对于收单机构需要授权给第三方机构开通手机POS商户权限的情况,收单机构需要授权第三方机构为所属拓展机构,并在手机POS前置中录入相关信息,手机POS方可支持该拓展机构的商户开通功能。

对于拓展机构模式,手机POS只支持新商户开通,不支持存量商户开通。

3.2  要求

收单机构需通过银联业务运营中心申请创建所属拓展机构代码,并根据二维码专业化前置平台相关文档,在该平台上进行拓展机构的录入操作。

收单机构需提供以下信息给手机POS前置平台:

序号

信息名

说明

1

拓展机构名称

标识收单机构的名称,不超过32字符

2

拓展机构代码

从银联系统中申请的拓展机构代码

3

小微商户平台拓展机构私钥

拓展机构需在银联二维码专业化前置上配置的机构私钥

4

小微商户平台拓展机构AES密钥

拓展机构需提供在银联二维码专业化前置上获取的AES密钥

 


1. 控件的下载和绑定

        

        手机POS控件需要预先下载,建议商户App对控件进行自动下载和静默安装,商户App启动时判断手机里是否存在包名为 com.unionpay.mobileposservice的控件,如不存在,则发起一次包含手机型号信息的HTTP GET网络请求,手机POS后台根据手机型号返回相对应的控件APK的下载地址URL,商户App获取下载链接后自动下载并安装手机POS控件。 

4.png

        成功下载安装了手机POS控件以后,已导入手机POS Jar包的商户App可以通过代码获得一个控件实例对象,用该实例绑定控件。


        示例

        // 1. 获取对象实例

        UPPosAddon mUPAddon = UPPosAddon.getInstance(this);

        // 2. 绑定控件

        mUPAddon.bind(new UPPosConnectionListener() {

            @Override

            public void onConnected() {

                Log.i(TAG, "控件Service connected.");

        //   3. 绑定控件成功后,初始化控件

        mUPPosAddon.init(new UPPosAddon.IUPCallback() {

                    @Override

                    public void onProgress(String progress) {}

                    @Override

                    public void onSuccess(Bundle result) {}

                    @Override

                    public void onError(String errorCode, String result) {}

        });

            }

            @Override

            public void onDisconnected() {

                Log.i(TAG, "控件Service disconnected.");

            }

        };

        );

        // 4. 调用控件API

        int ret = mUPAddon.xxxMethod(bundle, callback);

        // 5. 无需控件时,解绑服务

        mUPAddon.unbind();

        


2. 手机的激活和验证


        App每次绑定控件后必须调用接口:初始化控件(API 3.1.1)。

        控件负责在第一次使用POS时激活手机,以及每次使用POS时验证手机。    

image.png

App每次绑定控件后必须初始化控件(API 3.1.1)。

App若从未调用初始化接口,第一次调用时,POS控件会激活设备。

App每次调用初始化接口,POS控件会验证设备,并检查Jar包和控件的版本。


        示例

        // 控件初始化

        int ret = mUPPosAddon.init(new UPPosAddon.IUPCallback() {

                   @Override

                    public void onProgress(String progress) {

                        // 在这里处理初始化的中间过程

                    }

                    @Override

                    public void onSuccess(Bundle result) {

                        // 在这里处理初始化成功后的返回结果

                    }

                    @Override

                    public void onError(String errorCode) {

                        // 在这里处理初始化失败后的返回结果

                    }

        });



3. 查询当前用户信息


        App调用接口:查询账号(API 3.1.6)可获得当前用户信息,包括该用户是否已经开通了商户,是否经绑定主设备等。

        开发者需要提供商户App的用户名userId给手机POS控件,作为手机POS对商户App用户的唯一标识,即将userId作为入参传入。    

image.png

App绑定控件后开始交易前可以先查询当前帐号下的账号状态(API 3.1.6)。

如用户已开通商户已绑定当前设备,可以开始交易(API 3.2.1)。

如用户从未注册,先开通商户(API 3.3.1)。

如用户为店主已开通商户未绑定当前设备,先绑定主设备(API 3.1.2)。


如用户为店员且已绑定子设备,等同已注册,可以开始交易。

如用户为店员但未绑定子设备,先绑定子设备(API 3.1.4)。

        

        示例

        // 查询当前帐号下的注册状态,商户信息,店主店员信息和设备信息。

        String userId = “mike”; 

        Bundle info = mUPPosAddon.getInfo(userId);

        if (info != null) {

        String statusCode = info.getString("statusCode");

        String respCode = info.getString("respCode");

        String respMsg = info.getString("respMsg");

        String reserve = info.getString("reserve");

        // 获取注册状态

        String regStatus = info.getString("regStatus");

        if (“0”.equals(regStatus)) {

              // 已注册,可以开始交易

        } else if (“1”.equals(regStatus)) {

             // 已开通商户未绑定设备,先去绑定设备

        } else if (“2”.equals(regStatus)) {

             // 未开通商户,先去开通商户

        } else if (“3”.equals(regStatus)) {

            // 商户正在审核中,不能交易

        } } else if (“4”.equals(regStatus)) {

            // 店员账户,可以开始交易

        } else {

            // 异常情况

        }

        }



4. 商户开通/入网/进件


        商户开通分两种情况:新商户开通和存量商户开通。存量商户一般指已入网的直联商户或间联商户,对于存量商户,无须再录入商户信息,只须调用存量商户开通的接口(API 3.3.2)就可以开通商户。对于新商户开通,首先需要收单机构先二维码专业化前置平台申请注册入网,成功以后获取拓展机构代码,然后在商户App里调用新商户开通的相关接口完成商户开通。       

图片1.png

        App需要先后调用三个接口,商户开通(API 3.3.1 ),上传图片(API 3.3.6 ),补充商户信息(API 3.3.5 )。

        新商户开通接口支持银联直联模式。  

image.png    

        示例

        // API 3.3.1商户开通为例

        Bundle bundle = new Bundle();

                bundle.putString("userId", "jin");                             // 用户名

                bundle.putString("expandcode", "48690000");     // 拓展机构代码

                bundle.putString("phoneNo", "15800123456");   // 手机号

                bundle.putString("mchntType", "0203");              // 商户类型

                bundle.putString("merName", "星巴克");            // 商户名称

                bundle.putString("certifTp", "01");                        // 证件类型

                bundle.putString("certifId", "310104199007032811");   // 证件号

                bundle.putString("customerNm", "小明");           // 店主姓名

                bundle.putString("accNo", "622512345678901218");  // 银行卡号

                bundle.putString("accType", "1");        // 账号类型

                bundle.putString("cityCd", "1900");     // 城市代码

         

                int result = mUPPosAddon.merchantRegister(bundle, new IUPCallback() {

                    @Override

                    public void onProgress(String progress) {

                    }

                    @Override

                    public void onSuccess(Bundle result) {

                          // 商户开通成功,获取商户编号

        String merId = result.get("merId")

                    }

                    @Override

                    public void onError(String errorCode, String progress) {

                    }

                });

    


5. 二维码收款和NFC收款


        商户App无须开发收单的界面,手机POS控件会提供三种场景下的收单界面,分别是NFC收款,二维码主扫和被扫收款。

    

捕获.png


6. 店主店员管理


        使用手机POS提供的店主店员管理方案建议的开通流程如下:


          1) 店主填写店员信息(App用户名,店员姓名,手机号)开始“添加店员”

           2) 店员手机收到短信验证码,将短信告知店主 

           3) 店主填写短信验证码,并通过验证,调用接口添加店员  (API 3.3.14)

           4) 店员在手机上进行“子设备绑定”  (API 3.1.4) 

image.png

    请在“文档下载”板块下载“中国银联手机POS产品控件接口指南”了解更多详情。





H5接入方案旨在让开发者以最低的开发成本集成手机POS功能。


1. 控件的下载和安装

        

        控件的下载由手机POS的引导页完成,无需客户App参与,App只要访问手机POS的H5引导页即可,H5引导页会判断当前手机是否存在控件,如果不存在则自动下载控件,下载完成后用户选择是否安装控件。

11.png


2. 接入流程

        

        商户App向手机POS服务器发起一次HTTP POST网络请求,得到成功的响应结果以后再跳转到指定网页,就完成了所有工作。

11.png

    请在“文档下载”板块下载“中国银联手机POS产品H5接口指南”了解更多详情。




目前已支持手机型号名单(后续将持续更新)

手机型号

支持时间

备注

小米Mix2S

2018.12

登录小米开发者论坛 http://rom.xiaomi.cn,找到Mix2S,下载最新开发版Rom完成刷机

小米Mi9

即将上线


华为P30

2019.4


华为P30 Pro

2019.4


华为P20

即将上线

目前支持华为内部刷机

华为P20

即将上线

目前支持华为内部刷机

华为Mate20

即将上线

目前支持华为内部刷机

华为Mate20 Pro

即将上线

目前支持华为内部刷机



1、商户首先需要注册手机POS APP 用户;

2、成功注册进入使用页面后,商户需要拿身份证件、商户信息、银 行卡进行入户开通,已入网商户只需进行身份验证即可直接开通;

3、开通入户后,商户可在页面添加店员信息,与店员的手机POS进行绑定,随时随地查看店铺交易信息;

4、收银员在每日收银前需要进行刷脸签到,签到成功后可以开始收银;

5、手机POS受理多种主流支付方式,包含银行卡、手机闪付、二维码。具体收款方式如下:

·针对使用银联卡支付的消费者(带芯片),进入银联卡收款界面,输入收款金额,贴一贴即可轻松收款。

·针对使用手机闪付支付的消费者,进入手机闪付收款界面,输入收款金额,碰一碰即可轻松收款。

·针对使用主流二维码支付的消费者,进入二维码收款界面,扫一扫即可轻松收款。

6、手机POS支持交易统计功能,可随时随地查询交易记录,最多可查询30天内的交易明细。






联系我们

业务咨询: 021-20637043

钱进

qianjin@unionpay.com

咨询与服务