Administrative Message

POST https://example.com/administrative-3ds

Administrative Message – 3D Secure OTP

Sends message with 3D Secure OTP

KLV data – ‘3D Secure OTP’ = 900.

Only if the 3DS validation option is ‘SMS OTP’:

‘Original transaction amount ’ = 004, ‘merchant description’ = 043, original currency code ’ = 049.

KLV data – ‘3D Secure OTP RefCode’ = 934.

For more information on KLV data, click KLV Format

REQUEST

PATH PARAMETERS

Parameter	Type & Constraints	Description
terminalID	string (10 characters), required	Our partner issued terminal ID of the terminal requesting the transaction
reference	string (1-255 characters), required	The reference of the wallet the 3DS authentication is being actioned on
messageName	string (0-2048 characters), required	The name of the administrative message being sent
messageData	string (0-2048 characters), required	The administrative message data sent over in a KLV Format
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

  <?xml version="1.0"?>
  <methodCall>
    <methodName>AdministrativeMessage</methodName>
    <params>
      <param><value><string>0048149752</string></value></param>
      <param><value><string>32446085</string></value></param>
      <param><value><string>3DSecureOTP</string></value></param>
      <param><value><string>4603253853400000093700404180004305test10490384090006726326</string></value></param>
      <param><value><string>460325381</string></value></param>
      <param><value><dateTime.iso8601>20210401T14:12:22</dateTime.iso8601></value></param>
      <param><value><string>69291805E1C24E5A3ABEF5A7E0104D1E31324F4E</string></value></param>
    </params>
  </methodCall>

RESPONSE

STATUS 200 OK

SCHEMA

Field	Type	Description
resultCode	integer	Status code indicating transaction result

  <methodResponse>
    <params>
      <param>
        <value>
          <struct>
            <member>
              <name>resultCode</name>
              <value><int>1</int></value>
            </member>
          </struct>
        </value>
      </param>
    </params>
  </methodResponse>