Tag 071 - Scrolling Text with Two Virtual Buttons

Simplify supports a Scrolling Text with Two Virtual Buttons Message. This Tag can be used to display a Consent screen. The Request displays a screen with 2 virtual buttons plus lines of text through which the customer can scroll. The maximum total number of characters supported (for all lines combined) is 2033. A field in the Request (Required) determines whether the Enter key is accepted when no virtual button is selected. Note that pressing the Enter key is not required after pressing a virtual button.

With the exception of the Tag value (and the maximum length of button descriptors), the format of this request is identical to that for Tag 070.

The following details are device-specific:

MX 915 – The maximum length of virtual button descriptors (Virtual fields) is 14. The maximum length of text lines (Info fields) is 47. The maximum number of lines displayed on one screen is 11.

MX 925 – The maximum length of virtual button descriptors (Virtual fields) is 15. The maximum length of text lines (Info fields) is 49. The maximum number of lines displayed on one screen is 12.

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

Scrolling Text with Two Virtual Buttons Message Format

Request

Field 5001

Field Name Length Description
TTT 3 Tag (always = 071)
LLL 3 Length of the following data
Required 1 Data is required when ENTER is pressed (0=No, 1=Yes)
FS 1 Field separator (Hex 1C)
Virtual1 0-14 (MX915)
0-15 (MX925)
Virtual button1 text (left justified).
FS 1 Field separator (Hex 1C)
Virtual2 0-14 (MX915)
0-15 (MX925)
Virtual button2 text (left justified)
FS 1 Field separator (Hex 1C)
InfoJust 1 Justification:
1 = left
2 = center
3 = right
FS 1 Field separator (Hex 1C)
Info1 0-47 (MX915)
0-49 (MX925)
Text for Information 1
FS 1 Field separator (Hex 1C)
Info2 0-47 (MX915)
0-49 (MX925)
Text for Information 2
FS 1 Field separator
Info3 0-47 (MX915)
0-49 (MX925)
Text for Information 3
FS 1 Field separator
Info4 0-47 (MX915)
0-49 (MX925)
Text for Information 4
FS 1 Field separator
Info5 0-47 (MX915)
0-49 (MX925)
Text for Information 5
FS 1 Field separator
Info6 0-47 (MX915)
0-49 (MX925)
Text for Information 6
FS 1 Field separator
... ... ...
InfoMax 0-47 (MX915)
0-49 (MX925)
Text for last Information field.
The maximum number of Information fields is determined by the length of the fields. (Total number of characters in all Information fields must not exceed 2033.)

Response

Field 5001

Field Name Length Description
TTT 3 Tag (always = 071 )
LLL 3 Length of the following data
Field Name Length Description
ActionButton var 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
777=Enter hard key pressed
888=Cancel hard key pressed
FS 1 Field separator (Hex 1C)
Data 1 If ActionButton = 777 (Enter), returns selected virtual button, if any (1 = left button, 2 = right button)

Sample Scrolling Text with Two Virtual Buttons Message

Request

The following request tells Simplify to display the screen shown below (start of screen is shown):

API Field #, Value Description
0001,36 Transaction Type
0011,14125070000 User Data
5001,[see value below] Non-Financial Data
    071=Tag
    999=Length of data
    1= Data required when ENTER pressed
    I agree=Virtual button 1 descriptor
    I do not agree=Virtual button 2 descriptor
    1= InfoJust
    You agree that any Services contain proprietary=text for Information 1 (etc.)

5001,0719991FSI agreeFSI do not agreeFS1FSYou agree that any Services contain FSproprietary content, information and FSmaterial that is protected by applicable FSintellectual property and other laws,including FSbut not limited to copyright, and that you FSwill not use such proprietary content, FSinformation or materials in any way FSwhatsoever except for permitted use of the FSServices. No portion of the Services may be FSreproduced in any form or by any means. You FSagree not to modify, rent, lease, loan, FSsell, distribute, or create derivative FSworks based on the Services, in any FSmanner, and you shall not exploit FSthe Services in any unauthorized way FSwhatsoever, including but not limited to, FSby trespass or burdening network capacity. FSYou further agree not to use the FSServices in any manner to harass, FSabuse, stalk, threaten, defame or otherwise FSinfringe or violate the rights of any FSother party, and that the Application FSProvider is not in any way FSresponsible for any such use by you, FSnor for any harassing, threatening, FSdefamatory, offensive or illegal messages FSor transmissions that you may receive as a FSresult of using any of the Services.

Response

API Field #, Value Description
0001,36 Transaction Type
0011,14125070000?V142.18.65_2.18.1 User Data
5001,070005777FS2 Non-Financial Data
    071=Tag
    005=Length of data
    777=Enter key pressed
    2=Virtual button 2 pressed