SCA 豁免
让自己熟悉我们的
设置头文件
设置头文件是 API 请求的重要组成部分。头文件代表与您的 API 请求相关的元数据。
Copied!
Authorization: {your_credentials}
Content-Type: application/vnd.worldpay.exemptions-v1.hal+json
Accept: application/vnd.worldpay.exemptions-v1.hal+json
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 头文件。如果您必须使用此功能,请阅读关于 |
Content-Type | 如果您发送的请求中包含请求正文,并且 HTTP 方法是 POST 或 PUT ,则我们要求使用 Content-Type 头文件。 |
Accept | 我们使用 Accept 头文件来识别您正在使用哪个版本的豁免 API。您必须对发送给豁免 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
}
]
}
}
{ "_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 } ] } }
在集成到 Access Worldpay 时,我们强烈建议您从操作链接中获取 URI 资源链接。不要对 URI 资源链接进行硬编码,否则可能会变化并破坏集成。
什么是操作链接?
操作链接是在其中存储指向资源的 URI 链接的一个参数。
什么是 URI 资源链接?
URI 资源链接是指向您向其发送请求的资源的链接。
查询豁免根资源
查询豁免根资源的 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"
}
]
}
}
{ "_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 中发出请求时,您应该始终缓存返回的响应。
后续步骤