快速开始
在接入 ZOLOZ 前,您可以参考接入前准备、接入 ZOLOZ,以及接入后验证等流程了解如何快速接入 ZOLOZ。
说明:在接入 ZOLOZ 步骤中,客户端/移动 Web 端接入不是必选项,只有当您使用 SDK 或移动 Web 接入方式时才需要配置。
接入前准备
在接入 ZOLOZ 前,请先执行以下操作:
接入规划
在接入 ZOLOZ 前,首先应规划好您的接入过程:
- 选择开发环境,并确认将要接入的服务端点。
ZOLOZ 分别提供了测试环境和生产环境,您可以根据需要选择将要接入的环境。
测试环境或生产环境的主要区别是环境中的服务端点(包括 ZOLOZ 门户和基础 API URI)不同。关于开发环境及其服务端点的更多信息,请参见 了解环境和服务端点。
说明:为了避免对生产环境造成影响,建议您预先在测试环境中进行接入和验证 - 按需选择接入模式
ZOLOZ 目前支持 3 种接入模式,分别如下:
- 原生 App SDK 模式:当本机移动应用程序(iOS/Android)接入 ZOLOZ 服务时,请使用该模式。
- H5 模式:当移动网络 (H5) 应用程序或通过移动网络浏览器接入 ZOLOZ 服务时,请使用该模式。
- API 模式:当服务器端应用通过 API 接入 ZOLOZ 服务时,请使用该模式。
关于以上每种接入方式的更多信息以及支持的产品,请参见 了解接入模式。
ZOLOZ 账号设置
- 创建 ZOLOZ 管理员账号。
请联系 ZOLOZ 技术支持人员,并提供您的电子邮件地址和用例,让其为您创建一个管理员账号。账号创建完成后,您将收到一封包含用户名和密码的电子邮件。 - 登录 ZOLOZ 门户并修改初始密码
在指定的开发环境中,使用浏览器打开 ZOLOZ 门户登录页面。输入用户名和密码,登录ZOLOZ 门户。如果首次登录门户,系统则要求您修改登录密码。密码修改完成后,页面重新跳转到门户主页。
API 凭证准备
在接入 ZOLOZ 网关中需要使用 API 凭证,因此请预先准备以下 API 凭证:
- 客户 ID:账号的唯一标识,用于跟踪您的交易。客户 ID 在创建账号时生成,并可以从 ZOLOZ 门户中获取。
- ZOLOZ 交易公钥:用于加密请求或验证从 ZOLOZ 返回的响应签名。ZOLOZ 交易公钥在创建账号时生成,并且是唯一,并从 ZOLOZ 门户获取。
- 客户端交易密钥对:您提供的密钥对。您的公钥必须在 ZOLOZ 系统中注册,以便 ZOLOZ 服务可以使用该密钥来验证您的请求的签名或加密返回给您的响应。为方便起见,您可以使用 ZOLOZ 门户自动生成密钥对,也可以自己生成。
ZOLOZ 网关接入
为了正常调用 ZOLOZ API,使 API 请求和响应能够正确传输和处理,必须先接入 ZOLOZ 网关。
关于接入 ZOLOZ 网关的更多信息,请参见 接入 ZOLOZ 网关。
接入 ZOLOZ
根据接入 ZOLOZ 的对象,使用合适的接入方式。
- API 模式:只适用于服务端接入 ZOLOZ API。
- App SDK 模式/移动 web (H5) 模式:可以同时适用于服务器端和客户端/移动 Web 端接入 ZOLOZ。
请根据选定的接入方式接入 ZOLOZ:
接入后验证
接入 ZOLOZ 后,应验证是否接入成功。
注意:为了避免对生产环境造成影响,建议您预先在测试环境中进行接入和验证。