Transaction Enquiry API
Technical Document For Merchant Integration
WWW.SABPAISA.IN
TABLE OF CONTENTS
Sr. No. CONTENT Page No.
1 Transaction Enquiry API 3
2 Request Format for Transaction Enquiry API 3
3 Response Format for Transaction Enquiry API 4
Table of Parameters Coming in Response of
4 5
Transaction Enquiry
TRANSACTION ENQUIRY API
SabPaisa provides an API for verifying every transaction's status and other details. Merchants can
integrate this API into their system to update the status of a pending transaction, or they can also
use the API to know the status of a single transaction. For this, he needs to pass the Client Code
along with the Client Transaction Id.
In cases of Offline transactions, using this inquiry is recommended
Clients can write schedulers to run repeat inquiries but are advised against executing multiple
concurrent requests on SabPaisa using this API.
All requests coming from the client will be stored and monitored.
REQUEST FORMAT FOR TRANSACTION ENQUIRY API
Format – JSON
Method – POST
Headers parameter –
Accept : application/json
Content-Type : application/json
Parameters – clientCode, statusTransEncData
URL:
Live: https://txnenquiry.sabpaisa.in/SPTxtnEnquiry/getTxnStatusByClientxnId
Staging: https://stage-txnenquiry.sabpaisa.in/SPTxtnEnquiry/getTxnStatusByClientxnId
The sample code for the request string is given below
{
"clientCode":"LPSD1",
"statusTransEncData":"BzX8iKkrbFCdRBE8egFLxzEz2i2JGlfpMCJIAWT
H+kYZGXzINUQxf
WFh3ZKZXOF/30Hx8OspXtXvyKF+kiU+Dg=="
}
NOTE 1 – The parameter statusTransEncData is the encrypted string which is made using
clientTxnId, sabpaisaTxnId, challanNumber and clientCode using the encryption method. The
parameter clientCode is mandatory. The merchant can use any of the three parameters along
with clientCode to get the transaction status.
Sample String statusTransEncData
clientCode=LPSD1&clientTxnId=8fa31fb159b1d8ee6b2b
RESPONSE FORMAT FOR TRANSACTION ENQUIRY API
Format – JSON
Parameters – clientCode, statusResponseData
The sample code for response string is given below:
{
"clientCode": "LPSD1",
"statusResponseData":
"5Iwpvy+JCYOR9ypxEE7TJrzNxggLSZojKeX3cUg1yh2QqV0ZxmVmg6w99eE+
aEjWJYS6HmiybYN6zVDSZxyB2VZUEkmWPKfzFSKZ+ZI9HtWgW/L/Qu3+6lved
vX/AAG0BfR0oJjC+vnXvAtXb8BZjbCR6Ow7bnrZM0NSxfAQz+yq/CqETZKYD4
hxxxE+EdEOHBn64nhRHqE3FedLDl3Z9cz7xHpnGqHldDHqEw8m8wJyuY7dvH2
oBIR4xRRZqwmGmjMSShkL+baOekHx8FYfVVQE1A5q0rXnftUjuQLuNtMxkZ/E
8p2QNINia+F5l0VsMOqmF/vgciJNtxJjQrt0EHB+A1Jn7A5qFRZ/HIVjXmss3
TkhWDl72SXmFXmMNRIxTCQkMQe8yk4AIvSgwgKt7gXbrJikcqJr3AOcWjrRFH
v2qoC7XZtVVDSCTihep6qSeddWpBB5JBc+gHqLq6+5fnpyKpScia97pW9P6Gw
fJNWPIeZRd5yxv+SHWGar9IJmdbgEqArzAvWhvwLtcScjdp9hmR0rz9cUzQ4s
7cR166ojeRIh1xbW6I+DlruJE3xGpYmsY1fvBh7CNkne9a6SFYL0uBq2UY/1Y
StajnAW+JyW03EkHh06HduSQhFMFQeCbMq0DQqcmjokbYEGtumfkBek8bo4qR
zNxQYYVt8nWexlefFbnhlYuMwaSZc7V9YE6eY1NHdWZlLpQ1KryEdzqWpJulP
1Zrvypiz2FgsFKlBTrUMdjZSla085SOqWZyQNjNS7Pwi3pc6iPo09gqNN7rX6
gTEoDmyi5+qxx2NMV0I+WQZOyxm/PwhsmD1gR8EsezzxS+RoVjn/qns0xDNus
qEMxcr0q7TChsS+tl3CoDW6M8wuvM/Nz0bBGHLiQcqSbqyQd1tclCxh3bXEt3
17vu3O/bpMGt9v2xpkNWwpVJ5dQ/uaZy4A3b9AFokdYyIhOhaWoAL/eOOTKXb
7u+KYKJ C0pAnhdKrUJOfNdUM1gcBwXY8Dp0iEhphrjpilUta"
}
NOTE – The parameter statusResponseData is the string which is made using all the
response parameters with their values using & operator as given below.
statusResponseData:payerName=MOTILALRAVIDAS&payerEmail=motikr
827153@gmail.com&payerMobile=8271537302&clientTxnId=TESTING3F
IOD020721025607&payerAddress=Delhi&amount=335.0&clientCode=LP
SD1&paidAmount=336.0&paymentMode=RupayCard&bankName=null&amou
ntType=INR&udf1=NA&udf2=NA&udf3=NA&udf4=NA&udf5=NA&udf6=NA&ud
f7=NA&udf8=NA&udf9=null&udf10=null&udf11=null&udf12=null&udf1
3=null&udf14=null&udf15=null&udf16=null&udf`17=null&udf18=nul
l&udf19=null&udf20=null&status=FAILED&responseCode=0300&chall
anNumber=null&sabpaisaTxnId=000000103220796794&sabpaisaMessag
e=SabPaisa enquired transaction after expiry time
!&bankMessage=nullNotenrolled&bankErrorCode=NA&sabpaisaErrorC
ode=null&bankTxnId=SKMU&programId=null&
mcc=null&transDate=Wed Aug 31 16:30:31 IST
TABLE OF PARAMETERS COMING IN RESPONSE OF TRANSACTION ENQUIRY
SR Parameter Name Parameter Type Mandatory/Optional Length Description
1 payerName Alphabet Mandatory 100 Name of the payee
2 payerEmail AlphaNumeric Mandatory 100 Email of the payee
3 payerMobile Numeric Mandatory 20 Mobile number of the payee
4 clientTxnId AlphaNumeric Mandatory 100 Transaction Id generated by Client
5 payerAddress AlphaNumeric Optional 255 Address of the payee
6 amount Numeric Mandatory 10 Amount of transaction
7 clientCode Alphabet Mandatory 5 Client Code
8 paidAmount Numeric Mandatory 50 Total amount paid
9 paymentMode Alphabet Mandatory 50 Mode of the Payment
10 bankName Alphabet Mandatory 255 Name of Bank
11 amountType Alphabet Optional 3 Currency type of amount -INR,USD
12 udf1 AlphaNumeric Optional 255 User Defined Field
13 udf2 AlphaNumeric Optional 255 User Defined Field
14 udf3 AlphaNumeric Optional 255 User Defined Field
15 udf4 AlphaNumeric Optional 255 User Defined Field
16 udf5 AlphaNumeric Optional 255 User Defined Field
17 udf6 AlphaNumeric Optional 255 User Defined Field
18 udf7 AlphaNumeric Optional 255 User Defined Field
19 udf8 AlphaNumeric Optional 255 User Defined Field
20 udf9 AlphaNumeric Optional 255 User Defined Field
21 udf10 AlphaNumeric Optional 255 User Defined Field
22 udf11 AlphaNumeric Optional 255 User Defined Field
23 udf12 AlphaNumeric Optional 255 User Defined Field
24 udf13 AlphaNumeric Optional 255 User Defined Field
25 udf14 AlphaNumeric Optional 255 User Defined Field
26 udf15 AlphaNumeric Optional 255 User Defined Field
27 udf16 AlphaNumeric Optional 255 User Defined Field
28 udf17 AlphaNumeric Optional 255 User Defined Field
29 udf18 AlphaNumeric Optional 255 User Defined Field
30 udf19 AlphaNumeric Optional 255 User Defined Field
31 udf20 AlphaNumeric Optional 255 User Defined Field
32 status Alphabet Mandatory 10 Status of the transaction
33 statusCode Numeric Mandatory 10 Status Code
34 challanNumber AlphaNumeric Optional 255 Challan Number
35 sabpaisaTxnId Alphabet Mandatory 18 Transaction Id generation at SabPaisa
36 sabpaisaMessage AlphaNumeric Optional 255 Response Message from SabPaisa
37 bankMessage AlphaNumeric Optional 255 Response Message from Bank
38 bankErrorCode AlphaNumeric Optional 255 Error Code given by Bank
39 sabpaisaErrorCode AlphaNumeric Optional 255 Error Code given by SabPaisa
40 bankTxnId AlphaNumeric Optional 255 Transaction Id generated by Bank
41 programId AlphaNumeric Optional 255 Master Client Code
42 mcc Numeric Mandatory 20 Merchant Category Code
43 transDate Numeric Mandatory 255 Date of Transaction
44 refundStatusCode Numeric Optional 255 Status Code for Refund
45 chargeBackStatus Alphabet Optional 255 Status of Chargeback
46 settlementStatus Alphabet Optional 255 Status of Settlement
SUPPORT ESCALATION MATRIX
The merchant can coordinate with their Account Manager for any issue they face during the
integration of PG. The Account Manager will connect the merchant team with the support team.
The mail Id for PG support is integration.support@sabpaisa.in. The merchant can also drop the mail
with the Client Code and screenshot of the issue on this mail id and the support team will connect with
the merchant.
THANK
YOU
