Seamless Debit Enquiry API

The Seamless Debit Enquiry API provides transaction status for a debit request. This API is essential for reconciliation and transaction verification purposes, allowing you to confirm the final status of payment transactions.

Environment

Environment	URL
Test	`https://test.payu.in/merchant/postservice.php?form=2`
Production	`https://info.payu.in/merchant/postservice.php?form=2`

HTTP Method: POST

Request Headers

Parameter	Description
Content-Type `mandatory`	`String` application/x-www-form-urlencoded

Request Parameters

Body Parameters

The request body contains both encrypted and decrypted parameters.

Encrypted

Parameter	Description
encdata `mandatory`	`String` Encrypted request body containing all the decrypted parameters

Decrypted

Parameter	Description	Example
key `mandatory`	`String(50)` Merchant key provided by PayU	JPM7Fg
command `mandatory`	`String(20)` Set to 'verify_payment'	verify_payment
var1 `mandatory`	`String(25)` Transaction ID (txnid) for the transaction to be verified	IhfgcZnXR...
hash `mandatory`	`String(128)` SHA512 hash calculated for the request	a0ae79...

Response Parameters

Parameter	Description	Example
status	Status of the verification request	1
msg	Message indicating verification result	Transaction found
transaction_details	JSON object with detailed transaction information. For more information, refer to Transaction details object	Refer to Transaction details object

Transaction details object

Parameter	Description	Example
mihpayid	PayU transaction reference number	1735903830180094
request_id	Original request ID	56882
bank_ref_num	Bank reference number	123456789
amt	Transaction amount	41.00
disc	Discount amount	0.00
mode	Payment mode used	CLW
PG_TYPE	Payment gateway type	CLW
status	Transaction status	success/failure
unmappedstatus	Detailed status	captured
Merchant_UTR	Merchant UTR number	UTR123456
txnid	Transaction ID	56882
key	Merchant key	JPM7Fg
net_amount_debit	Net amount debited	41.00
addedon	Transaction date and time	2023-08-22 18:30:15
productinfo	Product information	iPhone
firstname	Customer first name	Sourav
lastname	Customer last name	Mishra
email	Customer email	[email protected]
phone	Customer phone	919988776655
hash	Response hash	def456ghi789...
error_code	Error code (if failed)	E000
error_Message	Error message (if failed)	Insufficient balance

Sample Request

Encrypted Packet

curl --location --request POST 'https://test.payu.in/merchant/postservice.php?form=2' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'encdata=h/0YSUd9jKOQ8+2Dc3Phr4s7vxyz123...'

Decrypted Packet

key=JPM7Fg&command=verify_payment&var1=IhfgcZnXR&hash=a0ae79...

Sample Response

Successful Transaction Found

{
  "status": 1,
  "msg": "Transaction found",
  "transaction_details": {
    "mihpayid": "1735903830180094",
    "request_id": "56882",
    "bank_ref_num": "123456789",
    "amt": "41.00",
    "disc": "0.00",
    "mode": "CLW",
    "PG_TYPE": "CLW",
    "status": "success",
    "unmappedstatus": "captured",
    "Merchant_UTR": "UTR123456",
    "txnid": "56882",
    "key": "JPM7Fg",
    "net_amount_debit": "41.00",
    "addedon": "2023-08-22 18:30:15",
    "productinfo": "iPhone",
    "firstname": "Sourav",
    "lastname": "Mishra",
    "email": "[email protected]",
    "phone": "919988776655",
    "hash": "def456ghi789..."
  }
}

Transaction Not Found

{
  "status": 0,
  "msg": "Transaction not found"
}

HTTP Status Codes

Status Code	Description
200	OK - Request processed successfully
400	Bad Request - Invalid request parameters
401	Unauthorized - Authentication failed
500	Internal Server Error