Request Parameters

Purpose

These values are used to submit the individual data elements for each message request. This structure differs between the XML and Value-Pair formats.

Each parameter should be comprised using of one of the following data formats as defined in the glossary definition of each field:

  • Numeric - (0-9)

  • Alpha - (Lower ASCII set excluding control characters)

  • Hex - (Alphanumeric Representation of a Hex Character 0-9 or A-F)

XML Format

Syntax:

<Block ID="xx">

    <Parameter_Name>{Parameter Value}</Parameter_Name>

<Block ID>

 

Example:

<Block id="HD">

    <Application_ID>HZ9999GC</Application_ID>

    <Terminal_ID>1234567890123456789012</Terminal_ID>

    <Device_Tag>123456</Device_Tag>

</Block>

<Block id="01">

    <POS_Entry_Capability>02</POS_Entry_Capability>

    <Account_Entry_Mode>01</Account_Entry_Mode>

    <Partial_Auth_Indicator>0</Partial_Auth_Indicator>

    <Account_Data>400000******0002=1230</Account_Data>

    <Transaction_Amount>1000</Transaction_Amount>

    <Last_Record_Number>1</Last_Record_Number>

</Block>

<Block id="10">

        <Postal_ZIP_Code>30328</Postal_ZIP_Code>

</Block>

Value-Pair Format

Syntax:

{Block.Parmeter}={Value}

Example:

HD.Application_ID=HZ9999GC&

HD.Terminal_ID=1234567890123456789012&

HD.Device_Tag=123456&

01.POS_Entry_Capability=02&

01.Account_Entry_Mode=01&

01.Partial_Auth_Indicator=0&

01.Account_Data=400000******0002=1230&

01.Transaction_Amount=1000

01.Last_Record_Number=1

10.Postal_ZIP_Code=30328

error_outline
note

The XML examples above have been formatted for human readability and are returned as a continuous stream of data.  Sensitive data in each example was also masked.