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

开始使用 Verified Tokens API

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

设置头文件

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

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

查询已验证 Token 根资源

查询 service:verifiedTokens 资源，它会为您提供 Verified Tokens API 的后续可用操作的链接和资源。

请求

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

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

响应

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

Copied!
{
  "_links": {
    "verifiedTokens:cardOnFile": {
      "href": "https://try.access.worldpay.com/verifiedTokens/cardOnFile"
    },
    "verifiedTokens:sessions": {
      "href": "https://try.access.worldpay.com/verifiedTokens/sessions"
    },
    "resourceTree": {
      "href": "https://try.access.worldpay.com/rels/verifiedTokens/resourceTree.json"
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/verifiedTokens/{rel}.json",
        "name": "verifiedTokens",
        "templated": true
      }
    ]
  }
}

资源

资源描述
verifiedTokens:cardOnFile创建已验证 Token，您可以用其接受预存卡号支付。预存卡号支付由客户使用已存储的支付工具详情来发起。
verifiedTokens:sessions由Access Checkout SDK用于创建会话。

注释：在您检索根资源时，您应该将响应中提供的操作链接缓存一段时间。

后续步骤

创建已验证 Token