Open the Portico Schema site
Portico Developer Guide
Gratuity
Special Processing Rules > Gratuity

Tips can be processed on the initial purchase ("tip on purchase") or can be added later as an adjustment. For tip on purchase, there is a gratuity field that can be included to indicate the portion of the sale that is specific to tip.

After the purchase, CreditAddToBatch or CreditTxnEdit can be used to add a tip and adjust the original transaction amount to include the tip amount. CreditAddToBatch or CreditTxnEdit can also be used to alter tip information in the case that the transaction amount had been adjusted with the tip amount, but the gratuity field had not been included with the correct amount. If the edit service is used, the client will still need to add the transaction to the batch in order for it to settle.