Download Superlight Kits For Websites

Our intuitive technological solutions create payment integrations that are scalable and flexible for the future.

Integrate your website using API documentation

Transact Request Parameters, Ver. 1

Parameter1
Priority
Validation
Allowed Values
merchantIdentifier
Mandatory
alphanumeric
Our unique identifier for your website
orderId
Optional
max 20 alphanumeric, must be unique per website, we do not accept duplicate
Your unique transaction identifier
returnUrl
Optional
this must be the domain (or a sub domain of it) you saved under My Account > Integration
URL where you want Mobikwik PG to post the response
buyerEmail
Mandatory
valid email address of the buyer
pankaj@gmail.com
buyerFirstName
Mandatory
100 alphanumeric Street address of the buyer.
Pankaj Kumar
buyerAddress
Optional
30 alphabet, minimum 3
#123, Hello Apartments, Rainbow Street
buyerCity
Optional
State of the buyer
Surat
buyerState
Mandatory
Country of the buyer
pankaj@gmail.com
buyerCountry
Mandatory
valid email address of the buyer
Pankaj Kumar
buyerPincode
Optional
100 alphanumeric
Street address of the buyer.
#123, Hello Apartments, Rainbow Street
buyerPhoneNumber
Optional
30 alphabet, minimum 3
Surat
txnType
Mandatory
State of the buyer
pankaj@gmail.com
zpPayOption
Mandatory
Country of the buyer
Pankaj Kumar

Transact Response Parameters, Ver. 1

Parameter1
Priority
Validation
Allowed Values
orderId
Mandatory
max 20 alphanumeric, must be unique per website, we do not accept duplicate
Your unique transaction identifier
responseCode
Mandatory
numeric max 3 digits 123
responseDescription
Mandatory
alphanumeric max 30 description of the response
Our unique identifier for your website
checksum
Mandatory
checksum calculated at Mobikwik PG's server end on a string [joining every parameter value] for security purpose
Array of characters and numbers

Transact API Response Codes

Response code
Response Description
100
The transaction was completed successfully.
101
Merchant not found. Please check your merchantIdentifier field.
102
Customer canceled transaction.
103
Fraud Detected.
104
Customer Not Found.
105
Transaction details not matched.
106
IpAddress BlackListed.
107
Transaction Amount not in specified amount range.
108
Validation Successful.
109
Validation Failed.
110
MerchantIdentifier field missing or blank.
111
MerchantIdentifier Not Valid.
126
Date received with request was not valid.
127
ReturnUrl does not match the registered domain.
128
Order Id Already Processed with this Merchant.
129
OrderId field missing or blank.
130
OrderId received with request was not Valid.
131
ReturnUrl field missing or blank.
132
ReturnUrl received with request was not Valid
133
BuyerEmail field missing or blank.
134
BuyerEmail received with request was not Valid.
135
BuyerFirstName field missing or blank.
136
BuyerFirstName received with request was not Valid.
137
BuyerLastName field missing or blank.
138
BuyerLastName received with request was not Valid.
139
BuyerAddress field missing or blank.
140
BuyerAddress received with request was not Valid.
141
BuyerCity field missing or blank.
142
BuyerCity received with request was not Valid.
143
BuyerState field missing or blank.
144
BuyerState received with request was not Valid.
145
BuyerCountry field missing or blank.
146
BuyerCountry received with request was not Valid.
147
BuyerPincode field missing or blank.
148
BuyerPinCode received with request was not Valid.
149
BuyerPhoneNumber field missing or blank.
150
BuyerPhoneNumber received with request was not Valid.
151
TxnType field missing or blank.
152
TxnType received with request was not Valid.
153
ZpPayOption field missing or blank.
154
ZpPayOption received with request was not Valid.
155
Mode field missing or blank.
156
Mode received with request was not Valid.
157
Currency field missing or blank.
158
Currency received with request was not Valid.
159
Amout field missing or blank.
160
Amount received with request was not Valid.
161
BuyerIpAddressfield missing or blank.
162
BuyerIpAddress received with request was not Valid.
163
Purposefield missing or blank.
164
Purpose received with request was not Valid.
165
ProductDescription field missing or blank.
166
ProductDescription received with request was not Valid.
167
Product1Description received with request was not Valid.
168
Product2Description received with request was not Valid.
169
Product3Description received with request was not Valid.
170
Product4Description received with request was not Valid.
171
ShipToAddress received with request was not Valid.
172
ShipToCity received with request was not Valid.
173
ShipToState received with request was not Valid.
174
ShipToCountry received with request was not Valid.
175
ShipToPincode received with request was not Valid.
176
ShipToPhoneNumber received with request was not Valid.
177
ShipToFirstname received with request was not Valid.
178
ShipToLastname received with request was not Valid.
179
Date is blank.
179
Date received with request was not valid.
180
checksum received with request is not equal to what we calculated.
181
Merchant Data Complete.
182
Merchant Data Not Complete in Our Database.
183
Unfortunately, the transaction has failed.
189
Checksum was blank.
218
IP address field missing or blank.
226
Acquiring Bank timed out.
227
Acquiring Bank returned an error.
400
The transaction was declined by the issuing bank.
401
The transaction was rejected by the acquiring bank.
402
This test transaction has been successfully completed
403
Transaction failed because this card has been blocked by Mobikwik PG
404
Transaction failed due to security checks
405
Transaction failed due to security checks.
501
debitorcredit is blank
502
bankid is blank
503
encrypted_pan is blank
504
card is blank
505
nameoncard is blank
506
encryptedcvv is blank
507
encrypted_expiry_month is blank
508
encrypted_expiry_year is blank
601
Transaction completed successfully.
602
Merchant secret key does not exist.
603
User Blocked.
604
Merchant Blocked.
605
Merchant does not Exist.
606
Merchant not registered on MobiKwik.
607
Wallet TopUp Failed.
608
Wallet Debit Failed.
609
Wallet Credit Failed.
610
User canceled transaction at Login page.
611
User canceled transaction at Wallet Top Up page.
612
User canceled transaction at Wallet Debit page.
613
Order Id already processed with this merchant.
614
Length of parameter orderid must be between 8 to 30 characters.
615
Parameter orderid must be alphanumeric only.
616
Parameter email is invalid.
617
Parameter amount must be integer only.
618
Parameter cell is invalid. It must be numeric, have 10 digits and start with 7,8,9.
619
Parameter merchantname is invalid. It must be alphanumeric and its length must be between 1 to 30 characters.
620
Parameter redirecturl is invalid.
621
User Authentication failed.
622
Monthly Wallet Top up limit crossed.
623
Monthly transaction limit for this user crossed.
624
Maximum amount per transaction limit for this merchant crossed.
625
Merchant is not allowed to perform transactions on himself.
626
Checksum Mismatch.
627
Unexpected Error.
628
Orderid is Blank or Null.
629
Unknown Error!!

Check Request Parameters, Ver. 1

Parameter2
Priority
Validation
Allowed Values
merchantIdentifier
Mandatory
alphanumeric
Mobikwik PG's unique identifier for your website
orderId
Mandatory
max 20 alphanumeric, must be unique per website, we do not accept duplicate
Your unique transaction identifier
mode
Mandatory
1 digit only, numeric
0=test 1=production
checksum
Mandatory
calculated on a string joining every parameter's value above
Array of characters and numbers

Check Request Parameters, Ver. 1

Parameter1
Priority
Validation
Allowed Values
merchantIdentifier
Mandatory
alphanumeric
Mobikwik PG's unique identifier for your website
orderId
Mandatory
max 20 alphanumeric, must be unique per website, we do not accept duplicate
Your unique transaction identifier
responsecode
Mandatory
numeric max 3 digits 123
description
Mandatory
alphanumeric max 30 description of the response
checksum
Mandatory
checksum calculated at Mobikwik PG's server end on a string [joining every parameter value] for security purpose

Check API Response Codes

Parameter2
Priority
103
Fraud Detected
110
MerchantIdentifier field missing or blank
111
MerchantIdentifier not valid
129
OrderId field missing or blank
155
Mode field missing or blank
156
Mode received with request was not valid
180
Checksum received with request is not equal to what we calculated.
182
Merchant Data not complete in our database.
189
Checksum was blank.
190
OrderId either not processed or Rejected.
191
Merchant Identifier or Order Id was not valid.
205
We could not find this transaction in our database.
206
Transaction in Scheduled state.
207
Transaction in Initiated state.
208
Transaction in Processing state.
209
Transaction has been authorized.
210
Transaction has been put on hold.
211
Transaction is incomplete.
212
Transaction has been settled.
213
Transaction has been canceled.
223
Data Validation success.
230
Transaction has been captured..
231
Transaction Refund Completed
232
Transaction Payout Initiated.
233
Transaction Payout Completed
234
Transaction Payout Error;
236
Transaction Refund Paid Out
237
Transaction Chargeback has been initiated
238
Transaction Chargeback is being processed
239
Transaction Chargeback has been accepted
240
Transaction Chargeback has been reverted
241
Transaction Chargeback revert is now complete

Update Request Parameters, Ver. 1

Parameter3
Priority
Validation
Allowed Values
merchantIdentifier
Mandatory
alphanumeric
Our unique identifier for your website
orderId
Optional
max 20 alphanumeric, must be unique per website, we do not accept duplicate
Your unique transaction identifier
returnUrl
Optional
this must be the domain (or a sub domain of it) you saved under My Account > Integration
URL where you want Mobikwik PG to post the response
buyerEmail
Mandatory
valid email address of the buyer
pankaj@gmail.com
buyerFirstName
Mandatory
100 alphanumeric Street address of the buyer.
Pankaj Kumar
buyerAddress
Optional
30 alphabet, minimum 3
#123, Hello Apartments, Rainbow Street
buyerCity
Optional
State of the buyer
Surat
buyerState
Mandatory
Country of the buyer
pankaj@gmail.com
buyerCountry
Mandatory
valid email address of the buyer
Pankaj Kumar
buyerPincode
Optional
100 alphanumeric
Street address of the buyer.
#123, Hello Apartments, Rainbow Street
buyerPhoneNumber
Optional
30 alphabet, minimum 3
Surat
txnType
Mandatory
State of the buyer
pankaj@gmail.com
zpPayOption
Mandatory
Country of the buyer
Pankaj Kumar
  1. Scheduled - Transaction has not started yet, will start at a later date. Not used in Webpay product
  2. Initiated - Transaction has now started. User will now be shown the card page
  3. Processing - The user has been shown the card page and we are now waiting for input from him. He is entering the card number and it is being sent to the bank
  4. Authorised - The user entered the card number and 3dsecure in the page, it was sent to the bank, and the bank has approved the transaction. The money has been blocked from the user's account
  5. On Hold - Transaction temporarily stopped by Mobikwik PG and Merchant cannot capture it
  6. InComplete - User left the transaction without filling in info
  7. Declined - Bank has refused to approve transaction
  8. Captured - The merchant has shipped the product, and now asks for the money to be transferred to his account. the bank has approved the request (but money not moved yet)
  9. canceled by Merchant - Merchant has canceled the transaction. request does not go to bank, it just stops merchant from capturing transaction
  10. canceled by Mobikwik PG - Mobikwik PG has canceled the transaction. request does not go to bank, it just stops merchant from capturing transaction
  11. Settled - We got notification from the Bank and verified it against transaction. the amount for the transaction has come into our nodal account
  12. Payout Initiated - We have done the calculation for this transaction, and have sent the deducted amount (minus our percentage) to our Nodal bank to transfer to merchant in the NEFT file
  13. Payout Completed - We have received notification from Nodal Bank that the money has been transferred (via UTR file), and have verified against our transactions. the payout is now done
  14. Payout Error - There was a problem while paying out this money.
  15. Refund Initiated - The merchant has asked the bank to refund the money to the user. the Partner bank has approved this request
  16. Refund Paid Out - The MPR file the next day correctly shows the refund money has been deducted and gone to the user. it will reach user based on user's bank and card
  17. Refund Completed - The balance payout (through NEFT file) has been calculated after discounting the refund, and remaining amount sent to Nodal Bank. No more work needs to be done on the refund now
  18. Chargeback Initiated - The Partner bank has initiated a chargeback on user's request. the amount has been deducted from the total in the MPR file from the Bank
  19. Chargeback Processing - The remaining payout amount (less the chargeback) has been paid to the merchant (i.e. sent to Nodal Bank to process)
  20. Chargeback Accepted - The merchant accepts the chargeback, so he will not get the money back. this state is set by Mobikwik PG operations. [to be implemented]
  21. Chargeback Reverted - The merchant sent proof of the transaction to Mobikwik PG and bank, bank has accepted this, and returns the charged back amount in today's MPR file
  22. Chargeback canceled - The given back money has been sent to the merchant along with today's NEFT file to Nodal Bank
  23. Partial Refund Initiated - The merchant has asked the bank to refund the partial money to the user. the Partner bank has approved this request
  24. Partial Refund Paid Out - The MPR file the next day correctly shows the Partial refund money has been deducted and gone to the user. it will reach user based on user's bank and card
  25. Partial Refund Completed - The balance payout (through NEFT file) has been calculated after discounting the Partial refund, and remaining amount sent to Nodal Bank. No more work needs to be done on the Partial refund now