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 NameLengthDescription
TTT3Tag (always = 071)
LLL3Length of the following data
ButtonSize1Font size of virtual buttons (0=extra small to 6=extra large)
FS1Field separator (Hex 1C)
VirtualButton1Var.Virtual button1 text (left justified).
FS1Field separator (Hex 1C)
VirtualButton2Var.Virtual button2 text (left justified)
FS1Field separator (Hex 1C)
InfoFontSize1Font size for Info fields (0=extra small to 6=extra large)
FS1Field separator
InfoJust1Justification for all Information fields (1=Left justify, 2=Center, 3=Right justify)
FS1Field separator (Hex 1C)
Info1Var.Text for Information 1 (left justified)
FS1Field separator (Hex 1C)
Info2Var.Text for Information 2
FS1Field separator
Info3Var.Text for Information 3
FS1Field separator
Info4Var.Text for Information 4
FS1Field separator
Info5Var.Text for Information 5
FS1Field separator
Info6Var.Text for Information 6
FS1Field separator
.
Info100Var.Text for Information 100

Response

Field NameLengthDescription
TTT8Tag (always = 071 )
LLL3Length of the following data
ActionButton3If 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
FS1Field separator (Hex 1C)
Data1Returns 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 #, ValueDescription
0001,36Transaction Type
0011,14125071000User 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.)

sample screen end agreement two virtual buttons

Response

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