开始
让自己熟悉我们的
设置头文件
设置头文件是 API 请求的重要组成部分。头文件代表与您的 API 请求相关的元数据。
Copied!
Authorization: {your_credentials}
Content-Type: application/vnd.worldpay.pay-direct-v1+json
Accept: application/vnd.worldpay.pay-direct-v1+jsonAuthorization: {your_credentials} Content-Type: application/vnd.worldpay.pay-direct-v1+json Accept: application/vnd.worldpay.pay-direct-v1+json| 头文件 | 模式 |
|---|---|
Authorization | 我们在 Access Worldpay 中使用 Authorization 头文件来识别您并进行身份验证。除非您在 TLS 上使用了客户端证书身份验证，否则您必须对发送到我们 APM API 的任何请求使用 Authorization 头文件。如果您必须使用此功能，请阅读关于 |
Content-Type | 如果您发送的请求中包含请求正文，并且 HTTP 方法是 POST 或 PUT，则我们要求使用 Content-Type 头文件。 |
Accept | 我们使用 Accept 头文件来识别您正在使用哪个版本的 APM 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: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:payouts": {
"href": "https://try.access.worldpay.com/payouts"
},
"service:fraudsight": {
"href": "https://try.access.worldpay.com/fraudsight"
},
"service:payments/alternative/direct": {
"href": "https://try.access.worldpay.com/payments/alternative/direct"
},
"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: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:payouts": { "href": "https://try.access.worldpay.com/payouts" }, "service:fraudsight": { "href": "https://try.access.worldpay.com/fraudsight" }, "service:payments/alternative/direct": { "href": "https://try.access.worldpay.com/payments/alternative/direct" }, "curies": [{ "href": "https://try.access.worldpay.com/rels/payments/{rel}", "name": "payments", "templated": true }] } }查询 Paydirect 根资源
查询根资源的 service:payments/alternative/direct 操作链接。
请求
GET https://try.access.worldpay.com/payments/alternative/direct
注释：该请求不需要请求正文。
响应
Copied!
{
"_links": {
"resourceTree": {
"href": "https://try.access.worldpay.com/rels/payments/alternative/direct/resourceTree"
},
"direct:sale": {
"href": "https://try.access.worldpay.com/payments/alternative/direct/sale",
"templated": true
},
"direct:events": {
"href": "https://try.access.worldpay.com/payments/alternative/direct/events",
"templated": true
},
"curies": [
{
"name": "direct",
"href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rel}",
"templated": true
}
]
}
}{ "_links": { "resourceTree": { "href": "https://try.access.worldpay.com/rels/payments/alternative/direct/resourceTree" }, "direct:sale": { "href": "https://try.access.worldpay.com/payments/alternative/direct/sale", "templated": true }, "direct:events": { "href": "https://try.access.worldpay.com/payments/alternative/direct/events", "templated": true }, "curies": [ { "name": "direct", "href": "https://try.access.worldpay.com/rels/payments/alternative/direct/{rel}", "templated": true } ] } }资源
该响应包含销售请求的链接：
| 操作链接（资源） | 描述 |
|---|---|
| direct:sale | 您销售请求的操作链接。 |
| 支付查询请求 |
后续步骤
