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

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 also has been masked.