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. See Appendix F for the use of this field. |
| 5001,[see value below] | Non-Financial Data
|
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. See Appendix F for the use of this field. |
| 5001,070005777FS2 | Non-Financial Data
|