Skip to main content

Search

Sign in

PinBlock GetPinBlock

  • Updated

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 Notes:

Validation Performed
  • pan length is not less than 13 characters 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

General Notes
  • Method formatted as a SOAP Request and Response

 

SOAP Request

POST /iVeriWebService/Service.asmx HTTP/1.1

Host: portal.nedsecure.co.za

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> 

SOAP Response

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>