triPOS^®

Now, triPOS Cloud can modify cashback flags, isCashbackAllowed and cashbackOptions, using PATCH /cloudapi/v1/lanes/{{laneId}}/configuration endpoint.

The isCashbackAllowed allows you to enable or disable cashback for all debit transactions.

The cashbackOptions contains selectionAmounts and manualEntry. selectionAmounts is a set of comma-separated list of whole numbers or ‘other’ in configuration allows you to:

• Tell triPOS to prompt for predefined amounts on the PIN pad for cashback selection
• Tell triPOS to prompt for 'other' on the PIN pad which lets user to enter a custom cashback amount

Through the API, if you want to allow selection options only, provide a comma-separated list of cashback amounts in the selectionAmounts parameter of the request. If you'd like to provide an 'other' option for manual entry, include the manualEntry section as well. To skip selection buttons and go straight to manual entry, provide only the manualEntry section in the request.

Cashback Request Specific

For more information please visit here.

Behaviors

Following behavior should be exhibited by cashback configurations in PATCH /cloudapi/v1/lanes/{{laneId}}/configuration endpoint:

• If set isCashbackAllowed = true, cashback is enabled for all debit transactions.
• If amountIncrement is set to any value, that value is used to set increments you want customers to be able to get back. Common values include 1, 5, 10 or 20.
• If maximumAmount is set to any value, that value is used to set the maximum cashback amount you want to allow cardholders to get back.
• If selectionAmounts is set to an improper value, the error is Selection values must be a comma-separated list of whole numbers or ‘other’.
• If amountIncrement is set to a value which is less than 0, the error is When manual entry is allowed for cashback options, amountIncrement must be provided and must be greater than 0.
• If maximumAmount is set to a value which is less than 0, the error is When manual entry is allowed for cashback options, maximumAmount must be provided and must be greater than 0.

Example

Here is an example request modifying cashback configurations:

{
  "isCashbackAllowed": true,
  "cashbackOptions": {
    "selectionAmounts": "1,2,other",
    "manualEntry": {
      "amountIncrement": 10,
      "maximumAmount": 100
    }
  }
}