triPOS^®

TipOptions

The triPOS transaction API, Sale method accepts a tipOptions section on the request, as a child of the configuration section, to control tip behavior on a per transaction basis. These options override any existing tip-related lane configurations.

The tipOptions request sections allows you to:

• Tell triPOS to prompt for predefined local currency amounts on the PIN pad . For example:

          
                                  "tipOptions": {
                                      "otherOption": "Other, None", // “other” will allow custom entry, “none” will leave no tip
                                      "tipSelections": "3.00, 5.00, 10.00", // local currency amounts
                                      "type": "Amount"
                                  }
                          

• Tell triPOS to prompt for predefined percentages on the PIN pad. For example:

                              "tipOptions": {
                                  "otherOption": "Other, None", // “other” will allow custom entry, “none” will leave no tip
                                  "tipSelections": "10, 15, 20", // tip percentage amounts of 10%, 15%, or 20%
                                  "type": "Percentage"
                              }
  
                          

• Tell triPOS to prompt for a custom dollar amount on the PIN pad without displaying any preset options. For example:

                              "tipOptions": {
                                  "otherOption": "other", // with type=prompt, this value has no effect but must be “other” or “none”
                                  "tipSelections": "0", // with type=prompt, this value has no effect but must be a decimal value
                                  "type": "Prompt" // “Prompt” will go straight to custom tip option screen
                              }
  
                          

To disable tip in triPOS Cloud, set isTipAllowed to FALSE, either in-line in the Sale request or in the lane configuration.
To disable tip in triPOS Direct, do not include a tipOptions section in your request AND set the isTipAllowed=False in the triPOS.config file.