开始
让自己熟悉我们的
设置头文件
设置头文件是 API 请求的重要组成部分。头文件代表与您的 API 请求相关的元数据。
Copied!
Authorization: {your_credentials}
Content-Type: application/vnd.worldpay.pay-action-v1+json
Accept: application/vnd.worldpay.pay-action-v1+json
Authorization: {your_credentials} Content-Type: application/vnd.worldpay.pay-action-v1+json Accept: application/vnd.worldpay.pay-action-v1+json
头文件 | 模式 |
---|---|
Authorization | Authorization 头文件用于对 Access Worldpay 中的商户进行身份验证和识别。除非您在 TLS 上使用了客户端证书身份验证,否则您发送至我们 Action To Pay API 的任何请求均必须使用 Authorization 头文件。如果您必须使用此功能,请阅读关于 |
Content-Type | 若您发送的请求中包含请求正文,且所采用的 HTTP 方法是POST ,则要求使用Content-Type 头文件。 |
Accept | Accept 头文件用于识别您正在使用哪个版本的 Action to Pay 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 } ] } }
查询 iDeal 根资源
查询根资源的 service:payments/alternative/action/ideal
操作链接。
请求
GET https://try.access.worldpay.com/payments/alternative/action/ideal
注释:该请求不需要请求正文。
响应
Copied!
{
"_links": {
"resourceTree": {
"href": "https://try.access.worldpay.com/rels/payments/alternative/action/ideal/resourceTree"
},
"action:sale": {
"href": "/payments/alternative/action/ideal/sale",
"templated": true
},
"action:query": {
"href": "/payments/alternative/action/ideal/query",
"templated": true
},
"curies": [
{
"name": "action",
"href": "https://try.access.worldpay.com/rels/payments/alternative/action/ideal/{rel}",
"templated": true
}
]
}
}
{ "_links": { "resourceTree": { "href": "https://try.access.worldpay.com/rels/payments/alternative/action/ideal/resourceTree" }, "action:sale": { "href": "/payments/alternative/action/ideal/sale", "templated": true }, "action:query": { "href": "/payments/alternative/action/ideal/query", "templated": true }, "curies": [ { "name": "action", "href": "https://try.access.worldpay.com/rels/payments/alternative/action/ideal/{rel}", "templated": true } ] } }
资源
该响应包含销售请求的链接:
操作链接(资源) | 描述 |
---|---|
操作请求的 | 操作链接。 |
操作链接,用于查询您的付款状态。 |