H5单点登录接口V1.0

概述

本文档用于说明携程商旅（以下简称“携程”）向客户提供的APP单点登录对接服务。该服务采用Restful的方式实现。本文档中包含接口方法说明、设计文档、调用方法及完整示例代码。通过H5端单点登录至携程，跳转逻辑默认仅支持中文版。

注意事项

一、特殊渠道H5单点登录异常提醒
1、钉钉H5单点登录
A、安卓端物理键返回按钮会报错，建议直接使用返回按钮或虚拟键

2、企业微信H5单点登录
A、无回退按钮。

二、开发注意事项
1、接口调用务必采用域名方式调用，切勿采用IP地址方式调用。
2、接口调用顺序，先调用获取令牌服务，再调用单点登录H5SignInfo服务。
3、前端必须采用提交Form表单方式调用接口。
4、不支持Iframe嵌套方式，基于携程集团对信息安全因素的考虑，不再提供在Iframe中的嵌套访问形式。

契约

1.对接说明

当员工通过其公司移动APP访问携程商旅时，客户公司移动APP根据当前员工信息提供员工编号或者接入账号等接入携程单点登录系统。携程单点登录系统自动校验接入权限，并与携程商旅管理系统内置的员工信息匹配，实现员工身份的识别和整合登录。

2.接口方法说明

2.1.获取令牌 （后端调用）

2.2.单点登录H5SignInfo（前端调用）

3.接口契约说明

3.1.获取令牌

3.1.1.请求契约

3.1.2.返回契约

响应RequestResult

示例：{“Token”：“5514eea9c3d1b72148000001”，“Message”：“”，“Code”：0，“Success”：true}

3.2.单点登录H5SignInfo

3.2.1请求契约

3.2.2 机票航班列表查询参数

 3.2.3 酒店页面跳转参数

3.2.4 火车票页面跳转参数

3.2.5 国内和国际接送机页面跳转参数

3.2.6 国内接送火车页面跳转参数

3.2.7包车页面跳转参数

3.2.8马上用车

4.调用方法及代码示例

4.1.接口调用示例代码

4.1.1 获取令牌

查看代码调用示例

4.1.2 单点登录H5SignInfo

HTML代码：

注意：HTML数据需要通过POST方式提交，IFRAME嵌套目前暂不支持。如果通过Native方式接入，请不要使用Native头部遮挡或下移商旅H5页面。WebView高度不能低于555px。

4.1.3 单点登录H5SignInfo（get方式）

需要将【AccessUserId=xxx&Token=xxx&Appid=xxx&EmployeeId=xxx】和其他需要的参数，先base64编码，再进行url编码，
作为单点登录的【SsoData】参数。

（备注：xxx是url编码后的参数值，url编码方式是js的encodeURIComponent）

eg：【https://ct.ctrip.com/m】encodeURIComponent编码后是【https%3A%2F%2Fct.ctrip.com%2Fm】

url样例：
https://ct.ctrip.com/m/SingleSignOn/H5SignInfo?SsoData=base64 加密且url编码后的字符串

请求示例：

注意：Token已经加密后放到SsoData参数中了，不需要再在url上带一个额外的Token参数。

例如：

https://ct.ctrip.com/m/SingleSignOn/H5SignInfo?SsoData=xxxx 正确

https://ct.ctrip.com/m/SingleSignOn/H5SignInfo?SsoData=xxxx&Token=aaa 不正确

4.2 传参说明

4.2.1 segmentInfo 传参说明

[
    {
“segmentNo”： “1”，
“flightNoList”： [
{
“flightNo”： “MU1234”，
“flightDate”： “2025-11-22 00：00：00”
}，
{
“flightNo”： “MU1235”，
“flightDate”： “2025-12-22 00：00：00”
}
]
}，
{
“segmentNo”： “2”，
“flightNoList”： [
{
“flightNo”： “MU1234”，
“flightDate”： “2025-12-23 00：00：00”
}，
{
“flightNo”： “MU1235”，
“flightDate”： “2025-12-24 00：00：00”
            }
        ]
    }
]

segmentInfo : %5B%7B%22segmentNo%22%3A%221%22%2C%22flightNoList%22%3A%5B%7B%22flightNo%22%3A%22MU1234%22%2C%22flightDate%22%3A%222025-11-22+00%3A00%3A00%22%7D%2C%7B%22flightNo%22%3A%22MU1235%22%2C%22flightDate%22%3A%222025-12-22+00%3A00%3A00%22%7D%5D%7D%2C%7B%22segmentNo%22%3A%222%22%2C%22flightNoList%22%3A%5B%7B%22flightNo%22%3A%22MU1234%22%2C%22flightDate%22%3A%222025-12-23+00%3A00%3A00%22%7D%2C%7B%22flightNo%22%3A%22MU1235%22%2C%22flightDate%22%3A%222025-12-24+00%3A00%3A00%22%7D%5D%7D%5D

java: URLEncoder.encode(JsonUtil.toJson(List.of(segmentInfo1, segmentInfo2)), StandardCharsets.UTF_8)

其中segmentNo、flightNoList、flightNo、flightDate 均为必传参数，请注意。

5.WebView配置信息

　　首先需要用到控件webView，实例化后，按如下配置

5.1 设置webviewclient

5.2 配置cache localstorage等 

5.3 IPhoneX 头部适配

    在请求头的UserAgent中添加ScreenFringe字段即可。

5.4 Native WebView中需要开启第三方Cookie支持

    　IOS代码
　　[[NSHTTPCookieStorage sharedHTTPCookieStorage] setCookieAcceptPolicy:NSHTTPCookieAcceptPolicyAlways];

　　Andoird代码
　　if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    　　CookieManager.getInstance().setAcceptThirdPartyCookies(this, true);
　　}

6.Android接入支付宝和微信支付

　　支付宝支付需要接入支付宝的SDK，微信支付不需要进行额外的接入操作。

6.1 接入支付宝SDK流程

下载支付SDK，下载链接：https://docs.open.alipay.com/54/104509

下载完成后按照支付宝官方文档将SDK集成到项目中，文档链接：https://docs.open.alipay.com/204/105695/

文档中步骤二需要写入外部存储和读取手机状态的权限，如果app的targetSdk等级是23级以上，就需要动态的进行授权，如果app内已经申请过这两个权限可以忽略接下来的作。

6.2  动态授权

动态授权建议在跳转支付平台之前进行授权，因为跳转到支付平台后使用支付宝支付时采用的是支付宝SDK提供的拦截方法，我们并不清楚具体的协议，无法准确的拦截，会存在一定的风险，所以需要提前授权。

支付宝官方demo授权相关代码：

6.3  实现微信支付和支付宝支付

如上准备工作完成后，接下来在项目中接入相关代码实现APP支付功能。
找到项目中使用的webview，设置webview的WebViewClinet，在shouldOverrideUrlLoading方法中加入如下代码：

至此整个接入流程就已经完成了。

7. IOS接入支付宝和微信支付

7.1 IOS接入支付宝

7.1.1 准备相关SDK

支付宝支付需要接入支付宝的 SDK，先去支支付宝的开发者下载支付相关的 SDK 集成到 项目中。相关连接：https://docs.open.alipay.com/204/105295/，按照文档导入支付宝的 SDK，配置好相关的权限。

7.1.2 增加头文件引用

在需要调用到AlipaySDK的文件中，增加头文件引用import 。

7.1.3 配置支付宝客户端返回url处理方法

外部存在支付宝钱包，支付宝钱包将处理结果通过url返回。
Urlscheme 要添加 alipay fromScheme 为接入app的 scheme，用于支付宝回调用。

7.1.4 调用支付API

H5中调用的接口主要是下面这个：

具体项目中的实现逻辑是h5中调用。
在wkwebview的代理方法中调用如下代码：

7.2 IOS接入微信支付

7.2.1 设置 info.plist
　　在 LSApplicationQueriesSchemes，添加 weixin 。

7.2.2 WKWebView 的代理方法添加处理代码

8. 常见问题

8.1 微信企业App（定制环境）接入单点登录

需要设置信任域名，
域名
       ct.ctrip.com
       secure.trip.com
       secure.ctrip.com
https端口 443

8.2 在商旅中定位或打卡会有弹窗提示

使用定位功能需要获取系统相关权限，必定会有弹窗提示

8.3 客户使用schema唤起支付宝支付（alipays:// ）无法唤起

支付宝现在支持的schema是 alipay://，不带s的.

8.4  微信支付失败

提示如下：

请确认请求头中，包含对应的Referer且值为“https://secure.ctrip.com”。

如下所示：Headers.put（“Referer”， “https://secure.ctrip.com”）;

版本