{"_id":"59cae0614ab7b70024378e9a","project":"55b933b3146ef121002158d3","version":{"_id":"5632a5e549e16d0d00122443","__v":6,"project":"55b933b3146ef121002158d3","createdAt":"2015-10-29T23:04:05.701Z","releaseDate":"2015-10-29T23:04:05.701Z","categories":["5632a5e749e16d0d00122444","5632a5e749e16d0d00122445","5632a5e749e16d0d00122446","5632a5e749e16d0d00122447","5632a5e749e16d0d00122448","5632a5e749e16d0d00122449","5632a5e749e16d0d0012244a","5632a5e749e16d0d0012244b","5632a5e749e16d0d0012244c","5632a5e749e16d0d0012244d","5632a5e749e16d0d0012244e","5632a5e749e16d0d0012244f","5632a5e749e16d0d00122450","5632b179df556c0d00cd095b","564e13053b2b4a19000cd69b","59caa9df65accc001a489c95","59cab50965accc001a489d28","59cadd464ab7b70024378e74"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"category":{"_id":"59cab50965accc001a489d28","project":"55b933b3146ef121002158d3","version":"5632a5e549e16d0d00122443","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-26T20:14:01.669Z","from_sync":false,"order":8,"slug":"tokenization","title":"Tokenization"},"user":"55b932ba8fd1a02b00f496c8","githubsync":"","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-26T23:18:57.753Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:api-header]\n{\n  \"title\": \"Description\"\n}\n[/block]\nTypically when generating a card token, the end user is presented with a browser form by the gateway. Once the user completes the form, the user is redirected back to the developers software with the generated token. In scenarios where the developers software is not able to handle a browser redirection (or javascript hook), the developer can use the lookupCardToken method to retrieve the token after the fact.\n\nTo implement this method of retrieving the token, the developer must generate a random lookup key. When presenting the tokenization form this random lookup key should be set in the UMcardLookup variable. The same card lookup value should then be passed to the lookupCardToken method in the Lookup parameter.\n\nIf the lookup value matches multiple tokens, the most recent one will be returned. The lookupCardToken method will only match tokens created under the same merchant account.\n[block:api-header]\n{\n  \"title\": \"Syntax\"\n}\n[/block]\n[CreditCardToken](doc:creditcardtoken)   lookupCardToken ( [ueSecurityToken](doc:uesecuritytoken) \n Token, string Lookup )\n[block:api-header]\n{\n  \"title\": \"Arguments\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Type\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"[ueSecurityToken](doc:uesecuritytoken)\",\n    \"0-1\": \"Token\",\n    \"0-2\": \"Merchant security token: used to identify merchant and validate transaction.\",\n    \"1-0\": \"string\",\n    \"1-1\": \"Lookup\",\n    \"1-2\": \"Lookup key that was assigned during the token creation\"\n  },\n  \"cols\": 3,\n  \"rows\": 2\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Return Value\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"[CreditCardToken](doc:creditcardtoken)\",\n    \"0-1\": \"Returns object containing card token data (including card ref)\"\n  },\n  \"cols\": 2,\n  \"rows\": 1\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Examples\"\n}\n[/block]\nPHP\nFor directions on how to set up the WSDL link, create “$token” and “$client”, go to [PHP Guide](doc:php-guide) \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?php \\n \\ntry { \\n \\n  $Lookup = \\\"vu8ls884kys7674s\\\";\\n  $token=$client->lookupCardToken($token, $Lookup); \\n \\n} \\n \\ncatch (SoapFault $e) { \\n  die(\\\"lookupCardToken failed :\\\" .$e->getMessage()); \\n} \\n \\n?>\",\n      \"language\": \"php\"\n    }\n  ]\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\"?> \\n   <SOAP-ENV:Envelope xmlns:SOAP-ENV=\\\"http://schemas.xmlsoap.org/soap/envelope/\\\" xmlns:ns1=\\\"urn:usaepay\\\" xmlns:xsd=\\\"http://www.w3.org/2001/XMLSchema\\\" xmlns:xsi=\\\"http://www.w3.org/2001/XMLSchema-instance\\\" xmlns:SOAP-ENC=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\" SOAP-ENV:encodingStyle=\\\"http://schemas.xmlsoap.org/soap/encoding/\\\">\\n      <SOAP-ENV:Body>\\n         <ns1:lookupCardToken>\\n            <Token xsi:type=\\\"ns1:ueSecurityToken\\\">\\n               <ClientIP xsi:type=\\\"xsd:string\\\">192.168.0.1</ClientIP>\\n               <PinHash xsi:type=\\\"ns1:ueHash\\\">\\n                  <HashValue xsi:type=\\\"xsd:string\\\">f2f5838082462468fc9ab65cffde0c112c34870d</HashValue>\\n                  <Seed xsi:type=\\\"xsd:string\\\">13430765681990835866</Seed>\\n                  <Type xsi:type=\\\"xsd:string\\\">sha1</Type>\\n               </PinHash>\\n               <SourceKey xsi:type=\\\"xsd:string\\\">_Ss7g8t6UW9b1Py6474F5Z1A8fmo22x2</SourceKey>\\n            </Token>\\n            <Lookup xsi:type=\\\"xsd:string\\\">19217415721343076568.727</Lookup>\\n         </ns1:lookupCardToken>\\n      </SOAP-ENV:Body>\\n   </SOAP-ENV:Envelope>\",\n      \"language\": \"xml\"\n    }\n  ]\n}\n[/block]","excerpt":"Retrieve a card reference token by a developer assigned lookup key","slug":"lookupcardtoken","type":"basic","title":"lookupCardToken"}

lookupCardToken

Retrieve a card reference token by a developer assigned lookup key

[block:api-header] { "title": "Description" } [/block] Typically when generating a card token, the end user is presented with a browser form by the gateway. Once the user completes the form, the user is redirected back to the developers software with the generated token. In scenarios where the developers software is not able to handle a browser redirection (or javascript hook), the developer can use the lookupCardToken method to retrieve the token after the fact. To implement this method of retrieving the token, the developer must generate a random lookup key. When presenting the tokenization form this random lookup key should be set in the UMcardLookup variable. The same card lookup value should then be passed to the lookupCardToken method in the Lookup parameter. If the lookup value matches multiple tokens, the most recent one will be returned. The lookupCardToken method will only match tokens created under the same merchant account. [block:api-header] { "title": "Syntax" } [/block] [CreditCardToken](doc:creditcardtoken) lookupCardToken ( [ueSecurityToken](doc:uesecuritytoken) Token, string Lookup ) [block:api-header] { "title": "Arguments" } [/block] [block:parameters] { "data": { "h-0": "Type", "h-1": "Name", "h-2": "Description", "0-0": "[ueSecurityToken](doc:uesecuritytoken)", "0-1": "Token", "0-2": "Merchant security token: used to identify merchant and validate transaction.", "1-0": "string", "1-1": "Lookup", "1-2": "Lookup key that was assigned during the token creation" }, "cols": 3, "rows": 2 } [/block] [block:api-header] { "title": "Return Value" } [/block] [block:parameters] { "data": { "0-0": "[CreditCardToken](doc:creditcardtoken)", "0-1": "Returns object containing card token data (including card ref)" }, "cols": 2, "rows": 1 } [/block] [block:api-header] { "title": "Examples" } [/block] PHP For directions on how to set up the WSDL link, create “$token” and “$client”, go to [PHP Guide](doc:php-guide) [block:code] { "codes": [ { "code": "<?php \n \ntry { \n \n $Lookup = \"vu8ls884kys7674s\";\n $token=$client->lookupCardToken($token, $Lookup); \n \n} \n \ncatch (SoapFault $e) { \n die(\"lookupCardToken failed :\" .$e->getMessage()); \n} \n \n?>", "language": "php" } ] } [/block] [block:code] { "codes": [ { "code": "<?xml version=\"1.0\" encoding=\"UTF-8\"?> \n <SOAP-ENV:Envelope xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:ns1=\"urn:usaepay\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns:SOAP-ENC=\"http://schemas.xmlsoap.org/soap/encoding/\" SOAP-ENV:encodingStyle=\"http://schemas.xmlsoap.org/soap/encoding/\">\n <SOAP-ENV:Body>\n <ns1:lookupCardToken>\n <Token xsi:type=\"ns1:ueSecurityToken\">\n <ClientIP xsi:type=\"xsd:string\">192.168.0.1</ClientIP>\n <PinHash xsi:type=\"ns1:ueHash\">\n <HashValue xsi:type=\"xsd:string\">f2f5838082462468fc9ab65cffde0c112c34870d</HashValue>\n <Seed xsi:type=\"xsd:string\">13430765681990835866</Seed>\n <Type xsi:type=\"xsd:string\">sha1</Type>\n </PinHash>\n <SourceKey xsi:type=\"xsd:string\">_Ss7g8t6UW9b1Py6474F5Z1A8fmo22x2</SourceKey>\n </Token>\n <Lookup xsi:type=\"xsd:string\">19217415721343076568.727</Lookup>\n </ns1:lookupCardToken>\n </SOAP-ENV:Body>\n </SOAP-ENV:Envelope>", "language": "xml" } ] } [/block]