对接流程¶

商家自测步骤及要点¶

测试请使用 google 浏览器开发者模式下h5端

提供供应商开放平台地址并提示需要特别关注的信息

会员信息对接：员工登录商家流程 - 关爱通开放平台

实物类商家对接：关爱通收银台（标准支付） | 开放平台文档

服务类商家对接：关爱通收银台（标准支付） | 开放平台文档服务类商家交易类型为即时交易trade_type传参为1，下单付款后即订单完成。

退款单商家对接：支付退款(标准退款) | 开放平台文档

特别关注新手必看：对接说明 - 关爱通开放平台
提醒，供应商订类型是否为【非即时交易】，用户下单后需要发货或者线下需要再次给用户提供服务的（例：线下体检服务）订单，订单类型type为否，值为2；反之type值为1；
服务类供应商，用户下单后不需要提供商品明细，但需要履约后完成订单状态的，使用【交易接口问题】商家对接接口文档（供应商在完成订单履约后（线下服务）调用商家对接接口文档【订单完成】接口）
提供实物供应商需提供交易商品明细【交易接口文档】交易接口文档

实物供应商需提供交易商品明细： 关爱通会给供应商对应的path_code，调用接口需要按以下规范进行接口调用 https://openapi.guanaitong.tech/router/transfer?path_code=51aa93aea82bXX4 为接口中的 path_code 值，如没有请咨询管理员
提供供应商账号、密码用作登录关爱通开放平台申请应用
供应商通过账号登录关爱通开放平台申请测试应用并填写资料（订单类型是否即时交易，传参需特别关注）
关爱通审核供应商应用申请
应用申请审核通过后，供应商在应用申请后台可获取应用ID及密钥
关爱通给予供应商应用id对应的pathCode， 仅实物商品需要【交易接口文档】
供应商测试环境下进行测试应用对接开发，

仅实物商品需要在用户 支付完成通知后调用【交易接口文档】内【新增交易单】接口并推送商品明细及税率信息等

用户收货确认或供应商发货后自然日内 完成交易则需要调用【交易接口文档】内【完成交易】接口*

如发生取消订单退款或退货并退款，供应商需调用【交易接口文档】内【退货】接口并推送商品退货信息等
关爱通配置应用资产及测试企业订阅关系
关爱通配置应用模式（购销/其他），勾选应用获取商品明细接口（应用管理）
关爱通配置渠道接口， 仅实物商品需要配置 @袁健(Clive)
应用测试/生产环境上线测试

测试内容：搜索、商详、排序、加购、结算付款、下单付款调用关爱通收银台，取消订单、待发货、订单完成，售后退款等进行测试。

其中会实物商品订单内【创建交易接口，订单完成接口，退货退款接口】接口额外关注

应用体验自测参考文档：对接供应商应用体验设计自查表

应用对接体验走查标准：中智关爱通对接应用可行性评估管理制度
测试及生产环境，需要上线1_{10个库存左右，价格为1元}5元的商品进行测试；生成环境测试（商品称和传的税率信息全部按正常商品进行，因为要真实开票给关爱通）

生产环境测试内容包括但不限于以下内容：

下单付款调用关爱通收银台，创建交易接口，订单完成接口，退款，退货接口；

加购，搜索，搜索结果页，排序，商详，结算付款，取消订单，发货，完成，售后，开票，结算，关爱通走查报告（修复后才可以上线）
测试环境测试完毕后应用需要在生产环境上线进行测试，此时应用会给关爱通内部部分企业进行开放，会有真实订单生成，请务必在生产环境发布1个真实的测试商品（订单完成后需要开票与关爱通进行结算）
测试完成后生成的真实订单请商家登录商家后台商家登录进行申请结算并与关爱通结算部门@沈雁(Carol)对对账的结果进行开票，发票快递至关爱通， 关爱通收到发票后与供应商进行货款结算转账。
生产环境由关爱通走查体验负责人@刘蕾蕾对应用进行用户体验及流程的走查，会出具相应的走查报告，如问题严重需要供应商对应用进行修复， 如不修复则应用无法上线。
所有流程（下单、走查、开票结算）全部通过后方可进行正式上线并面向外部企业。

实物商品接口：请查仔细查阅【交易接口文档】内的接口内容

交易接口需要传商品明细，税率信息等；
订单完成后调用完成接口；
订单退款调用退货接口需要传商品明细，税率信息；

测试环境 Tech¶

请注意这个是测试环境，无需我方协助可自行进行测试

如遇到登录进去无法获取auth_code等情况，浏览器缓存清了一遍，重新打开浏览器就可以了

一、测试环境测试账号（员工个人）建议使用电脑端google浏览器¶

方法 1：使用管理员提供的应用链接入口在浏览器内打开（请用电脑端浏览器开发者模式H5 打开以下链接），输入测试员工使用的账号进行登录【测试员工使用账号登录】

方法 2：员工使用H5"给到端"登录连接：（请用电脑端浏览器开发者模式H5打开以下链接）进入给到H5页面，在搜索框内输入需要测试的"应用名称"，搜索出需要测试的应用图标，或者在对应资产下找到对应的应用进入授权登录后测试。

https://m.igeidao.tech

示例截图：测试员工登录页

登入方式1：账号登录

登入方式2：手机号登录（按一下发送短信验证码）

登录成功后的H5首页

搜索应用（如搜索不到可使用应用入口链接）

我的，资产内查看对应资产应用进入

员工电脑端登录链接：（基本不会用到）

关爱通:员工平台-欢迎登录(https://passport.guanaitong.tech/)

【测试员工使用账号登录】 （建议使用手机号+验证码登录）

用户名：15821888933

密码：ABCD0305

验证码：666666

支付密码：使用测试短信验证码，一定要点击发送，然后输入以下短信验证码

短信验证码：666666

登录成功后 使用关爱通给的【测试应用登录链接】即可进行测试或自行进行拼接入口地址，规则如下

关爱通:员工平台-欢迎登录https://openapi.guanaitong.tech/seller/person/trustLogin?appid=25001741

其中tech为测试环境，com为生产环境，替换即可切换环境。

appid=25001741为需要测试的应用id，只需替换8位数字即可拼应用入口地址。

举例Tech测试环境下的应用入口地址

https://openapi.guanaitong.tech/seller/person/trustLogin?appid=20091234

https://openapi.guanaitong.tech/seller/person/trustLogin?appid=20095678

举例Com生产环境下的应用入口地址

https://openapi.guanaitong.com/seller/person/trustLogin?appid=20091357

https://openapi.guanaitong.com/seller/person/trustLogin?appid=20092468

二、测试环境账号（企业）¶

企业编号：Q1127

企业名称：上海中软集团

三、测试环境账号（商家）以下仅示例¶

测试Tech环境下，不需要登录商家账号，此账号仅提供给供应商体验后台及查看退款等操作

登录链接：

商家登录

账号：shangjia001

密码： a12345678

验证码：666666

特别说明：供应商测试环境需要会员管理内创建新的，每个测试的应用对应不同的供应商账号。 以上仅参考

四、测试注意事项¶

H5 实物类对接：（合规要求：实物类H5对接的订单需要商品明细、税率信息

1. 开放平台接口+交易、订单完成、退款（退货）商品明细接口（税率信息）
2. 配置渠道信息@袁健(Clive)，配置样式如下：

环境:TECH；应用ID:XXXXXXXX；应用名称:XXXX；商家：SXXXX

H5 服务类对接：

1、开放平台接口
2、配置渠道信息：不经过渠供应道系统，不需要传明细的，无需配置

五、生产环境对接准备工作¶

5.1、关爱通分配appid和appsecret

5.1.1、商家通过google浏览器登录【关爱通开放平台】，点击【登录】

首页

点击【登录】

选择【商家】登录方式

进入商家登录页，并输入生产环境的商家【用户名】及对应用户的【登录密码】

登录成功后系统会返回关爱通开放平台，并显示对应的登录【用户名】

点击【管理中心】

点击【新增应用】

【应用名称】，输入应用名称，最大10个字符，建议3-4个字符，避开违禁字

【接入端】，多选，一般为APP

【安全IP】，可输入多个IP用英文逗号分开

【签名方式】，SHA256

【接入说明】，填写生产环境跳转的域名链接+应用说明

【关爱通平台开放协议】，勾选

点击【提交】即可，并通知管理员审核，审核通过后商家可在后台自行查阅审核结果及内容

生产环境（测试账号）

生产环境灰度测试企业 ID：Q14392

生产环境测试优先进行灰度测试（仅开放关爱通内部测试企业2~3家）

供应商可通过以下方式进入，下载APP"给到"或者问对应产品接口人获取应用登录入口链接；

或者通过以下链接登录H5页面进行下单测试

首页(igeidao.com)

用户名： 15821888933；登录密码：ABCD0305 ；

支付密码： ********* （如果需要测生成环境支付后的交易流程，可以问小编要短信验证码）

登陆成功后优先会让测试人员选择登录用户所对应的企业

注意：选择企业名称为 【直连型应用灰度测试平台】工号： HB489 （别选错，其他账号是小编自己的！！！切记！切记！切记！重要的事情说3遍！）

1 、选择测试企业，企业名称为 【直连型应用灰度测试平台】 （如下图）

首次登录有可能会需要验证下小编的手机号（毕竟这个手机号到处在不同手机不同地点登录过，为了安全小编愿意协助您做第一次登录的手机端验证）

2 、点击进入测试平台企业首页（如下图）

3 、在首页搜索栏内输入申请的【应用名称】，点击搜索找打对应图标入口（如下图）

如搜索不到可以问对接人员提供【应用入口的登录地址】

4 、进入首页找到测试约定的对应商品进行下单测试（如下图）

5 、第 5 点，也是最最最重要的一点，"祝各位供应商、合作商朋友们生意兴隆，年年大卖！"