ValidatePIN

Validate the PIN.

Request

Path parameters

terminalID

string,  10 characters,  required

The Paymentology issued terminal ID of the terminal requesting the transaction

reference

string,  1-255 characters,  required

The reference of the wallet for which validation must take place

PINBlock

string,  1-10 characters,  required

The triple DES encrypted PIN to validate the transaction

transactionID

string,  1-255 characters,  required

Transaction ID number generated by the calling client. Note that the Transaction ID is not a unique value and may be duplicated over time.

transactionDate

date,  required

Transaction date generated by the calling client

checksum

string,  required

HMAC-SHA256 hashed signature of the concatenated method name with all argument values using the terminal password as private key

"<methodCall>
    <methodName>ValidatePIN</methodName>
    <params>
        <param>
            <value>
                <string>0014682067</string>
            </value>
        </param>
        <param>
            <value>
                <string>TEST123</string>
            </value>
        </param>
        <param>
            <value>
                <string>D45201B9E3136796</string>
            </value>
        </param>
        <param>
            <value>
                <string>1262563963</string>
            </value>
        </param>
        <param>
            <value>
                <dateTime.iso8601>20200315T12:35:09</dateTime.iso8601>
            </value>
        </param>
        <param>
            <value>
                <string>9D41AF94DCE3A2BE76E3F8F0FDC7C3596A257BBB</string>
            </value>
        </param>
    </params>
</methodCall>"

 

Response

STATUS200 OK

Schema

resultCode

integer

Status code indicating transaction result

<?xml version=""1.0"" encoding=""UTF-8""?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>resultCode</name>
              <value>
                <int>1</int>
              </value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>

 

Was this page helpful?

Are you ready to use our APIs

If you are not yet registered with us.

Still have questions? Contact us.