Tag 071 - Scrolling Text with Virtual Buttons

Simplify supports a Scrolling Text with Virtual Buttons Message. The Request displays a screen with scrolling text plus virtual buttons at the bottom of the screen. This message can be used to display a Consent screen.

Scrolling text -- Up to 100 lines of scrolling text can be defined. Font size and justification are defined in the request. The maximum number of characters per line depends on the font size and device.

Buttons -- Up to two virtual buttons can be defined. The maximum length of the button descriptors depends on the font size and device.

One field in the Response (ActionButton) indicates which action button or key was pressed (Cancel, Virtual button 1, Virtual button 2) was pressed. Another field (Data) indicates the virtual button selected by the customer (if any).

Field 5001 Format

Request

Field Name Length Description
TTT 3 Tag (always = 071)
LLL 3 Length of the following data
ButtonSize 1 Font size of virtual buttons (0=extra small to 6=extra large)
FS 1 Field separator (Hex 1C)
VirtualButton1 Var. Virtual button1 text (left justified).
FS 1 Field separator (Hex 1C)
VirtualButton2 Var. Virtual button2 text (left justified)
FS 1 Field separator (Hex 1C)
InfoFontSize 1 Font size for Info fields (0=extra small to 6=extra large)
FS 1 Field separator
InfoJust 1 Justification for all Information fields (1=Left justify, 2=Center, 3=Right justify)
FS 1 Field separator (Hex 1C)
Info1 Var. Text for Information 1 (left justified)
FS 1 Field separator (Hex 1C)
Info2 Var. Text for Information 2
FS 1 Field separator
Info3 Var. Text for Information 3
FS 1 Field separator
Info4 Var. Text for Information 4
FS 1 Field separator
Info5 Var. Text for Information 5
FS 1 Field separator
Info6 Var. Text for Information 6
FS 1 Field separator
.
Info100 Var. Text for Information 100

Response

Field Name Length Description
TTT 8 Tag (always = 071 )
LLL 3 Length of the following data
ActionButton 3 If field 11 Completion Code = 000 (success), returns code for key pressed:
1=Virtual button 1 (button on left) pressed
2=Virtual button 2 (button on right) pressed
888=Cancel hard key pressed
FS 1 Field separator (Hex 1C)
Data 1 Returns selected virtual button, if any (1 = left button, 2= right button)

Sample Message

Request

The following request tells Simplify to display the screen shown below (note that bottom of scrolling screen is shown):

API Field #, Value Description
0001,36 Transaction Type
0011,14125071000 User Data. See Field 11 (User Data) .
5001,[see value below] Non-Financial Data
    071=Tag
    883=Length of data
    3= Button descriptor font size
    I Agree=Descriptor for first (left) virtual button
    I do not agree=Descriptor for second (right) virtual button
    3=Scrolling text font size
    2=Scrolling text justification
    You agree that any Services contain proprietary=Text for line 1
    (etc.)

5001,0718833FSI agreeFSI do not agree FS3FS2FSYou agree that any Services contain proprietary content, informationFS and material that is protected by applicable intellectual property (etc.)

Response

API Field #, Value Description
0001,36 Transaction Type
0011,14125071000?V102.18B01803 User Data. See Field 11 (User Data) .
5001,071005777FS1 Non-Financial Data
    071=Tag
    005=Length of data
    777=Enter key pressed
    1=Virtual button 1 pressed