In Zaakpay Express Checkout Flow, you can easily integrate it with your website and start accepting online payment through various payment methods such as Credit and Debit Card, Net banking, UPI and Wallet.
Once the customer clicks on the payment button, It redirects to the Zaakpay Standard Checkout Page.
Haven't created your account yet?
Please follow our Getting started guide.
Transact API
Purpose: This API can be used to initiate a transaction and redirect user to Zaakpay Express Checkout Page.
Request Type: POST
Environment details:
- Staging Server: https://zaakstaging.zaakpay.com
- Live Server: https://api.zaakpay.com
- API Endpoint: /api/paymentTransact/V8
Request Attributes
These Parameters are mentioned in the same order in which Zaakpay Payment Gateway calculates the checksum (Excluding checksum).
Response Attributes
Facing Issue in Response Checksum Calculation?
Please use the same sequence in checksum calculation.
amount=1000&bank=AXIS BANK LTD.&bankid=NA&cardId=2ba58e263f0f89f87080ac95ee46eea90389d1b29e9b5364b531d08a5e40175c~366&cardScheme=Visa&cardToken=4000 XXXX XXXX 0002&cardhashid=CH466&doRedirect=false&orderId=ZPLive1509350715217&payment Method=400000&paymentMode=Debit Card&responseCode=100&responseDescription=The transaction was completed successfully. &productDescription=NA&product1Description=NA&product2Description=NA&product3Drescription=NA&product4Description=NA&pgTransId=ZP55cbfff01a00d&pgTransTime=10/30/2017 14:40:25&
CheckSum Calculation
For both integrity & data-authenticity verification before sending data to the API. We use an algorithm HMAC SHA-256 to calculate the checksum.
Checksum is calculated on all request parameters that is posted to the API. We require data to be posted to Zaakpay server in the NVP (Name-Value Pairs) format.
To calculate the checksum please follow the process below:
- Create a list of all parameters which you are passing to the API. String used in checksum calculation has a predefined sequence in which parameters are to be concatenated.
- Create a concatenated string of all data values in your list, with ampersand '&' at the end of each item with the parameter name. e.g.merchantIdentifier=merchantIdentifiervalue&orderid=orderIdvalue&amount=amountvalue&buyerEmail=buyerEmailvalue&buyerAddress=buyerAddressvalue&...
- Calculate the checksum using the HMAC SHA-256 algorithm, the concatenated string as data and your generated secret key. Checksum String should be in the same order in which request parameters are posted.
- The resulting checksum calculated should be posted to the Zaakpay API along with other data.
Note : The empty parameters are not to be used in the checksum calculation string.
You can check the checksum string generated against the provided request parameters here
The secret key , returnUrl and currency was configured for the sandbox environment.
Want to simulate Zaakpay Express Checkout Flow?
Follow below steps to initiate the transactions.
Initiate Transaction
- Click on Transact API to make a test transaction. Please refer to the below Image.
- Insert Merchant Identifier and other fields on our Demo Page.
- Click on the "Pay Now" button to proceed with the transaction on Zaakpay.
- Use the Test Card details for our Staging Credentials and use live cards for our Live Environment.
- Zaakpay will post the response of the transaction to the provided return URL.
Sample Request
Please refer the below CURL request for reference.
curl --location --request POST 'https://zaakstaging.zaakpay.com/api/paymentTransact/V8?amount=200&[email protected]¤cy=INR&merchantIdentifier=889653b03ce04a57b54db6463b1e5445&orderId=ZPLive162774621544906&checksum=ad423b02a9a6c6a7d0810be6b313d4f5243dda65b4ea81c03ab169ad35b1ff54' \
--header 'Cache-Control: no-cache' \
--header 'Postman-Token: c2376ff3-c001-4eeb-b828-ac3ebcc4d3b0' \
--header 'Cookie: JSESSIONID=AA2827C1F972CDD7D6147D284F9FCF1D'
Checksum String :
amount=200&[email protected]¤cy=INR&merchantIdentifier=889653b03ce04a57b54db6463b1e5445&orderId=ZPLive162774621544906&
Secret Key :
0678056d96914a8583fb518caf42828a
Generated Checksum : ad423b02a9a6c6a7d0810be6b313d4f5243dda65b4ea81c03ab169ad35b1ff54
Sample Response
orderId ZPLive162774621544906
responseCode 100
responseDescription The transaction was completed successfully.
checksum c5cd7aa4e0001d1b3ba47729229fda26adab2dc2609c705c3646ef573a9f2b6f
amount 200
doRedirect false
paymentMode Credit Card
cardId bce8e4e1e66520cb0bc2bf3a0e760412d53273a844bf0931f2b3136a2ee0ada3~1
cardScheme Visa
cardToken 4012 XXXX XXXX 1881
bank HDFC
bankid NA
paymentMethod 401288
cardhashid CH101
productDescription NA
product1Description NA
product2Description NA
product3Description NA
product4Description NA
pgTransId ZP5caa1910371f2
pgTransTime 08/28/2021 22:33:03
SGST 0
CGST 0
IGST 0
statusCode 7
orderAmount 200
zaakpayFee 500
totalTax 0
txnAmount 200
txnData={
"merchantIdentifier":"fb2016ffd3a64b2994a6289dc2b671a4",
"txns":[
{
"amount":"1000",
"pgTransId":"ZP5ccbb5a8b4959",
"orderId":"ZPLive1632479839916",
"paymentMode":"Debit Card",
"cardScheme":"Visa",
"product3Description":"NA",
"cardToken":"4012 XXXX XXXX 1112",
"responseCode":"100",
"bank":"HDFC",
"bankid":"NA",
"doRedirect":"false",
"product1Description":"NA",
"product4Description":"NA",
"responseDescription":"The transaction was completed successfully. ",
"cardId":"25157d8564f730461489ea3102c393fd3bf13cfed94966f44815714d57170f4c~273",
"cardhashid":"CH373",
"paymentMethod":"401200",
"product2Description":"NA",
"pgTransTime":"09\/24\/2021 16:11:06",
"txnDate":"2021-09-24 16:11:07.272",
"productDescription":"Zaakpay subscription fee"
}
]
}&checksum=b114d127fbe793150ef7a0d10e3c084c975b48d20382bacb0080864f573dd6ea
Download our Express Checkout Flow Document Directly from here
Transactions Failing on Live Environment?
- Make sure you are using Live cards for Live Transactions.
- For more details, Please refer to our FAQ.
Updated 3 days ago