开发者说明
使用手册

+ 全部展开


  • 平台作用

  • 魔方智能支付平台是什么

    魔方智能支付平台帮助合作伙伴基于联动惠商智能POS,通过联动商惠POS提供的 SDK

    实现快速接入目前主流的多种支付渠道


    支付宝

    微信支付

    银行卡收单

    Apple Pay

    结合联动惠商提供的交易管理平台,为合作伙伴提供方便

    1、统一管理所有的交易信息流
    2、有效降低前期开发和后期管理成本

    合作伙伴可以定制化智能POS

    桌面UIlogo 应用商店 内置应用 开机启动应用



  • 应用场景

  • 魔方智能支付平台应用场景

    如何通过联动惠商云收银专业版实现目前主流多种支付渠道的接入?


    认可联动惠商智能POS价值

    合作伙伴有自己的应用

    这些服务需要接入支付

    接入完成,这些服务即可在联动惠商应用市场发布,从而给中大型商户提供专业服务。



  • 接入流程

  • 魔方智能支付平台接入流程

    第1步,接入魔方智能支付平台

    通过自助注册或申请,成为联动惠商的合作伙伴。注册成功后,通过帐号密码,登录合作伙伴自服务平台-魔方智能支付平台(partner.huishangplus.com),申请应用接入的APP ID后,创建应用。

    第2步,申请开发版本的智能POS

    联系客户经理,申请开发版本的智能POS;仅支持基于开发版本的智能POS进行SDK的集成开发、调试。

    第3步,开发、线上测试

    通过Demo,了解 SDK 交易流程,下载并按照开发文档开发部署。在调试过程中如有问题,通过开发者中心对照解决,特殊情况下,联动惠商将提供专业的技术对接和指导。

    第4步,成功接入支付

    恭喜你的产品可以上线收款了!同时可在管理平台管理商户接入、业务开通、交易管理、终端管理等操作。

    第5步,应用市场发布

    将您集成的应用在应用市场发布,您的客户即可在他们的智能POS上找到您的应用,并下载使用。

    第6步,个性化定制智能POS

    通过合作伙伴分发的智能POS,支持智能POS个性化定制,包括桌面UI的logo、应用商店、内置应用、开机启动应用等。



  • 操作流程

  • 集成商接入(联动运营)

    1、集成商有联动惠商智能POS的合作意向;如果有成为支付代理商的意向,建议签署申请成为代理商。

    2、则通过运营帮助代理商开通"魔方智能支付平台"的帐号、密码;配置支付代理商的信息。

    3、集成商申请开发版的智能POS。


    集成商创建应用(集成商)

    1、集成商通过帐号、密码登录魔方智能支付平台(partner.huishangplus.com),通过如下路径进行应用创建:个性化定制终端—应用管理—创建新应用。

    2、选择"集成支付SDK应用"类型。

    3、集成商根据"待集成"的应用,填写 应用名称、应用包名、发布版安全码SHA1、测试版安全码SHA1(获取方法请见 http://partner.huishangplus.com/webmerser_jcs/common/APIfile.jsp)。

    4、成功获取应用的APP ID后,集成商即可进行应用集成(操作请见 http://partner.huishangplus.com/webmerser_jcs/common/APIfile.jsp)。

    5、集成后的测试版本应用,可以通过我们的开发版的智能POS进行调试,调试成功后,即可进行正式版本的发布。

    6、正式版通过"应用管理"模块进行应用上传,审核通过后,应用即可正式应用。


    集成商个性化定制终端(集成商)

    定制应用

    通过"个性化定制终端"的"应用商店定制",将"合作伙伴自有应用"中的"已创建的应用"(集成商创建,并审核通过的应用)添加至集成商自有应用商店,并可设置"初始强制安装"或"开机自动启动"。

    当然,集成商还可以将"平台提供的应用"添加至集成商自有应用商店,如糯米、美团、口碑等商户常用的应用。

    操作后,如图:

    定制LOGO

    通过"个性化定制终端"的"桌面UI定制",点击"上传logo",将集成商的logo图片提交上去。上传后,示意如图:

    通过个性化设置,打造一款属于集成商自己的智能终端。

    集成商个性化终端设置完毕,即可进行业务拓展啦,接入商户去…


    集成商接入商户(集成商)

    1、打开"商户管理"窗口

    2、点击"新建商户",在弹出窗口根据提示,填写对应的商户信息后,点击"确定",完成商户的创建。

    3、接入商户的操作管理,进行"业务开通",如图:

    其中重点信息

    (1)、"联动商户号"及"装机商户号"为联动电商线下收单进件平台的商户报备信息,如:



    (2)、终端列表中的"终端序列号"及"银联终端号" 为联动电商线下收单进件平台的终端信息,如:



    (3)、"商户费率"指收单协议中的签约费率。96费改之后,借记卡及贷记卡费率分离,请按照协议规定,准确填写借记卡费率、封顶手续费金额、贷记卡费率。


    4、开通完成后。



    业务开通完成后,即可查看该商户的业务开通状态。

    业务开通后,支持点击"开通业务查看",进行编辑修改。


    集成商给商户分配智能终端(集成商)

    业务配置开通完成后,将终端分配给商户(俗称"下机"),即可进行业务开展。

    第一步,终端分配给商户。


    通过"终端管理"模块,选择某台终端的POS SN(未出库给商户状态),点击该终端的操作项"出库",在弹出的页面,选择将该终端出库的商户,选中后点击确定。即可将该终端出库给该商户。

    出库后的终端, 可见出库到的商户信息。如:


    第二步,终端绑定商户终端序列号。

    出库后的终端, 要实施业务开通,需要设置"收单业务下机",以绑定商户的终端序列号。


    在弹出的页面中,选择绑定的终端序列号,如图:


    点击确定,即可将该终端绑定商户的终端序列号。


    点击"查看",即可查询该终端绑定商户的终端序列号的注册、签到的状态,如图:


    集成商的商户交易数据查看(集成商)

    1、通过交易管理模块的"交易概览"查询拓展商户的情况,包括拓展商户数、铺设终端数、交易数据等,如图:


    2、通过交易管理模块的"交易查询",查询商户的详细交易信息,支持按照商户ID、交易类型、交易状态、交易时间段等维度,查询交易信息,如图:



  • 常见问题

  • 交易时报签名校验失败

    出现原因:调试版key值签名 SHA1,正式版key值签名SHA1,魔方平台申请的APPID 三个值不匹配

    解决方案:获取项目调试版key值签名 SHA1,正式版key值签名SHA1,在魔方平台上查看项目的调试版SHA1和正式版SHA1,是否一致,如不一致,请编辑修改,如一致,请对比平台上获取的APPID和AndroidManifest中的APPID是否一致,如不一致,修改AndroidManifest中的APPID。


    支付时返回未知状态

    具体含义:支付结果未知

    出现原因:因为网络或其他原因客户端没有收到服务器返回的支付结果

    解决方案: 再次调用查询接口

    UMPay.getInstance().cardQuery(银行卡支付查询)

    UMPay.getInstance().scanQuery(扫码支付查询)

    退款时返回未知状态

    具体含义:退款结果未知

    出现原因:因为网络或其他原因客户端没有收到服务器返回的退款结果

    解决方案: 再次调用退款查询接口,有可能已经退款成功,一定要调用退款查询接口 UMPay.getInstance().refundQuery

    支付订单号

    支付订单号有什么作用,怎么生成?

    支付订单号推荐由接入方后台生成,实现对账、查询、退款功能, 规则:不能超过32位,保证自己平台唯一

    Failed to reslove

    接入出现如下问题


    解决方案:


    绑定失败

    解决方案:

    <!--<!uses-permission android:name="com.umpay.payplugin.permission.OPERATION_HARDWARE" />-->


京ICP证030914 | 增值电信业务经营许可证 B2-20120247 | 京公网安备11010802018450号 | 客服电话:400-112-5881
© 2015 联动优势科技有限公司 版权所有