PinBlock GetPinBlock (string mode, string pan, string pin)
Description |
|
|
Generate a PIN Block using the HSM (Hardware Security Module) |
Returns |
|
|
PinBlock data structure containing the following fields:
• ResultStatusCode • ResultDescription • DeviceSerialNumber • DeviceMake • KeySerialNumber • PinBlock
ResultStatusCode see Status Codes used by V_XML ResultDescription see Descriptions used by V_XML |
Client Certificate |
|
|
not required |
|
|
Parameters |
|
mode : string |
"test"
"live" |
|
|
pan : string |
Primary Account Number |
pin : string |
|
Additional |
|
Validation Performed |
• pan length is not less than 13 chracters and not more than 19 characters • pan is also validated against the LUHN Formula • pin length is not less than 4 characters and not more than 14 characters |
GetPinBlock SOAP message
Request |
Response |
POST /iVeriWebService/Service.asmx Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://iveri.com/GetPinBlock"
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetPinBlock xmlns="http://iveri.com/"> <mode>string</mode> <pan>string</pan> <pin>string</pin> </GetPinBlock> </soap:Body> </soap:Envelope>
|
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <GetPinBlockResponse xmlns="http://iveri.com/"> <GetPinBlockResult> <ResultStatusCode>int</ResultStatusCode> <ResultDescription>string</ResultDescription> <DeviceSerialNumber>string</DeviceSerialNumber> <DeviceMake>string</DeviceMake> <KeySerialNumber>string</KeySerialNumber> <PinBlock>string</PinBlock> </GetPinBlockResult> </GetPinBlockResponse> </soap:Body> </soap:Envelope>
|