引言

万里汇提供了强大的集成开发环境以及丰富的资源，帮助您实现快速集成。本指南介绍了如何使用万里汇开发者中心，以创建、测试及发布万里汇产品。

集成准备

在开始集成前，您需要确保以下前置条件已准备充分：

• 开发者中心账号：通过点击您公司管理员发送的邀请邮件注册新账号。
• 客户侧公钥：参考生成密钥对步骤，以生成您的公钥。
• 通知地址：提供 URL 地址，便于您接收 SPI 通知。
• 企业信息：提供所需的公司信息及联系方式。

集成步骤

1. 创建应用

登录开发者中心，进入“应用管理”页面。

点击创建应用，输入应用名称并勾选想要使用的解决方案。

注意：如果您不确定该选择哪个解决方案，请联系万里汇技术支持。

2. 配置沙箱

2.1 配置公钥

创建应用后，点击查看相关详情。

复制您生成的公钥并粘贴至密钥管理下方的输入框内。

2.2 （可选）添加模块及 Webhook

此为可选步骤。若想获得最佳的 API 测试体验，我们建议您添加以下两项配置：

• 模块：一旦您选择了解决方案，系统将自动选择相对应的模块及 API 接口。您也可根据自身的集成需要自行添加多个模块。
• Webhook：输入 Webhook 地址，并选择相应的 Webhook。完成此项配置后，发送请求时则不需再传入 Webhook 地址。

添加配置后，点击下一步提交设置信息，即完成沙箱配置。

3. 完成 API 测试用例

在申请上线审核前，您需要在沙箱环境完成所有测试用例。这是为了确保您的应用能正常运作。

在“应用管理”页面，点击查看进入测试用例页面。此时您将可看到所有需要完成的测试用例组。

点击详情进入个别的测试用例组页面，再点击执行，选择模拟规则（Mock Rule） 后点击开始。

您也可使用万里汇提供的 WorldFirst Public API 在 Postman 上进行 API 测试，包括发送请求及响应。操作方法详见 万里汇 Postman Collection 使用指南。

注意：

• 若系统返回“测试用例失败”的提示，表示测试没有通过，请排查原因并重试。
• SA 将在上线审核阶段评估您的测试用例结果。请确保所有测试用例均已通过测试，才提出上线申请，以免影响您的上线审批流程。

4. 提交上线申请

待所有的测试用例均已完成，您即可提交上线申请。

填写集成理由并点击提交。您可随时进入审批页面查看审核单详情。一旦审批通过，请前往步骤五完成生产环境的配置。

若上线申请被驳回，您需要按照 SA 返回的拒绝理由进行问题排查及重试。待所有测试用例均已验收成功，再重新提出上线申请。

5. 发布应用

发布应用前，您需要生成新的 RSA 密钥对，并于"集成设置"页面重新配置公钥。

注意：配置公钥前请确保您已切换至线上环境。

配置好公钥后点击完成，即完成生产环境的配置。