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.

A field in the Response (ActionButton) indicates which action button or key was pressed (Enter, Cancel, Virtual button 1, Virtual button 2).

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 (Hex 1C)
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 (Hex 1C)
Info3Var.Text for Information 3
FS1Field separator (Hex 1C)
Info4Var.Text for Information 4
FS1Field separator (Hex 1C)
Info5Var.Text for Information 5
FS1Field separator (Hex 1C)
Info6Var.Text for Information 6
FS1Field separator (Hex 1C)
(etc.)(etc.)
Info100Var.Text for Information 100

Response

Field NameLengthDescription
TTT8Tag (always = 071 )
LLL3Length of the following data
ActionButton1-3If field 11 Completion Code = 000 (success), returns code for action button or key pressed:
  • 1=Virtual button 1 (button on left) pressed
  • 2=Virtual button 2 (button on right) pressed
  • 777=Enter hard key pressed
  • 888=Cancel hard key pressed
Else: not present.

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,xxx..User Data. See Simplify-Controlled Field Definitions.
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,xxx..User Data. See Simplify-Controlled Field Definitions.
5001,071003777Non-Financial Data
  • 071=Tag
  • 003=Length of data
  • 777=Enter key pressed
5002,80378002Device serial number (if present)