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

SCA 豁免

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

设置头文件

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

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

如果您同时使用了 Content-TypeAccept 头文件,则它们必须匹配。

注释:用您 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:exemptions 操作链接。

请求

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

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

响应

Copied!
{
  "_links": {
    "resourceTree": {
      "href": "https://try.access.worldpay.com/exemptions/resourceTree"
    },
    "exemptions:assess": {
      "href": "https://try.access.worldpay.com/exemptions/assessment"
    },
    "curies": [
      {
        "href": "https://try.access.worldpay.com/rels/exemptions/{rel}",
        "templated": true,
        "name": "exemptions"
      }
    ]
  }
}

资源

该响应包含豁免评估请求的链接:

操作链接(资源)描述
exemptions:assess豁免评估请求

DNS 白名单

将以下 URL 列入白名单:

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

请确保使用 DNS 白名单,而不是显式 IP 白名单。

我们建议使用 DNS 白名单而不是显式 IP 白名单。

链接缓存

当您在 Access Worldpay 中发出请求时,您应该始终缓存返回的响应。

后续步骤


评估