The Get Transaction Details API retrieves transaction details between a start date and end date. The response includes transaction status, amount, payment mode, customer details, and optional action details such as capture and refund. Results are returned in a paginated array format.
HTTP Method: POST
Environment
| Test Environment | https://test.payu.in/v4/reporting/transactions |
| Production Environment | https://info.payu.in/v4/reporting/transactions |
Request headers
| Parameter | Description |
|---|---|
| date | The current date and time. For example, format of the date is Wed, 28 Jun 2023 11:25:19 GMT. |
| authorization | The actual HMAC signature generated using the specified algorithm (sha512) and includes the hashed data. For more information, refer to authorization fields description. |
authorization fields description
| Field | Description |
|---|---|
| username | Represents the username or identifier for the client or merchant, for example smsplus. |
| algorithm | Use SHA512 algorithm for hashing and send this as header value. |
| headers | Specifies which headers have been used in generating the hash, for example date. |
| signature | The HMAC signature generated using the specified algorithm. For more information, refer to hashing algorithm. |
hashing algorithm
You must hash the request parameters using the following hash logic:
Hash logic: sha512(`<Body data>` + '|' + date + '|' + merchant_secret)
Where <Body data> contains the request body posted with the request.
Sample header code
var merchant_key = 'smsplus';
var merchant_secret = 'izF09TlpX4ZOwmf9MvXijwYsBPUmxYHD';
// date
var date = new Date();
date = date.toUTCString();
// authorization
var authorization = getAuthHeader(date);
function getAuthHeader(date) {
var AUTH_TYPE = 'sha512';
var data = isEmpty(request['data']) ? "" : request['data'];
var hash_string = data + '|' + date + '|' + merchant_secret;
var hash = CryptoJS.SHA512(hash_string).toString(CryptoJS.enc.Hex);
return `hmac username="${merchant_key}", algorithm="${AUTH_TYPE}", headers="date", signature="${hash}"`;
}Request body parameters
| Parameter | Description | Example |
|---|---|---|
pageNumbermandatory | Number The page number to retrieve. Use 1 for the first page and increment for subsequent pages. | 1 |
startDatemandatory | String The start date for the transaction search in YYYY-MM-DD format. | 2025-08-11 |
endDatemandatory | String The end date for the transaction search in YYYY-MM-DD format. | 2025-08-11 |
totalRecordmandatory | Number The total number of records to fetch for the given date range. | 514 |
Sample request
curl --location 'https://test.payu.in/v4/reporting/transactions' \
--header 'Accept: application/json' \
--header 'Authorization: hmac username="smsplus", algorithm="hmac-sha256", headers="date digest", signature="{{signature}}"' \
--header 'Digest: {{digest}}' \
--header 'Date: Tue, 12 Aug 2025 16:44:30 GMT' \
--header 'Content-Type: application/json' \
--data '{
"pageNumber": 1,
"startDate": "2025-08-11",
"endDate": "2025-08-11",
"totalRecord": 514
}'Response parameters
| Parameter | Description | Example |
|---|---|---|
| message | Response message indicating the operation result. | Success |
| status | Status code for the API call. 1 for success, 0 for failure. | 1 |
| result | Array of transaction objects. For field descriptions, refer to result JSON fields description. | |
| currentPage | The current page number in the paginated response. | 1 |
| totalRecords | Total number of transaction records available for the given date range. | 83 |
| pageSize | Number of transaction records returned in the current page. | 5 |
| totalPages | Total number of pages available for the given date range. | 17 |
| hasNextPage | Indicates whether a next page of results is available. | true |
| hasPreviousPage | Indicates whether a previous page of results is available. | false |
result JSON fields description
Each item in the result array contains the following fields:
| Field | Description | Example |
|---|---|---|
| payuId | PayU transaction ID assigned to the transaction. | 403993715534525267 |
| transactionDetails | JSON object containing the transaction details. For more information, refer to transactionDetails JSON fields description. | |
| transactionActionDetails | optional Array of action details such as capture and refund performed on the transaction. For more information, refer to transactionActionDetails JSON fields description. |
transactionDetails JSON fields description
| Field | Description | Example |
|---|---|---|
| id | PayU transaction ID. | 403993715534525267 |
| transactionId | Merchant transaction ID. | TXN1754891007637_38614 |
| merchantKey | Merchant key associated with the transaction. | PRiQvJ |
| merchantName | Merchant name. | Sudhanshu |
| status | Transaction status. For example, captured, failed, dropped, or bounced. | captured |
| discount | Discount amount applied to the transaction. | 0.00 |
| amount | Total transaction amount including additional charges. | 1000.00 |
| transactionFee | Base transaction amount before additional charges. | 1000.00 |
| additionalCharges | Additional charges applied to the transaction. | 0.00 |
| mode | Payment mode used for the transaction. For example, CC, NB, UPI, CASH, or SI. | NB |
| baseTxnId | Base transaction ID for linked or child transactions. 0 if not applicable. | 0 |
| firstName | Customer first name. | Payu-Admin |
| lastName | Customer last name. | Tyagi |
| addedOn | Timestamp when the transaction was created. | 2025-08-11 11:13:30 |
| updatedOn | Timestamp when the transaction was last updated. | 2025-08-11 11:13:40 |
| phone | Customer phone number. | 9876543210 |
| Customer email address. | [email protected] | |
| productInfo | Product or service description. | Test Product |
| errorCode | Error code for the transaction. E000 indicates no error. | E000 |
| errorDescription | Description of the error code. | No Error |
| ibiboCode | Payment option or bank code used for the transaction. | AXNBTPV |
| address | Customer address. | `` |
| city | Customer city. | `` |
| zipcode | Customer postal code. | `` |
| cardNo | Masked card number, if applicable. | XXXXXXXXXXXX4242 |
| cardType | Card type, if applicable. | null |
| cardToken | Card token, if applicable. | null |
| udf1 to udf5 | User-defined fields passed during the transaction. | udf1 |
| field0 to field9 | Additional transaction-specific fields returned by the payment gateway or PayU. | Transaction Completed Successfully |
| errorMessage | Human-readable error message for the transaction. | No Error |
| paymentSource | Source through which the payment was initiated. For example, payu, payuS2S, or payuPureS2S. | payu |
| partnerToken | Partner token, if applicable. | null |
| clearToken | Indicates whether the token should be cleared. | false |
| ccAvenueOrderid | CCAvenue order ID, if applicable. | null |
| merchantUTR | Merchant Unique Transaction Reference. | null |
| threeDsEci | 3D Secure Electronic Commerce Indicator. | null |
| threeDSEnrolled | Indicates whether the card is enrolled for 3D Secure. | null |
| threeDSStatus | 3D Secure authentication status. | null |
| appName | UPI app name used for the transaction, if applicable. | GooglePay |
| mcpLookupId | Multi-currency pricing lookup ID, if applicable. | null |
| mcpAmount | Multi-currency pricing amount, if applicable. | null |
| mcpCurrency | Multi-currency pricing currency, if applicable. | null |
| mcpExchangeRate | Multi-currency pricing exchange rate, if applicable. | null |
| rupayAuthRefNo | RuPay authorization reference number, if applicable. | null |
| originalCurrency | Original transaction currency, if applicable. | null |
| curl | Cancel URL configured for the transaction. | https://admin.payu.in/test_response |
| furl | Failure URL configured for the transaction. | https://admin.payu.in/test_response |
| surl | Success URL configured for the transaction. | null |
| state | Customer state. | null |
| country | Customer country. | null |
| bankRefNo | Bank reference number for the transaction. | 3abaf676-4385-491e-9488-6490672baa42 |
| ip | IP address from which the transaction was initiated. | 14.141.149.50 |
| issuingBank | Issuing bank name, if applicable. | AMEX |
| paymentGateway | Payment gateway used for the transaction. | null |
| address2 | Additional address information. | `` |
transactionActionDetails JSON fields description
The transactionActionDetails array is returned for transactions that have associated actions such as capture or refund.
| Field | Description | Example |
|---|---|---|
| id | Unique ID for the action. | 138492940 |
| bankRefNo | Bank reference number for the action. | 3abaf676-4385-491e-9488-6490672baa42 |
| token | Token associated with the action. For refund actions, this contains the refund token. | REF_sHGe_906836 |
| actionType | Type of action performed. For example, capture or refund. | capture |
| prevStatus | Previous status before the action. | null |
| amount | Amount associated with the action. | 1000.0 |
| status | Status of the action. For example, SUCCESS or queued. | SUCCESS |
| bankArn | Bank ARN for the action. | null |
| updatedAt | Timestamp when the action was last updated. | 2025-08-11 11:13:40 |
| createdAt | Timestamp when the action was created. | 2025-08-11 11:13:40 |
| settlementId | Settlement ID associated with the action. | null |
| amountSettled | Amount settled for the action. | null |
| refundMode | Refund mode for refund actions. For example, Back to Source. | - |
| settledOn | Timestamp when the action was settled. | null |
| merchantUTR | Merchant UTR for the action. | null |
| merchantServiceFee | Merchant service fee for the action. | 0.0 |
| merchantServiceTax | Merchant service tax for the action. | 0.0 |
| successAmount | Successful amount processed for the action. | null |
Sample response
Success scenario
{
"message": "Success",
"status": 1,
"result": [
{
"payuId": 403993715534525267,
"transactionDetails": {
"id": 403993715534525267,
"transactionId": "TXN1754891007637_38614",
"merchantKey": "PRiQvJ",
"merchantName": "Sudhanshu",
"status": "captured",
"discount": 0.00,
"amount": 1000.00,
"transactionFee": 1000.00,
"additionalCharges": 0.00,
"mode": "NB",
"baseTxnId": 0,
"firstName": "Payu-Admin",
"lastName": "Tyagi",
"addedOn": "2025-08-11 11:13:30",
"updatedOn": "2025-08-11 11:13:40",
"phone": "9876543210",
"email": "[email protected]",
"productInfo": "Test Product",
"errorCode": "E000",
"errorDescription": "No Error",
"ibiboCode": "AXNBTPV",
"bankRefNo": "3abaf676-4385-491e-9488-6490672baa42",
"field9": "Transaction Completed Successfully",
"errorMessage": "No Error",
"paymentSource": "payu",
"ip": "14.141.149.50"
},
"transactionActionDetails": [
{
"id": 138492940,
"bankRefNo": "3abaf676-4385-491e-9488-6490672baa42",
"token": "",
"actionType": "capture",
"prevStatus": null,
"amount": 1000.0,
"status": "SUCCESS",
"bankArn": null,
"updatedAt": "2025-08-11 11:13:40",
"createdAt": "2025-08-11 11:13:40",
"settlementId": null,
"amountSettled": null,
"refundMode": "-",
"settledOn": null,
"merchantUTR": null,
"merchantServiceFee": 0.0,
"merchantServiceTax": 0.0,
"successAmount": null
}
]
},
{
"payuId": 403993715534525275,
"transactionDetails": {
"id": 403993715534525275,
"transactionId": "Txn_Id_642759",
"merchantKey": "PRiQvJ",
"merchantName": "Sudhanshu",
"status": "captured",
"discount": 0.00,
"amount": 10014.60,
"transactionFee": 9991.00,
"additionalCharges": 23.60,
"mode": "NB",
"baseTxnId": 0,
"firstName": "Test",
"lastName": "User",
"addedOn": "2025-08-11 11:13:56",
"updatedOn": "2025-08-11 11:14:14",
"phone": "9876543210",
"email": "[email protected]",
"productInfo": "Test Product",
"errorCode": "E000",
"errorDescription": "No Error",
"ibiboCode": "AIRNB",
"bankRefNo": "86249aea-7368-409b-8742-72fa854c555e",
"field9": "Transaction Completed Successfully",
"errorMessage": "No Error",
"paymentSource": "payu",
"ip": "14.141.149.50"
},
"transactionActionDetails": [
{
"id": 138492944,
"bankRefNo": "86249aea-7368-409b-8742-72fa854c555e",
"token": "",
"actionType": "capture",
"prevStatus": null,
"amount": 10014.6,
"status": "SUCCESS",
"bankArn": null,
"updatedAt": "2025-08-11 11:14:05",
"createdAt": "2025-08-11 11:14:05",
"settlementId": null,
"amountSettled": null,
"refundMode": "-",
"settledOn": null,
"merchantUTR": null,
"merchantServiceFee": 20.0,
"merchantServiceTax": 3.6,
"successAmount": null
},
{
"id": 138492946,
"bankRefNo": null,
"token": "REF_sHGe_906836",
"actionType": "refund",
"prevStatus": null,
"amount": 9991.0,
"status": "queued",
"bankArn": null,
"updatedAt": "2025-08-11 11:14:14",
"createdAt": "2025-08-11 11:14:14",
"settlementId": null,
"amountSettled": null,
"refundMode": "Back to Source",
"settledOn": null,
"merchantUTR": null,
"merchantServiceFee": 0.0,
"merchantServiceTax": 0.0,
"successAmount": null
}
]
}
],
"currentPage": 1,
"totalRecords": 83,
"pageSize": 5,
"totalPages": 17,
"hasNextPage": true,
"hasPreviousPage": false
}Failure scenario
If no transactions are found for the given date range, the response returns an empty result array with pagination details:
{
"message": "Success",
"status": 1,
"result": [],
"currentPage": 1,
"totalRecords": 0,
"pageSize": 5,
"totalPages": 0,
"hasNextPage": false,
"hasPreviousPage": false
}