SPIn Specification
Transaction Request
GET/cgi.html

Query Parameters

AuthKey*
string
PaymentType*
enum
TransType*
string
Amount*
number
Tip
number
CashbackAmount
number
Frequency
string
CustomFee
number
IsvId
string
ReconId
string
RefId*
string
RegisterId*
string
TPN
string
PrintReceipt
enum
ReducedStateTax
string
StateTax
string
CityTax
string
SigCapture
enum
Tag1
string
Tag2
string
Tag3
string
PerformedBy
string
MerchantId
string
CustomerEmail
string
CustomerMobile
string
IsTxnStatusScreenRequired
boolean
GET/cgi.html
1curl --location 'https://test.spinpos.net:443/SPIn/cgi.html?TerminalTransaction=%3Crequest%3E%3CPaymentType%3ECredit%3C%2FPaymentType%3E%3CTransType%3ESale%3C%2FTransType%3E%3CAmount%3E1%3C%2FAmount%3E%3CTip%3E0%3C%2FTip%3E%3CCashbackAmount%3E0%3C%2FCashbackAmount%3E%3CFrequency%3EOneTime%3C%2FFrequency%3E%3CCustomFee%3E0%3C%2FCustomFee%3E%3CRefId%3E12234%3C%2FRefId%3E%3CPrintReceipt%3ENo%3C%2FPrintReceipt%3E%3CSigCapture%3ENo%3C%2FSigCapture%3E%3CCustomerEmail%3Esai%40gmail.com%3C%2FCustomerEmail%3E%3CCustomerMobile%3E%2B15418996990%3C%2FCustomerMobile%3E%3CIsTxnStatusScreenRequired%3Etrue%3C%2FIsTxnStatusScreenRequired%3E%3C%2Frequest%3E'
Response

// Awaiting response…

Sample response
{
  "RefId": "12234",
  "RegisterId": "7632070",
  "AuthCode": "TAS330",
  "PNRef": "532212500069",
  "TransNum": "6",
  "ResultCode": "0",
  "Message": "Approved",
  "RespMSG": "APPROVAL TAS330",
  "PaymentType": "Credit",
  "Voided": "false",
  "TransType": "Sale",
  "SN": "B17912107210030",
  "Receipt": "Merchant Copy",
  "ExtData": "Amount=1.00,dueAmnt=,isPartialApprovalTxn=false,approvedAmnt=,InvNum=6,CardType=VISA,cardBrandType=,Tip=0.20,Fee=0.04,Disc=0.00,DiscLabel=,BatchNum=10,CashBack=0.00,AcntLast4=5439,AcntFirst4=4012,BIN=401200,Name=DenovoPay,FeeLabel=Custom Fee,BaseAmount=1.00,TxnCode=1,TaxCity=0.20,Tax1Label=Local Tax,customCashMessage=,customCreditMessage=,TaxState=0.10,Tax2Label=State Tax,TaxCommercial=0.00,CDCVMIndicator=D,TipLine=0,RespCode=00,RRN=532212500069,TraceNum=6,HostTxnId=000000000628722,txnId=00000333992531176620251118073720,PrintSaveMsg=,isIbs=false,isSurChargeApplied=false,isFeeAppliedForDebitCard=true,isDiscloseFeeToCustomer=true,isPockytWalletMode=false,L2L3flag=,IsvId=23454,TxnType=1,EntryType=Manual Entry,TotalAmt=1.54,TaxAmount=0.30,isGiftMode=false,GiftBalAmount=,Balance=,EBTFSAvailBalance=,EBTCashAvailBalance=,ebtCashBalAmount=,isWalletMode=false,txnLabel=SALE,surveyQuestion=,surveyAnswer=,walletPayMethod=,walletTxnPaymentNum=,walletTxnData=,deviceId=,walletConfirmationId=,SignLine=,SignPath=,profileId=,profileName=,offlinePin=false,fallBackMode=0,networkMode=WIFI,txnStartTime=1763469440905,txnEndTime=1763469453711,pagoWalletFlashMessage=,pagoConfirmationCode=,pagoCommittedTransactionId=,pagoMerchantTransactionId=,ReducedTax=0.00,ReducedTaxFee=0.00,RTaxLabel=,ExpDate=1225,MSRPLabel=,MSRPAmount=,DateTime=2025-11-18 07:37:20",
  "EMVData": "AID=A0000000041010,AppName=DEBITMASTERCARD,TVR=0000008001,TSI=A000,IAD=,ARC=",
  "iPOSToken": "0B44FE32F4032486B0A434BAEBAB001628A71B677407F8D5",
  "HostResponseCode": "00",
  "HostResponseMessage": "APPROVAL TAS330"
}