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

创建已验证 Token

在单个请求中,使用我们的 Verified Tokens API 来协调验证您的客户支付详情并创建 Token。


创建已验证 Token 请求

若要创建已验证 Token,请将您的请求 POST 到在已验证 Token 根资源请求的响应中返回的verifiedTokens:cardOnFile操作链接中。

在创建已验证 Token 时,您可以选择纳入 namespace 参数。请选择以下的具有命名空间的卡具有命名空间的会话选项卡以查看示例。

注释:有关命名空间的更多信息,请参见创建 Token

POST https://try.access.worldpay.com/verifiedTokens/cardOnFile

已验证 Token 创建请求正文:

Copied!
{
  "description": "Token-Description",
  "paymentInstrument": {
    "type": "card/plain",
    "cardHolderName": "Sherlock Holmes",
    "cardNumber": "4444333322221111",
    "cardExpiryDate": {
      "month": 5,
      "year": 2035
    },
    "cvc": "123",
    "billingAddress": {
      "address1": "221B Baker Street",
      "address2": "Marylebone",
      "address3": "Westminster",
      "postalCode": "NW1 6XE",
      "city": "London",
      "state": "Greater London",
      "countryCode": "GB"
    }
  },
  "narrative": {
    "line1": "The Mind Palace Ltd",
    "line2": "Memory265-13-08-1876"
  },
  "merchant": {
    "entity": "MindPalaceLtd"
  },
  "verificationCurrency": "GBP"
}
{
  "description": "Token-Description",
  "paymentInstrument": {
    "type": "card/plain",
    "cardHolderName": "Sherlock Holmes",
    "cardNumber": "4444333322221111",
    "cardExpiryDate": {
      "month": 5,
      "year": 2035
    },
    "cvc": "123",
    "billingAddress": {
      "address1": "221B Baker Street",
      "address2": "Marylebone",
      "address3": "Westminster",
      "postalCode": "NW1 6XE",
      "city": "London",
      "state": "Greater London",
      "countryCode": "GB"
    }
  },
  "narrative": {
    "line1": "The Mind Palace Ltd",
    "line2": "Memory265-13-08-1876"
  },
  "merchant": {
    "entity": "MindPalaceLtd"
  },
  "verificationCurrency": "GBP",
  "namespace": "SHOPPER_ID_1234567890"
}
{
  "description": "Token-Description",
  "paymentInstrument": {
    "type": "card/checkout",
    "cardHolderName": "Sherlock Holmes",
    "sessionHref": "https://try.access.worldpay.com/verifiedTokens/sessions/eyJrIjoxLCJkIjoiZmJIT1pOOXNRc2xFeWQ1NXc5WEVLWHppUlJUWkpiMGozZkZIdWhFdmp4QTd4UmpNcWVmL0xJQzhHUTE0MCt6NyJ9",
    "billingAddress": {
      "address1": "221B Baker Street",
      "address2": "Marylebone",
      "address3": "Westminster",
      "postalCode": "NW1 6XE",
      "city": "London",
      "state": "Greater London",
      "countryCode": "GB"
    }
  },
  "narrative": {
    "line1": "The Mind Palace Ltd",
    "line2": "Memory265-13-08-1876"
  },
  "merchant": {
    "entity": "MindPalaceLtd"
  },
  "verificationCurrency": "GBP"
}
{
  "description": "Token-Description",
  "paymentInstrument": {
    "type": "card/checkout",
    "cardHolderName": "Sherlock Holmes",
    "sessionHref": "https://try.access.worldpay.com/verifiedTokens/sessions/eyJrIjoxLCJkIjoiZmJIT1pOOXNRc2xFeWQ1NXc5WEVLWHppUlJUWkpiMGozZkZIdWhFdmp4QTd4UmpNcWVmL0xJQzhHUTE0MCt6NyJ9",
    "billingAddress": {
      "address1": "221B Baker Street",
      "address2": "Marylebone",
      "address3": "Westminster",
      "postalCode": "NW1 6XE",
      "city": "London",
      "state": "Greater London",
      "countryCode": "GB"
    }
  },
  "narrative": {
    "line1": "The Mind Palace Ltd",
    "line2": "Memory265-13-08-1876"
  },
  "merchant": {
    "entity": "MindPalaceLtd"
  },
  "verificationCurrency": "GBP",
  "namespace": "SHOPPER_ID_1234567890"
}

请求参数的描述:

参数必需描述
descriptionToken 描述。如果未提供,则会为您创建默认 description
tokenExpiryDateTimeToken 不可用的日期/时间,以 ISO 8601 格式表示。如果未提供,则在 Try 环境中的默认过期日期/时间为 7 天,在 Live 环境中为 4 年。

如果 Token 的剩余时间不足一半,我们会在使用 Token 后将有效期延长 7 天或 4 年。
paymentInstrument包含支付类型和详情的对象。所有子字段均为必填,但 cvcbillingAddress 除外(见下文)。
cvc卡上的 CVC 号。这会在验证过程中使用,如果没有提供,则验证通过率可能会降低。
billingAddress包含账单邮寄地址信息的对象。如已纳入,则以下字段为必填:
  • address1
  • city
  • countryCode
  • postalCode
这会在验证和支付流程过程中使用。如果所提供的地址与在发卡银行注册的地址不符,则该支付存在其他风险。
merchant包含有关商户信息的对象。请联系您的实施经理了解更多信息。
verificationCurrency3 个字符的货币代码。请参见支持的货币列表。
namespace会使用命名空间来将最多 16 个卡集合为一组,e.g. 用于一个客户。一个卡可以位于多个命名空间。
narrativenarrative 对象可帮助您的客户在其对账单中更好地识别您。如果已纳入,则您必须提供子字段 line1,用于提供有关商户的基本详情。您还可以选择纳入子字段 line2,用于有关支付或商户的其他上下文。有关更多信息,请参见格式化章节。

使用会话

如果您使用Access Checkout SDK,则 paymentInstrument.type 会从 card/plain 更改为 card/checkout,而且会使用 sessionHref,而不是 cardNumbercardExpiryDatecvc

sessionHref 看起来如下:

Copied!
https://try.access.worldpay.com/verifiedTokens/session/eyJrIjoxLCJkIjoicGtubGtlWDJzeTVTdG1Qa3F5WlZ0emdJY1JEbjIyZVJ6KzlOR245YWlOMFVsVytCYitTa1NWa3l0RU1DQjZXYiJ9

注释:会话具有 1 分钟的使用寿命,并且您只能使用一次。

响应

最佳实践:Access Worldpay 在服务响应的头文件中返回 WP-CorrelationId。我们强烈建议您将此记录下来。我们使用 WP-CorrelationId 检查单个服务请求。

一旦您发送了请求,将会返回以下响应之一:

注释:如果出现错误,您可以在我们的错误参考中获取更多信息。


后续步骤


查询验证和 Token
接受支付