SPIn Specification
Tip Adjustment Request
GET/cgi.html-tipadjust

Tip Adjustment enables users to modify the tip amount on a transaction before the batch is settled and sent to the processor. This feature is available only if tip is enabled for the TPN on the portal. Additionally, the host system must use data from the original transaction to allow the terminal to locate and update the tip amount.

Query Parameters

RegisterId*
string
TPN
string
AuthKey
string
TransType*
enum
Amount*
number
Tip*
number
AcntLast4
string
RefId*
string
MerchantId
string
ReconId
string
IsTxnStatusScreenRequired
boolean
GET/cgi.html-tipadjust
1curl --location 'https://test.spinpos.net:443/SPIn/cgi.html?TerminalTransaction=%3Crequest%3E%3CRegisterId%3E3%3C%2FRegisterId%3E%3CTransType%3ETipAdjust%3C%2FTransType%3E%3CAmount%3E100%3C%2FAmount%3E%3CTip%3E10%3C%2FTip%3E%3CRefId%3E2%3C%2FRefId%3E%3CIsTxnStatusScreenRequired%3Etrue%3C%2FIsTxnStatusScreenRequired%3E%3C%2Frequest%3E'
Response

// Awaiting response…

Sample response
{
  "RefId": "2",
  "RegisterId": "3",
  "TPN": "yourTPN",
  "ResultCode": "0",
  "Message": "Success",
  "PaymentType": "Credit",
  "AuthCode": "292249",
  "PNRef": "1807027",
  "ExtData": "InvNum=1,CardType=VISA,BatchNum=1,Tip=0.00,CashBack=0.00,Fee=0.00,AcntLast4=1234,Name=Dejavoo,SVC=0.00,TotalAmt=1.00,DISC=0.00,SHFee=0.00,EBTFSAvailBalance=,EBTCashAvailBalance=,EntryType=Swipe,TaxCity=0.00,TaxState=0.00,Cust1=,Cust1Value=,Cust2=,Cust2Value=,Cust3=,Cust3Value=,AcntFirst4=4111,TaxAmount=0.00"
}