{"items":[{"type":"link","label":"Tokens","link":"/products/tokens/v1/openapi","routeSlug":"/products/tokens/v1/openapi","content":{"contentType":"overview","meta":{"name":"Tokens"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/access/_bundle/products/tokens/@v1/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/access/_bundle/products/tokens/@v1/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"payload","title":"Payload","lang":"Payload"},{"key":"curl","title":"curl","lang":"curl"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"go","title":"Go","lang":"Go"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"csharp","title":"C#","lang":"C#"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Tokens (1)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimize the exposure of sensitive card details and increase the security of your customer's card details."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication header"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Authorization: {your_credentials}\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Authorization: {your_credentials}\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Replace "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{your_credentials}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with your base64-encoded Basic Auth username and password given to you by your Worldpay Implementation Manager."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header for any request you send to our Tokens API."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accept & Content-Type headers"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"  Accept: application/vnd.worldpay.tokens-v1.hal+json\n  Content-Type: application/vnd.worldpay.tokens-v1.hal+json\n"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"  Accept: application/vnd.worldpay.tokens-v1.hal+json\n  Content-Type: application/vnd.worldpay.tokens-v1.hal+json\n"},"children":[]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our Tokens API."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For detokenization requests, adapt the Accept header to also pass masked = false, as follows: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Accept:"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"'application/vnd.worldpay.tokens-v1.hal+json; masked=false'"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"admonition","inline":true,"attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Detokenizing exposes your business to high levels of PCI auditing, required to remain PCI compliant."},"children":[]}]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a POST or a PUT."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"DNS whitelisting"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whitelist the following URLs:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://try.access.worldpay-bsh.securedataplatform.co.uk/"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"https://access.worldpay-bsh.securedataplatform.co.uk/"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please ensure you use DNS whitelisting, not explicit IP whitelisting. When you make a request within Access Worldpay, you should always cache the response returned."},"children":[]}]}]}]}],"sectionId":"/products/tokens/v1/openapi"}],"sectionId":"/products/tokens/v1/openapi"}]}]}},{"type":"group","label":"Token","link":"/products/tokens/v1/openapi/token","routeSlug":"/products/tokens/v1/openapi/token","items":[{"label":"Create a new token","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/tokens/v1/openapi/token/createsecuritytoken","routeSlug":"/products/tokens/v1/openapi/token/createsecuritytoken","metadata":{"seo":{"title":"Create a new token","description":"Creating a new token for the payment instrument."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSecurityToken","name":"Create a new token","isWebhook":false,"pointer":"/paths/~1tokens/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a new token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creating a new token for the payment instrument."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeSchemas":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/token_creation","exampleIds":["paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"]}},"schemaId":"components/schemas/token_creation","exampleIds":["paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"],"pointer":"/paths/~1tokens/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/tokens","servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/token_creation","exampleIds":["paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"]}},"responseCodes":["200","201","409"],"pointer":"/tokens","href":"token/createsecuritytoken","openApiOperationId":"createSecurityToken","summary":"Create a new token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"schemaId":"components/schemas/token_creation","exampleIds":["paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeSchemas":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/token_creation","exampleIds":["paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A token already exists matching the details in the request.","mediaType":"application/vnd.worldpay.tokens-v1.hal+json","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token"]}},"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token"],"headers":{"Accept":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Content-Type":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Location":{"schema":{"type":"string","format":"uri"},"description":"A URI identifying the created token resource."}},"headerSchemaId":"schema_475"},{"code":"201","description":"A new token was created.","mediaType":"application/vnd.worldpay.tokens-v1.hal+json","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_201_response","exampleIds":["paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created"]}},"schemaId":"components/schemas/tokens_token_201_response","exampleIds":["paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created"],"headers":{"Accept":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Content-Type":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Location":{"schema":{"type":"string","format":"uri"},"description":"A URI identifying the created token resource."}},"headerSchemaId":"schema_475"},{"code":"409","description":"A token already exists conflicting with some details in the request.","mediaType":"application/vnd.worldpay.tokens-v1.hal+json","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_409_response","exampleIds":["paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict"]}},"schemaId":"components/schemas/tokens_token_409_response","exampleIds":["paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict"],"headers":{"Accept":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Content-Type":{"schema":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]}},"Location":{"schema":{"type":"string","format":"uri"},"description":"A URI identifying the conflicting token resource."}},"headerSchemaId":"schema_476"}],"pointer":"/paths/~1tokens/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token"],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token"]}}},{"code":"201","schemaId":"components/schemas/tokens_token_201_response","exampleIds":["paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created"],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_201_response","exampleIds":["paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created"]}}},{"code":"409","schemaId":"components/schemas/tokens_token_409_response","exampleIds":["paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict"],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_409_response","exampleIds":["paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/token/createsecuritytoken"}],"panels":[]}]},"httpPath":"/tokens"},{"label":"Retrieve the detail for this token","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/tokens/v1/openapi/token/getsecuritytoken","routeSlug":"/products/tokens/v1/openapi/token/getsecuritytoken","metadata":{"seo":{"title":"Retrieve the detail for this token","description":"A token representing a payment instrument."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSecurityToken","name":"Retrieve the detail for this token","isWebhook":false,"pointer":"/paths/~1tokens~1{tokenId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve the detail for this token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"A token representing a payment instrument."},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"tokenId","in":"path","schemaId":"schema_477","description":"Access Worldpay encrypted token.","required":true}],"pointer":"/paths/~1tokens~1{tokenId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/tokens/{tokenId}","servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"parameters":{"path":[{"name":"tokenId","in":"path","required":true,"schemaId":"schema_477"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/tokens/{tokenId}","href":"token/getsecuritytoken","openApiOperationId":"getSecurityToken","summary":"Retrieve the detail for this token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The detail for this token.","mediaType":"application/vnd.worldpay.tokens-v1.hal+json","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details."]}},"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details."]}],"pointer":"/paths/~1tokens~1{tokenId}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details."],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeContent":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token_200_response","exampleIds":["paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace.","paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details."]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/token/getsecuritytoken"}],"panels":[]}]},"httpPath":"/tokens/{tokenId}"},{"label":"Update this token","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/tokens/v1/openapi/token/updatesecuritytoken","routeSlug":"/products/tokens/v1/openapi/token/updatesecuritytoken","metadata":{"seo":{"title":"Update this token","description":"Updating different fields represented by the token"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateSecurityToken","name":"Update this token","isWebhook":false,"pointer":"/paths/~1tokens~1{tokenId}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update this token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updating different fields represented by the token"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"tokenId","in":"path","schemaId":"schema_477","description":"Access Worldpay encrypted token.","required":true}],"pointer":"/paths/~1tokens~1{tokenId}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeSchemas":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token","exampleIds":["paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."]}},"schemaId":"components/schemas/tokens_token","exampleIds":["paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."],"pointer":"/paths/~1tokens~1{tokenId}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/tokens/{tokenId}","servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"parameters":{"path":[{"name":"tokenId","in":"path","required":true,"schemaId":"schema_477"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token","exampleIds":["paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."]}},"responseCodes":["204"],"pointer":"/tokens/{tokenId}","href":"token/updatesecuritytoken","openApiOperationId":"updateSecurityToken","summary":"Update this token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"schemaId":"components/schemas/tokens_token","exampleIds":["paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."],"mediaTypes":["application/vnd.worldpay.tokens-v1.hal+json"],"mediaTypeSchemas":{"application/vnd.worldpay.tokens-v1.hal+json":{"schemaId":"components/schemas/tokens_token","exampleIds":["paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.","paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."]}},"examples":[{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The token was successfully updated."}],"pointer":"/paths/~1tokens~1{tokenId}/put/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/token/updatesecuritytoken"}],"panels":[]}]},"httpPath":"/tokens/{tokenId}"},{"label":"Delete this token","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/products/tokens/v1/openapi/token/deletesecuritytoken","routeSlug":"/products/tokens/v1/openapi/token/deletesecuritytoken","metadata":{"seo":{"title":"Delete this token","description":"Deleting a token based on an encrypted tokenId"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteSecurityToken","name":"Delete this token","isWebhook":false,"pointer":"/paths/~1tokens~1{tokenId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete this token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deleting a token based on an encrypted tokenId"},{"nodeType":"security","requirements":[{"schemes":[{"name":"BasicAuth","scopes":[],"type":"http","scheme":"basic"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"tokenId","in":"path","schemaId":"schema_477","description":"Access Worldpay encrypted token.","required":true}],"pointer":"/paths/~1tokens~1{tokenId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/tokens/{tokenId}","servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"parameters":{"path":[{"name":"tokenId","in":"path","required":true,"schemaId":"schema_477"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BasicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["204"],"pointer":"/tokens/{tokenId}","href":"token/deletesecuritytoken","openApiOperationId":"deleteSecurityToken","summary":"Delete this token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"The token was successfully deleted."}],"pointer":"/paths/~1tokens~1{tokenId}/delete/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/token/deletesecuritytoken"}],"panels":[]}]},"httpPath":"/tokens/{tokenId}"}],"content":{"contentType":"group","meta":{"name":"Token"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Token","showPageActions":true},{"nodeType":"markdoc","content":"A token representing a payment instrument."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/tokens","summary":"Create a new token","prefix":{"name":"post","color":"post"},"badges":[],"link":"/token/createsecuritytoken","deprecated":false},{"title":"/tokens/{tokenId}","summary":"Retrieve the detail for this token","prefix":{"name":"get","color":"get"},"badges":[],"link":"/token/getsecuritytoken","deprecated":false},{"title":"/tokens/{tokenId}","summary":"Update this token","prefix":{"name":"put","color":"put"},"badges":[],"link":"/token/updatesecuritytoken","deprecated":false},{"title":"/tokens/{tokenId}","summary":"Delete this token","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/token/deletesecuritytoken","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/tokens_token_200_response":{"id":"components/schemas/tokens_token_200_response","kind":"json-schema","title":"tokens_token_200_response","data":{"required":["tokenPaymentInstrument","description","tokenExpiryDateTime","paymentInstrument","_links"],"type":"object","properties":{"tokenPaymentInstrument":{"type":"object","properties":{"type":{"type":"string"},"href":{"type":"string"}}},"description":{"maxLength":255,"minLength":1,"pattern":"^[^&<]*$","type":"string","description":"A description of your token. If not supplied, a default description is created for you."},"tokenExpiryDateTime":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date/time after which the token is unavailable, expressed in ISO 8601 format. If not supplied, the default expiry date/time is 7 days in Try and 4 years in the Live environment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We extend the expiry by 7 days or 4 years after any use of the token, if under half of the time remains on the token."},"children":[]}]}]}]},"paymentInstrument":{"required":["cardNumber","cardExpiryDate"],"type":"object","properties":{"type":{"type":"string"},"cardNumber":{"maxLength":19,"minLength":10,"pattern":"^[0-9\\*]*$","type":"string","description":"Contains your customer's card number."},"cardExpiryDate":{"required":["month","year"],"type":"object","properties":{"month":{"maximum":12,"minimum":1,"type":"integer"},"year":{"maximum":9999,"type":"integer"}}},"cardHolderName":{"maxLength":255,"minLength":1,"type":"string","description":"The name on the customer's card."},"billingAddress":{"required":["address1","postalCode","city","countryCode"],"type":"object","description":"Contains the billing address information.","properties":{"address1":{"type":"string"},"postalCode":{"type":"string"},"city":{"type":"string"},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"address2":{"type":"string"},"address3":{"type":"string"},"state":{"type":"string"}}},"networkType":{"maxLength":255,"minLength":1,"type":"string"},"last4Digits":{"maxLength":4,"minLength":4,"type":"string"}}},"tokenId":{"maxLength":21,"minLength":15,"pattern":"^[0-9A-HJ-NP-Z]+$","type":"string"},"namespace":{"maxLength":64,"minLength":1,"type":"string"},"schemeTransactionReference":{"maxLength":56,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value provided by Visa or Mastercard which tracks recurring transactions."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You are not normally expected to provide a value for schemeTransactionReference. If you are using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/verified-tokens"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verified Tokens API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create tokens, it is automatically included where applicable."},"children":[]}]}]}]},"_links":{"title":"Links","type":"object","additionalProperties":true}}}},"components/schemas/tokens_token_201_response":{"id":"components/schemas/tokens_token_201_response","kind":"json-schema","title":"tokens_token_201_response","data":{"required":["tokenPaymentInstrument","description","tokenExpiryDateTime","paymentInstrument","_links"],"type":"object","properties":{"tokenPaymentInstrument":{"type":"object","properties":{"type":{"type":"string","description":"Indicating the type of this token."},"href":{"type":"string","description":"Link to the corresponding token."}}},"description":{"maxLength":255,"minLength":1,"pattern":"^[^&<]*$","type":"string","description":"A description of your token. If not supplied, a default description is created for you."},"tokenExpiryDateTime":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date/time after which the token is unavailable, expressed in ISO 8601 format. If not supplied, the default expiry date/time is 7 days in Try and 4 years in the Live environment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We extend the expiry by 7 days or 4 years after any use of the token, if under half of the time remains on the token."},"children":[]}]}]}]},"paymentInstrument":{"required":["cardNumber","cardExpiryDate"],"type":"object","properties":{"cardNumber":{"maxLength":19,"minLength":10,"pattern":"^[0-9\\*]*$","type":"string"},"cardExpiryDate":{"required":["month","year"],"type":"object","properties":{"month":{"maximum":12,"minimum":1,"type":"integer"},"year":{"maximum":9999,"type":"integer"}}},"type":{"type":"string"},"cardHolderName":{"maxLength":255,"minLength":1,"type":"string","description":"The name on the customer's card."},"billingAddress":{"required":["address1","postalCode","city","countryCode"],"type":"object","properties":{"address1":{"type":"string"},"postalCode":{"type":"string"},"city":{"type":"string"},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"address2":{"type":"string"},"address3":{"type":"string"},"state":{"type":"string"}}},"networkType":{"maxLength":255,"minLength":1,"type":"string"},"last4Digits":{"maxLength":4,"minLength":4,"type":"string"}}},"tokenId":{"maxLength":21,"minLength":15,"pattern":"^[0-9A-HJ-NP-Z]+$","description":"Worldpay's internal identifier for a token. If supplied, must be between 15 and 21 characters, must consist of digits and upper-case characters excluding 'I' and 'O'.","type":"string"},"namespace":{"maxLength":64,"minLength":1,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reference by which a client can identify a shopper. If supplied, must be between 1 and 64 characters, must not start with an underscore, must not contain spaces, '&' or '<'."},"children":[]}]}]}]},"schemeTransactionReference":{"maxLength":56,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value provided by Visa or Mastercard which tracks recurring transactions."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You are not normally expected to provide a value for schemeTransactionReference. If you are using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/verified-tokens"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verified Tokens API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create tokens, it is automatically included where applicable."},"children":[]}]}]}]},"_links":{"title":"Links","type":"object","additionalProperties":true}}}},"components/schemas/tokens_token_409_response":{"id":"components/schemas/tokens_token_409_response","kind":"json-schema","title":"tokens_token_409_response","data":{"required":["tokenPaymentInstrument","description","tokenExpiryDateTime","paymentInstrument","_links"],"type":"object","properties":{"tokenPaymentInstrument":{"type":"object","properties":{"type":{"type":"string","description":"Indicating the type of this token."},"href":{"type":"string","description":"Link to the corresponding token."}}},"description":{"maxLength":255,"minLength":1,"pattern":"^[^&<]*$","type":"string","description":"A description of your token. If not supplied, a default description is created for you."},"tokenExpiryDateTime":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date/time after which the token is unavailable, expressed in ISO 8601 format. If not supplied, the default expiry date/time is 7 days in Try and 4 years in the Live environment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We extend the expiry by 7 days or 4 years after any use of the token, if under half of the time remains on the token."},"children":[]}]}]}]},"paymentInstrument":{"required":["cardNumber","cardExpiryDate"],"type":"object","properties":{"cardNumber":{"maxLength":19,"minLength":10,"pattern":"^[0-9\\*]*$","type":"string"},"cardExpiryDate":{"required":["month","year"],"type":"object","properties":{"month":{"maximum":12,"minimum":1,"type":"integer"},"year":{"maximum":9999,"type":"integer"}}},"type":{"type":"string"},"cardHolderName":{"maxLength":255,"minLength":1,"type":"string","description":"The name on the customer's card."},"billingAddress":{"required":["address1","postalCode","city","countryCode"],"type":"object","properties":{"address1":{"type":"string"},"postalCode":{"type":"string"},"city":{"type":"string"},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"address2":{"type":"string"},"address3":{"type":"string"},"state":{"type":"string"}}},"networkType":{"maxLength":255,"minLength":1,"type":"string"},"last4Digits":{"maxLength":4,"minLength":4,"type":"string"},"tokenId":{"type":"string","maxLength":21,"minLength":15,"pattern":"^[0-9A-HJ-NP-Z]+$","description":"Worldpay's internal identifier for a token. If supplied, must be between 15 and 21 characters, must consist of digits and upper-case characters excluding 'I' and 'O'."},"namespace":{"maxLength":64,"minLength":1,"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reference by which a client can identify a shopper. If supplied, must be between 1 and 64 characters, must not start with an underscore, must not contain spaces, '&' or '<'."},"children":[]}]}]}]},"schemeTransactionReference":{"maxLength":56,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value provided by Visa or Mastercard which tracks recurring transactions."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You are not normally expected to provide a value for schemeTransactionReference. If you are using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/verified-tokens"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verified Tokens API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create tokens, it is automatically included where applicable."},"children":[]}]}]}]}}}}}},"components/schemas/token_creation":{"id":"components/schemas/token_creation","kind":"json-schema","title":"token_creation","data":{"type":"object","properties":{"description":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[^&<]*$","description":"A description of your token. If not supplied, a default description is created for you."},"tokenExpiryDateTime":{"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date/time after which the token is unavailable, expressed in ISO 8601 format. If not supplied, the default expiry date/time is 7 days in Try and 4 years in the Live environment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We extend the expiry by 7 days or 4 years after any use of the token, if under half of the time remains on the token."},"children":[]}]}]}]},"namespace":{"type":"string","minLength":1,"maxLength":64,"description":"A namespace is used to group up to 16 cards, e.g. for one customer. A card can exist in more than one namespace."},"schemeTransactionReference":{"maxLength":56,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value provided by Visa or Mastercard which tracks recurring transactions."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You are not normally expected to provide a value for schemeTransactionReference. If you are using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/verified-tokens"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verified Tokens API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create tokens, it is automatically included where applicable."},"children":[]}]}]}],"type":"string"},"paymentInstrument":{"type":"object","description":"An object that contains the payment type and details. All sub-fields are mandatory with the exception of billingAddress (see below).","properties":{"type":{"type":"string","description":"card/front"},"cardHolderName":{"type":"string","maxLength":255,"minLength":1,"description":"The name on the customer's card."},"cardExpiryDate":{"required":["month","year"],"type":"object","properties":{"month":{"type":"integer","maximum":12,"minimum":1},"year":{"type":"integer","maximum":9999,"minimum":1}}},"cardNumber":{"type":"string","maxLength":19,"minLength":10,"pattern":"^[0-9]*$","description":"Contains your customer's card number."},"billingAddress":{"required":["address1","postalCode","city","countryCode"],"type":"object","description":"Contains the billing address information.","properties":{"address1":{"type":"string","maxLength":80,"minLength":1},"postalCode":{"type":"string","maxLength":15,"minLength":1},"city":{"type":"string","maxLength":50,"minLength":1},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"address2":{"maxLength":80,"type":"string"},"address3":{"maxLength":80,"type":"string"},"state":{"type":"string","maxLength":30,"minLength":1}}}}},"merchant":{"type":"object","description":"An object that contains information about your merchant account."}},"required":["paymentInstrument","merchant"]}},"components/schemas/tokens_token":{"id":"components/schemas/tokens_token","kind":"json-schema","title":"tokens_token","data":{"type":"object","properties":{"schemeTransactionReference":{"maxLength":56,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value provided by Visa or Mastercard which tracks recurring transactions."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"b","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" You are not normally expected to provide a value for schemeTransactionReference. If you are using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/products/verified-tokens"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verified Tokens API"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to create tokens, it is automatically included where applicable."},"children":[]}]}]}]},"cardHolderName":{"maxLength":255,"minLength":1,"type":"string","description":"The name on the customer's card."},"description":{"maxLength":255,"minLength":1,"pattern":"^[^&<]*$","type":"string","description":"A description of your token. If not supplied, a default description is created for you."},"month":{"type":"integer","maximum":12,"minimum":1},"year":{"maximum":9999,"type":"integer"},"address1":{"type":"string"},"address2":{"type":"string"},"address3":{"type":"string"},"postalCode":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"}}}},"schema_475":{"kind":"json-schema","data":{"type":"object","properties":{"Accept":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]},"Content-Type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]},"Location":{"type":"string","format":"uri","description":"A URI identifying the created token resource."}}},"id":"schema_475"},"schema_476":{"kind":"json-schema","data":{"type":"object","properties":{"Accept":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]},"Content-Type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"application/vnd.worldpay.tokens-v1.hal+json"},"children":[]}]}]}]},"Location":{"type":"string","format":"uri","description":"A URI identifying the conflicting token resource."}}},"id":"schema_476"},"schema_477":{"kind":"json-schema","data":{"type":"string"},"id":"schema_477"}},"exampleStore":{"paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token":{"value":{"paymentInstrument":{"type":"card/front","cardNumber":"4444333322221111","cardExpiryDate":{"month":1,"year":2025},"cardHolderName":"Testy McTester"},"merchant":{"entity":"default"}},"key":"Creating a Token","summary":"Creating a Token","description":"Creating a token from payment instrument","id":"paths/~1tokens/post/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a Token"},"paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokenId":"9902480679618049603","description":"Test Token Description","tokenExpiryDateTime":"2021-06-24T09:19:35Z","paymentInstrument":{"type":"card/masked","cardNumber":"4444********1111","cardHolderName":"Sherlock Holmes","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"221B Baker Street","address2":"Marylebone","address3":"Westminster","postalCode":"NW1 6XE","city":"London","state":"Greater London","countryCode":"GB"}},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0MWJVbkh1WTFGZExUNXJxc04va1ZoTFVzYW1OU1lxSFE2NHI1c2JkY1pWaSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdjFnVXlzakdPSXdWWkRhZkZyUmlMd3c9PSJ9"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdkVpVW5GNnBsZThNTXNQWTRGbzFzTXc9PSJ9"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdFpSdXFxbWZlNVl1TkpHZEVvZXN3MTlCU0lmdCtxSTUyVDJSdXlmSTIwM3c9PSJ9"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiSENXWFZQZjNIZ1V3dnpDMElJZS9Zdmc4M0pYM3dDWEJTVnQrWVlacXdDUXFFKzhzaC8xNSs2d3NkTTdFWUFNVU9tdXBmUlZGeVNDY2dPMkhKV2NIcGc9PSJ9"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Creating a token","summary":"Creating a token","description":"A 200 OK response means that you've already tokenized the card and that all data supplied in your create a token request matches the data stored with Access Worldpay.\n\n Sometimes, a token can be matched even if the data isn't quite the same. For example, if Access Worldpay has a billingAddress on file, the existing billingAddress is retained if no billingAddress was supplied in your request. Additionally, you receive the 200 OK response code.\n\n The existing token resource reference is returned in the tokenPaymentInstrument object.","id":"paths/~1tokens/post/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Creating a token"},"paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokenId":"9902480679618049603","description":"Test Token Description","tokenExpiryDateTime":"2021-06-24T09:19:35Z","paymentInstrument":{"type":"card/masked","cardNumber":"4444********1111","cardHolderName":"Sherlock Holmes","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"221B Baker Street","address2":"Marylebone","address3":"Westminster","postalCode":"NW1 6XE","city":"London","state":"Greater London","countryCode":"GB"},"countryCode":"GB"},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0MWJVbkh1WTFGZExUNXJxc04va1ZoTFVzYW1OU1lxSFE2NHI1c2JkY1pWaSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdjFnVXlzakdPSXdWWkRhZkZyUmlMd3c9PSJ9"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdkVpVW5GNnBsZThNTXNQWTRGbzFzTXc9PSJ9"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdFpSdXFxbWZlNVl1TkpHZEVvZXN3MTlCU0lmdCtxSTUyVDJSdXlmSTIwM3c9PSJ9"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiSENXWFZQZjNIZ1V3dnpDMElJZS9Zdmc4M0pYM3dDWEJTVnQrWVlacXdDUXFFKzhzaC8xNSs2d3NkTTdFWUFNVU9tdXBmUlZGeVNDY2dPMkhKV2NIcGc9PSJ9"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Token Created","summary":"Token Created","description":"If this is the first time you've tokenized the card, a 201 Created response is returned.\n\n Your response contains a tokenPaymentInstrument object which contains the href to the token resource. The response also includes next available action links, e.g. updating and deleting the token.","id":"paths/~1tokens/post/responses/201/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Token Created"},"paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokenId":"9902480679618049603","description":"Test Token Description","tokenExpiryDateTime":"2021-06-24T09:19:35Z","paymentInstrument":{"type":"card/masked","cardNumber":"4444********1111","cardHolderName":"Sherlock Holmes","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"221B Baker Street","address2":"Marylebone","address3":"Westminster","postalCode":"NW1 6XE","city":"London","state":"Greater London","countryCode":"GB"}},"conflicts":{"paymentInstrument":{"cardHolderName":"Sherlock Holmes"},"conflictsExpiryDateTime":"2019-06-24T09:49:35Z"},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0NzI0NE1rdUtjMUFJdjYxVnlibWZuUT0ifQ"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0MWJVbkh1WTFGZExUNXJxc04va1ZoTFVzYW1OU1lxSFE2NHI1c2JkY1pWaSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdjFnVXlzakdPSXdWWkRhZkZyUmlMd3c9PSJ9"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdUpLN2N3VVc5WUk3czRUTW1RQ2JLdkVpVW5GNnBsZThNTXNQWTRGbzFzTXc9PSJ9"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0d3ltd21ieGo3TlZLYzRYSkExOUhSdFpSdXFxbWZlNVl1TkpHZEVvZXN3MTlCU0lmdCtxSTUyVDJSdXlmSTIwM3c9PSJ9"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoiSENXWFZQZjNIZ1V3dnpDMElJZS9Zdmc4M0pYM3dDWEJTVnQrWVlacXdDUXFFKzhzaC8xNSs2d3NkTTdFWUFNVU9tdXBmUlZGeVNDY2dPMkhKV2NIcGc9PSJ9"},"tokens:conflicts":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoialRBL0FFelBzcnZpNCtzRGNRemh0ODUrN2hvZ0cyK1JvQ3JKdUtFZnU5UTFsdTdwODVHTUcwYy92VW02MDlJd2pHQllvcW0zanhWQ3p3Zk9OUW9CYUZtQ1hNbFhwM3lhSXlkYVlNYWJnQUdQUHFpRVAxVXVpZHM2Y2tvTjEvOGNJdFQ0WkVlVEJIVWF6T1dlWTlQMkpnPT0ifQ"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Conflict","summary":"Conflict","description":"A 409 Conflict response means that you've already tokenized the card, but some of the data supplied in your create a token request is different from the data in the existing token.\n\n This conflict could be caused by a differentiation in the cardHolderName, card expiry month, card expiry year billingAddress or schemeTransactionReference (see note below) fields.\n\n In this case, the data that we have on file is retained. The data which caused the conflict is returned in a conflicts object. If you would like to resolve the conflict, you can update the existing token using the tokens:conflicts action link returned in the response.","id":"paths/~1tokens/post/responses/409/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Conflict"},"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token.":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ"},"tokenId":"9925760692793807595","description":"Token Description","tokenExpiryDateTime":"2025-01-23T10:57:01Z","paymentInstrument":{"type":"card/masked","cardNumber":"4444********1111","cardHolderName":"Card Holder Name","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"Address 1","address2":"Address 2","address3":"Address 3","postalCode":"Postal Code","city":"City","state":"State","countryCode":"XX"}},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXdW9oYzR3RUFEM2FCQnlaejhsZ1poTFVzYW1OU1lxSFE2NHI1c2JkY1pWaSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXT0pLN2N3VVc5WUk3czRUTW1RQ2JLdjFnVXlzakdPSXdWWkRhZkZyUmlMd3c9PSJ9"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXT0pLN2N3VVc5WUk3czRUTW1RQ2JLdkVpVW5GNnBsZThNTXNQWTRGbzFzTXc9PSJ9"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXTlpSdXFxbWZlNVl1TkpHZEVvZXN3MTlCU0lmdCtxSTUyVDJSdXlmSTIwM3c9PSJ9"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXc2w4WnRHSGdzblFZd2Y4ZU1hLzhXTThZcVl5OWJFUHNnbzNpTHd1NlpJSTJxUUNRVXZybWJpRkdyQ0NNQ0g0ZlpsNlBnc1NkL0h5VkRCKyt0Ym9wMGs9In0"},"tokens:networkToken":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/network"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Retrieve details about a token.","summary":"Retrieve details about a token.","description":"Retrieve details about a token.","id":"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token."},"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace.":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abnZtYjM3RXppMy84N2J6ZWlXYkhyUiJ9"},"tokenId":"9925760692793807595","description":"Token Description","tokenExpiryDateTime":"2025-01-23T10:57:01Z","namespace":"my-authenticated-shopper","paymentInstrument":{"type":"card/masked","cardNumber":"4444********1111","cardHolderName":"Card Holder Name","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"Address 1","address2":"Address 2","address3":"Address 3","postalCode":"Postal Code","city":"City","state":"State","countryCode":"XX"}},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abnZtYjM3RXppMy84N2J6ZWlXYkhyUiJ9"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abXlBdGFNaFRIdE1Oc2lybUZQeWFWOTFMR3BqVW1LaDBPdUsrYkczWEdWWWc9PSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSWlTdTNNRkZ2V0NPN09FekprQW15cjlZRk1ySXhqaU1GV1EybnhhMFlpOE09In0"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSWlTdTNNRkZ2V0NPN09FekprQW15cnhJbEp4ZXFaWHZERExEMk9CYU5iRE09In0"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSVdVYnFxcG4zdVdMalNSblJLSHJNTmZRVWlIN2ZxaU9kazlrYnNueU50Tjg9In0"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSVBHS21Ndld4RDdJS040aThMdW1TQ05xa0FrRkw2NW00aFJxd2dqQWgrSDJaZWo0TEVuZng4bFF3ZnZyVzZLZEoifQ"},"tokens:networkToken":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/network"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Retrieve details about a token with a namespace.","summary":"Retrieve details about a token with a namespace.","description":"Retrieve details about a token with a namespace.","id":"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve details about a token with a namespace."},"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details.":{"value":{"tokenPaymentInstrument":{"type":"card/tokenized","href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abnZtYjM3RXppMy84N2J6ZWlXYkhyUiJ9"},"tokenId":"9925760692793807595","description":"Token Description","tokenExpiryDateTime":"2025-01-23T10:57:01Z","namespace":"my-authenticated-shopper","paymentInstrument":{"type":"card/front","cardNumber":"4444333322221111","cardHolderName":"Card Holder Name","cardExpiryDate":{"month":5,"year":2035},"billingAddress":{"address1":"Address 1","address2":"Address 2","address3":"Address 3","postalCode":"Postal Code","city":"City","state":"State","countryCode":"XX"}},"_links":{"tokens:token":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abnZtYjM3RXppMy84N2J6ZWlXYkhyUiJ9"},"tokens:description":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abXlBdGFNaFRIdE1Oc2lybUZQeWFWOTFMR3BqVW1LaDBPdUsrYkczWEdWWWc9PSJ9"},"tokens:cardHolderName":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSWlTdTNNRkZ2V0NPN09FekprQW15cjlZRk1ySXhqaU1GV1EybnhhMFlpOE09In0"},"tokens:cardExpiryDate":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSWlTdTNNRkZ2V0NPN09FekprQW15cnhJbEp4ZXFaWHZERExEMk9CYU5iRE09In0"},"tokens:billingAddress":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSVdVYnFxcG4zdVdMalNSblJLSHJNTmZRVWlIN2ZxaU9kazlrYnNueU50Tjg9In0"},"tokens:schemeTransactionReference":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXaGdPVU5iVmZ0Rm5TUDZuK3N1Mm5abGFqUW1IQ2k5NWk0SEx3U0JrYWdHSVBHS21Ndld4RDdJS040aThMdW1TQ05xa0FrRkw2NW00aFJxd2dqQWgrSDJaZWo0TEVuZng4bFF3ZnZyVzZLZEoifQ"},"tokens:networkToken":{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/tokens/network"},"curies":[{"href":"https://try.access.worldpay-bsh.securedataplatform.co.uk/rels/tokens/{rel}.json","name":"tokens","templated":true}]}},"key":"Retrieve detokenized card details.","summary":"Retrieve detokenized card details.","description":"Retrieve all card details detokenized.","id":"paths/~1tokens~1{tokenId}/get/responses/200/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Retrieve detokenized card details."},"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address.":{"value":"{ \"address1\": \"1 Test Street\", \"address2\": \"Address line 2\", \"address3\": \"Address line 3\", \"postalCode\": \"TE12 34ST\", \"city\": \"Testville\", \"state\": \"Testshire\", \"countryCode\": \"TS\" }","key":"Update a billing address.","summary":"Update a billing address.","description":"Update a billing address.","id":"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a billing address."},"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date.":{"value":"{ \"month\": 1, \"year\": 2050 }","key":"Update a card expiry date.","summary":"Update a card expiry date.","description":"Update a card expiry date.","id":"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card expiry date."},"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name.":{"value":"\"new name\"","key":"Update a card holder name.","summary":"Update a card holder name.","description":"Update a card holder name.","id":"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a card holder name."},"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description.":{"value":"\"new description\"","key":"Update a token description.","summary":"Update a token description.","description":"Update a token description.","id":"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a token description."},"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token.":{"value":"\"000000000000020005060720116005060\"","key":"Update a scheme transaction reference for a token.","summary":"Update a scheme transaction reference for a token.","description":"Update a scheme transaction reference for a token.","id":"paths/~1tokens~1{tokenId}/put/requestBody/content/application~1vnd.worldpay.tokens-v1.hal+json/examples/Update a scheme transaction reference for a token."}},"securitySchemeStore":{"BasicAuth":{"id":"BasicAuth","type":"http","scheme":"basic"}},"servers":[{"url":"https://try.access.worldpay-bsh.securedataplatform.co.uk","description":"Test (Try)"},{"url":"https://access.worldpay-bsh.securedataplatform.co.uk","description":"Live"}],"specType":"openapi"},"options":{"jsonSamplesExpandLevel":7,"schemasExpansionLevel":1,"hideSchemaTitles":true,"hidePropertiesPrefix":true,"hideInfoMetadata":true,"codeSamples":{"languages":[{"lang":"Payload"},{"lang":"curl"},{"lang":"Python"},{"lang":"Java"},{"lang":"Node.js"},{"lang":"Go"},{"lang":"PHP"},{"lang":"Ruby"},{"lang":"C#"}]},"feedback":{"type":"sentiment","settings":{"label":"Do you like our page?","submitText":"Thanks for your feedback","comment":{"likeLabel":"What was most helpful?","dislikeLabel":"What can we improve?"}}},"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/access/_bundle/products/tokens/@v1/openapi.json?download"},{"url":"/access/_bundle/products/tokens/@v1/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Tokens","description":"Minimize the exposure of sensitive card details and increase the security of your customer's card details. \n\n__Authentication header__\n\n  ```\n    Authorization: {your_credentials}\n  ```\n  Replace `{your_credentials}` with your base64-encoded Basic Auth username and password given to you by your Worldpay Implementation Manager.\n  <br /> <br />\n  You **must** use the `Authorization` header for any request you send to our Tokens API.\n  <br /><br />\n  __Accept & Content-Type headers__\n  ```\n    Accept: application/vnd.worldpay.tokens-v1.hal+json\n    Content-Type: application/vnd.worldpay.tokens-v1.hal+json\n  ```\n\nWe use the Accept header to identify which version of our API you are using. You must use the Accept header for any request you send to our Tokens API. \n<br><br>\nFor detokenization requests, adapt the Accept header to also pass masked = false, as follows: `Accept:` `'application/vnd.worldpay.tokens-v1.hal+json; masked=false'`<br>\n{% admonition type=\"warning\" name=\"Important\" %}Detokenizing exposes your business to high levels of PCI auditing, required to remain PCI compliant.{% /admonition %}    \nWe require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a POST or a PUT.\n<br /><br />\n__DNS whitelisting__\n\nWhitelist the following URLs:\n* `https://try.access.worldpay-bsh.securedataplatform.co.uk/`\n* `https://access.worldpay-bsh.securedataplatform.co.uk/`\n\nPlease ensure you use DNS whitelisting, not explicit IP whitelisting. When you make a request within Access Worldpay, you should always cache the response returned."}},"baseSlug":"/products/tokens/v1/openapi","routesMapping":{}}