POST /input
Content of the InputRequest
message. It conveys the data to display and how to process it. In addition to the display on the Input Device, it might contain an operation (the DisplayOutput
element) per Display Device type.
Servers
- https://terminal-api-test.adyen.com/sync
- https://terminal-api-test.adyen.com/async
- <local-terminal-IP-address>
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
InputData |
Object | Yes |
Information related to an Input request. It conveys the target input logical device, the type of input command, and possible minimum and maximum length of the input. In addition, if the requestor might require to receive an Event Notification if a card is inserted in a card reader, with the |
InputData.InfoQualify |
String | Yes |
Qualification of the information to send to an output logical device, to display or print to the Cashier or the Customer. Possible values:
Possible values:
|
InputData.ImmediateResponseFlag |
Boolean | No |
Indicates whether to request an Immediate response to the message without waiting for the completion of the command. Default value: false |
InputData.DefaultLayoutString |
String | No | |
InputData.WaitUserValidationFlag |
Boolean | No |
Indicates that the user must confirm the entered characters, when the maximum allowed length is reached. During the processing of an Input command Default value: true |
InputData.InputCommand |
String | Yes |
Type of requested input. Can be: GetConfirmation, TextString, DigitString, DecimalString or GetMenuEntry. Possible values:
Possible values:
|
InputData.FromRightToLeftFlag |
Boolean | No |
Indicates if the entered character has to be displayed from the right to the left of the display field. Default value: false |
InputData.DisableValidFlag |
Boolean | No |
Indicates if the Valid function key has to be deactivated (value True). During the processing of an Input command Default value: false |
InputData.GlobalCorrectionFlag |
Boolean | No |
Indicates, when the user presses the Correct function key in an input entry, if all the entered characters are removed (value True) or only the last entered character if any (value False). Default value: false |
InputData.NotifyCardInputFlag |
Boolean | No |
Request Notification of the card entered in the POI card reader. Default value: false |
InputData.DisableCorrectFlag |
Boolean | No |
Indicates if the Correct function key has to be deactivated (value True). During the processing of an Input command Default value: false |
InputData.BeepKeyFlag |
Boolean | No |
Indicates, when the user press a key, if a beep has to be generated (value True). Default value: false |
InputData.MaxLength |
Integer | No |
Maximum length of an entered string, or maximum number of entries that can be selected in a menu. |
InputData.StringMask |
String | No |
String mask to get information requiring a specific format. For the processing of an Input command |
InputData.MaskCharactersFlag |
Boolean | No |
Indicates to mask the characters entered by the user (i.e. replacing in the display of the input, the entered character by a standard character as *). Default value: false |
InputData.DefaultInputString |
String | No |
Default string value for an input command. On the |
InputData.MenuBackFlag |
Boolean | No |
If it has the value True, it indicates that the Back function key (respectively Home function key) may be used to go back to the immediate upper level of the menu. If it has the value False, it indicates that the current menu level has no parent menu. Default value: false |
InputData.Device |
String | Yes |
Logical device located on a Sale Terminal or a POI Terminal, regarding the class of information to output (display, print or store), or input (keyboard) for the Cashier or the Customer. Possible values:
Possible values:
|
InputData.MaxInputTime |
Integer | No |
Maximum input time in seconds. Limits the time to answer to an Input request message. |
InputData.MinLength |
Integer | No |
Minimum length of an entered string, or minimum number of entries that can be selected in a menu. |
InputData.DisableCancelFlag |
Boolean | No |
Indicates if the Cancel function key has to be deactivated (value True). Default value: false |
InputData.MaxDecimalLength |
Integer | No |
Maximum input length of the decimal part (without decimal point). |
DisplayOutput |
Object | No |
Information to display and the way to process the display. |
DisplayOutput.InfoQualify |
String | Yes |
Qualification of the information to sent to an output logical device, to display or print to the Cashier or the Customer. Allows the manager of the device, Sale or POI Terminal, to send the information to a particular physical device or to present the information accordingly. Possible values:
Possible values:
|
DisplayOutput.ResponseRequiredFlag |
Boolean | No |
Indicates if the message response is required. Default value: true |
DisplayOutput.MinimumDisplayTime |
Integer | No |
Number of seconds the message has to be displayed. Default value: 0 |
DisplayOutput.MenuEntry[] |
Array | No |
An entry of the menu to present to the Cashier. It conveys the message text and parameters of the menu entry. This output data could be only provided for an input command, in order to choose an entryof the menu. |
DisplayOutput.MenuEntry[].DefaultSelectedFlag |
Boolean | No |
Selection of a menu entry to be displayed. In Input request message, it allows selection of one or several menu entries before any user action. Default value: false |
DisplayOutput.MenuEntry[].PredefinedContent |
Object | No |
Reference of a predefined message to display or print. It conveys information related to the predefined message. |
DisplayOutput.MenuEntry[].PredefinedContent.Language |
String | No |
Identification of a language. |
DisplayOutput.MenuEntry[].PredefinedContent.ReferenceID |
String | Yes |
Identification of a predefined message to display or print. |
DisplayOutput.MenuEntry[].MenuEntryTag |
String | No |
Characteristics related to the selection of a menu entry. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputText[] |
Array | No |
Content of text message to display or print. It conveys Information related to the content of the text message and its format. All the data elements related to the format of the text to display or print are parameters valid for the whole Text content. |
DisplayOutput.MenuEntry[].OutputText[].EndOfLineFlag |
Boolean | No |
Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text. Default value: true |
DisplayOutput.MenuEntry[].OutputText[].Text |
String | Yes |
Content of text message to display, print or play. |
DisplayOutput.MenuEntry[].OutputText[].Font |
String | No |
Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems. |
DisplayOutput.MenuEntry[].OutputText[].CharacterHeight |
String | No |
Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputText[].Alignment |
String | No |
Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputText[].StartColumn |
Integer | No |
Column where the text string has to be displayed or printed. |
DisplayOutput.MenuEntry[].OutputText[].CharacterSet |
Integer | No |
Character height of the text string to display or print. Absence of this data element means the characters have normal height. |
DisplayOutput.MenuEntry[].OutputText[].StartRow |
Integer | No |
Row where the text string has to be displayed or printed. |
DisplayOutput.MenuEntry[].OutputText[].CharacterWidth |
String | No |
Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputText[].CharacterStyle |
String | No |
Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputText[].Color |
String | No |
Color of the text string to display or print. Possible values:
Possible values:
|
DisplayOutput.MenuEntry[].OutputXHTML |
String | No |
XHTML document body containing the message to display or print. |
DisplayOutput.MenuEntry[].OutputFormat |
String | Yes |
Possible values:
Possible values:
|
DisplayOutput.OutputSignature |
String | No |
Vendor-specific signature of the text message to display or print. If protection has to be provided to the vendor on the text to display or print. |
DisplayOutput.Device |
String | Yes |
Logical device located on a Sale Terminal or a POI Terminal, in terms of class of information to output (display, print, or store), or input (keyboard) for the Cashier or the Customer. Possible values:
Possible values:
|
DisplayOutput.OutputContent |
Object | Yes |
Content to display or print. |
DisplayOutput.OutputContent.PredefinedContent |
Object | No |
Reference of a predefined message to display or print.
Mandatory, if |
DisplayOutput.OutputContent.PredefinedContent.Language |
String | No |
Identification of a language. |
DisplayOutput.OutputContent.PredefinedContent.ReferenceID |
String | Yes |
Identification of a predefined message to display or print. |
DisplayOutput.OutputContent.OutputBarcode |
Object | No |
Barcode content to display or print.
Mandatory if |
DisplayOutput.OutputContent.OutputBarcode.BarcodeValue |
String | Yes |
Value with a Barcode coding. The barcode value to display or print. |
DisplayOutput.OutputContent.OutputBarcode.BarcodeType |
String | No |
Type of Barcode coding. Qualification of the barcode value to display or print. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputText[] |
Array | No |
Content of text message to display or print.
Mandatory, if |
DisplayOutput.OutputContent.OutputText[].EndOfLineFlag |
Boolean | No |
Indicates if the text is at the end of a line. Allows the display or the print of a new line and a carry-over return characters after the formatted text. Default value: true |
DisplayOutput.OutputContent.OutputText[].Text |
String | Yes |
Content of text message to display, print or play. |
DisplayOutput.OutputContent.OutputText[].Font |
String | No |
Name of the font. Used to change character font of the output, as agreed between the POI and Sale Systems. |
DisplayOutput.OutputContent.OutputText[].CharacterHeight |
String | No |
Character height of the text string to display or print. Absence of this data element means the characters have normal height. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputText[].Alignment |
String | No |
Alignment of the text string on the display line or print line. Absence of this data element means the characters have normal alignment. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputText[].StartColumn |
Integer | No |
Column where the text string has to be displayed or printed. |
DisplayOutput.OutputContent.OutputText[].CharacterSet |
Integer | No |
Character height of the text string to display or print. Absence of this data element means the characters have normal height. |
DisplayOutput.OutputContent.OutputText[].StartRow |
Integer | No |
Row where the text string has to be displayed or printed. |
DisplayOutput.OutputContent.OutputText[].CharacterWidth |
String | No |
Character width of the text string to display or print. Absence of this data element means the characters have normal width. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputText[].CharacterStyle |
String | No |
Typographic style of the sequence of characters to display or print. Absence of this data element means the characters have normal style. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputText[].Color |
String | No |
Color of the text string to display or print. Possible values:
Possible values:
|
DisplayOutput.OutputContent.OutputXHTML |
String | No |
XHTML document body containing the message to display or print.
Mandatory if |
DisplayOutput.OutputContent.OutputFormat |
String | Yes |
Format of the content to display or print. Possible values:
Possible values:
|
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.