ZOLOZZOLOZDOCS

接入ZOLOZ AML

本文介绍接入ZOLOZ AML的全流程，包括接入前准备、接入ZOLOZ AML和接入后验证，帮助您快速接入ZOLOZ AML服务。

接入流程图

接入ZOLOZ AML的流程图如下所示。

image.png

接入前准备

  1. 选择站点和环境。
    ZOLOZ提供独立的测试环境和生产环境，不同的站点和环境对应的服务入口不同，包括ZOLOZ AML门户地址和AML API URI。您可以根据需要选择要接入的站点和环境。
  2. 准备ZOLOZ账号。
    1. 创建租户和管理员账号。
      联系与您合作的ZOLOZ AML BD团队，并提供您的电子邮箱，让其为您创建租户和管理员账号。账号创建完成后，您将收到一封包含用户名和密码的电子邮件。
    2. 登录ZOLOZ AML门户并修改初始密码。
      首次登录ZOLOZ AML门户，系统会要求您修改登录密码。
      1. 根据您选择的站点和环境，使用浏览器打开ZOLOZ AML门户登录页面，登录ZOLOZ AML门户。
        image
      2. 根据页面提示，修改初始密码。
        image
      3. 密码修改完成后，页面会自动跳转到门户主页。
        image.png
  1. 获取API凭证。
    为确保您的业务与ZOLOZ服务之间能够安全地传输报文，需要对传输报文进行签名、验证、加密和解密，因此需要您提前准备好以下API凭证。
    • Client ID：客户ID，商户账号的唯一标识。在创建ZOLOZ管理员账号时由系统自动生成，您可以在ZOLOZ门户中获取。
    • ZOLOZ transaction public key：ZOLOZ交易公钥，用于加密请求或验证从ZOLOZ返回的响应签名。在创建ZOLOZ管理员账号时由系统自动生成，且具有唯一性，您可以在ZOLOZ门户中获取。
    • Your transaction key pair：商户交易密钥对，包含一个公钥和一个私钥。公钥必须在ZOLOZ AML门户中注册，以便ZOLOZ服务使用该密钥来验证商户的请求签名或对返回给商户的响应进行加密。为了方便起见，您可以在ZOLOZ AML门户中自动生成商户交易密钥对，也可以自行手动生成。
  1. 接入ZOLOZ网关。
    为了正常调用ZOLOZ API，使API请求和响应能够正确地传输和处理，在接入ZOLOZ API之前，您需要先接入ZOLOZ网关。

接入ZOLOZ AML

接入后验证

成功接入ZOLOZ AML并正常运行业务流程后，您应进一步验证业务数据是否符合您的预期。为避免对生产环境造成影响，建议您先在测试环境进行产品接入和验证，待运行稳定后再迁入生产环境。

您可以使用以下请求来测试API。

说明：如需获取tenantID和tntInstID的详细信息，请联系ZOLOZ BD或解决方案团队。

  • 以下示例为未命中制裁名单的情况
copy
{
"bizCode": "MANUAL_SCAN_SANCTION",
"extendData": {
"certName": "Peter"
},
"tenantID": "XXX",
"tntInstID": "XXX"
}
  • 以下示例为命中了制裁名单的情况
copy
{
"bizCode": "MANUAL_SCAN_SANCTION",
"extendData": {
"certName": "Hamza bin Laden"
},
"tenantID": "XXX",
"tntInstID": "XXX"
}