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

开始使用 Verifications API

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

启用验证

请您的关系经理在加入过程中启用验证。

设置头文件

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

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

查询验证根资源

查询 service:verifications/accounts 资源以获得我们 Verifications API 的资源。

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

响应

Copied!
{
  "_links": {
    "resourceTree": {
      "href": "https://try.access.worldpay.com/rels/verifications/accounts/resourceTree"
    },
    "verifications:oneTime": {
      "href": "https://try.access.worldpay.com/verifications/accounts/intelligent/oneTime",
      "templated": true
    },
    "verifications:cardOnFile": {
      "href": "https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile",
      "templated": true
    },
    "verifications:recurring": {
      "href": "https://try.access.worldpay.com/verifications/accounts/intelligent/recurring",
      "templated": true
    },
    "verifications:dynamicOneTime": {
      "href": "https://try.access.worldpay.com/verifications/accounts/dynamic/oneTime",
      "templated": true
    },
    "verifications:dynamicCardOnFile": {
      "href": "https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile",
      "templated": true
    },
    "verifications:dynamicRecurring": {
      "href": "https://try.access.worldpay.com/verifications/accounts/dynamic/recurring",
      "templated": true
    },
    "verifications:verification": {
      "href": "https://try.access.worldpay.com/verifications/accounts/{resource}",
      "templated": true
    },
    "verifications:ach": {
      "href": "https://try.access.worldpay.com/verifications/accounts/ach",
      "templated": true
    },
    "curies": [
      {
        "name": "verifications",
        "href": "https://try.access.worldpay.com/rels/verifications/accounts/{rel}",
        "templated": true
      }
    ]
  }
}

选择其中一个操作链接，然后向相应的资源发送请求。

资源

资源描述
verifications:oneTime验证 oneTime 支付。
verifications:cardOnFile验证 cardOnFile 支付。
verifications:recurring请勿使用。
verifications:dynamicOneTime对照规定的金额验证您客户的 oneTime 支付。
verifications:dynamicCardOnFile对照规定的金额验证您客户的 cardOnFile 支付。
verifications:dynamicRecurring请勿使用。
verifications:verification发送请求以接收历史验证的结果。

后续步骤

验证客户账户