Translation disclaimer

Documentation is written in English and subsequently translated. This page, therefore, might not have the most up-to-date content. If any questions arise relating to the accuracy of the translated content, please refer to the English version of the page.

Menu

3DS

简单而无缝地验证您的客户身份，以最大限度地减少欺诈。使用我们强大的客户身份验证，以便从责任转移中受益。

注释：让自己熟悉我们的API 原则，以确保有弹性的集成。

设置头文件

设置头文件是 API 请求的重要组成部分。头文件代表与您的 API 请求相关的元数据。

请使用最新版本： v3

API 版本 3：自 2021 年 5 月起加入的新商户将对其账户启用 v3 版本的 API（在 Try 上启用 iOS/Android 支持的新测试值）。我们将逐步迁移现有商户。如果您需要 v3 版本进行测试，请联系支持部门加速开展。

Copied!
Authorization: {your_credentials}
Content-Type: application/vnd.worldpay.verifications.customers-v3.hal+json
Accept: application/vnd.worldpay.verifications.customers-v3.hal+json
头文件模式
Authorization我们在 Access Worldpay 中使用 Authorization 头文件来识别您并进行身份验证。除非您在 TLS 上使用了客户端证书身份验证，否则您必须对发送到我们 3DS API 的任何请求使用 Authorization 头文件。如果您必须使用此功能，请阅读关于通过 SSL/TLS 进行身份验证的参考指南。
Content-Type如果您发送的请求中包含请求正文，并且 HTTP 方法是 POST 或 PUT，则我们要求使用 Content-Type 头文件。
Accept我们使用 Accept 头文件来识别您正在使用哪个版本的 3DS API。您必须对发送给 3DS API 的任何请求使用 Accept 头文件。

如果您同时使用了 Content-Type 和 Accept 头文件，则它们必须匹配。

注释：用您 base64 编码的 Basic Auth（基本授权）用户名和密码替换“{your_credentials}”。若要获得 Access Worldpay 登录凭证，请联系您的实施经理。

查询根资源

我们的 API 可提供指向后续可用操作的链接，以便为您提供指导。

要探索并开始使用我们的 API，您必须首先查询根资源。这样就会返回 Access Worldpay 中的可用资源。

请求

GET https://try.access.worldpay.com/

注释：该请求不需要请求正文。

响应

您会在响应中收到所有我们可用的 API 资源。

Copied!
{
  "_links": {
    "payments:authorize": {
      "href": "https://try.access.worldpay.com/payments/authorizations"
    },
    "service:payments": {
      "href": "https://try.access.worldpay.com/payments"
    },
    "service:sessions": {
      "href": "https://try.access.worldpay.com/sessions"
    },
    "service:tokens": {
      "href": "https://try.access.worldpay.com/tokens"
    },
    "service:verifications/accounts": {
      "href": "https://try.access.worldpay.com/verifications/accounts"
    },
    "service:verifications/customers/3ds": {
      "href": "https://try.access.worldpay.com/verifications/customers/3ds"
    },
    "service:verifiedTokens": {
      "href": "https://try.access.worldpay.com/verifiedTokens"
    },
    "service:fraudsight": {
      "href": "https://try.access.worldpay.com/fraudsight"
    },
    "service:exemptions": {
      "href": "https://try.access.worldpay.com/exemptions"
    },
    "service:payouts": {
      "href": "https://try.access.worldpay.com/payouts"
    },
    "service:payments/alternative/direct": {
      "href": "https://try.access.worldpay.com/payments/alternative/direct"
    },
    "service:payments/alternative/action/paypal": {
      "href": "https://try.access.worldpay.com/payments/alternative/action/paypal"
    },
    "service:payments/alternative/action/ideal": {
      "href": "https://try.access.worldpay.com/payments/alternative/action/ideal"
    },
    "service:payouts/accounts": {
      "href": "https://try.access.worldpay.com/payouts/accounts"
    },
    "service:payouts/events": {
      "href": "https://try.access.worldpay.com/payouts/events"
    },
    "service:moneyTransfers": {
      "href": "https://try.access.worldpay.com/moneyTransfers"
    },
    "service:foreignExchange": {
      "href": "https://try.access.worldpay.com/foreignExchange"
    },
    "service:accounts/statements": {
      "href": "https://try.access.worldpay.com/accounts/statements"
    },
    "service:accounts/balance": {
      "href": "https://try.access.worldpay.com/accounts/balance"
    },
    "service:accounts/transfer": {
      "href": "https://try.access.worldpay.com/accounts/transfer"
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/payments/{rel}",
        "name": "payments",
        "templated": true
      }
    ]
  }
}

查询 3DS 根资源

查询 3DS 根资源的 service:verifications/customers/3ds 操作链接。

请求

GET https://try.access.worldpay.com/verifications/customers/3ds

注释：该请求不需要请求正文。

响应

Copied!
{
    "_links": {
      "resourceTree": {
        "href": "https://try.access.worldpay.com/verifications/customers/3ds/resourceTree"
      },
      "3ds:deviceDataInitialize": {
        "href": "https://try.access.worldpay.com/verifications/customers/3ds/deviceDataInitialization"
      },
      "curies": [
        {
          "href": "https://try.access.worldpay.com/rels/verifications/customers/3ds/{rel}",
          "templated": true,
          "name": "3ds"
        }
      ]
    }
  }

资源

该响应包含初始化 3DS 设备数据收集 (DDC) 的链接：

操作链接（资源）描述
3ds:deviceDataInitializeDDC 供发卡机构用于对客户下单时使用的设备进行指纹识别。带有 3DS1 回退的 3DS2 开始链接。

后续步骤

设备数据