The Load Enquiry API allows you to check the status of a wallet load transaction that was initiated using the PG Load API. This is essential for transaction reconciliation and status verification.
Environment
Environment | URL |
---|---|
Test | https://apitest.payu.in/loyalty-points/ppi/payment/pg-load/enquiry/v1 |
Production | https://api.payu.in/loyalty-points/ppi/payment/pg-load/enquiry/v1 |
HTTP Method: POST
Request Headers
This API uses HMAC-SHA512 authentication on the header.
Parameter | Description |
---|---|
walletIdentifier mandatory |
String Program Type (e.g., CLW)
|
date mandatory |
String GMT formatted date (e.g., Thu, 17 Feb 2022 08:17:59 GMT)
|
Authorization mandatory |
String HMAC-SHA512-based authentication token
|
Content-Type mandatory |
String application/json
|
If you do not post the authentication, you will get error in response. For the list of error codes, refer to Status Codes
hmac authentication logic
hmac username="smsplus", algorithm="sha512", headers="date", signature="7ff938849aa79265a3de63fe241dfecb1c680f58c6d11e9f9ca08512afea374705eb9f8995ef6c4584e16eca2e1dc688262bb0937a36cc0f75ec22a9eea33523"
Where, the fields in this example are:
- username: The merchant key of the merchant.
- algorithm: This must have the value as hmac-sha512 that is used for this API.
- headers: This must have the value as date digest.
- signature: This must contain the hmacsha512 of (signing_string, merchant_secret), where:
- signing_string: It must be in the "date: {dateValue}"format. Here, the dateValue is the same values in the fields listed in this table For example, "date: Thu, 17 Feb 2022 08:17:59 GMT"
- merchant_secret: The merchant Salt of the merchant. For more information on getting the merchant Salt, refer to Generate Merchant Key and Salt.
Request Parameters
Body Parameters
Parameter | Description | Example |
---|---|---|
clientTxnIdmandatory | Alphanumeric(100) Unique transaction ID from the PG Load request | PGLOAD123456 |
Response Parameters
Parameter | Description | Example |
---|---|---|
merchantCode | Merchant's unique ID provided by PayU | 180012 |
clientTxnId | Echoes the client's transaction ID | PGLOAD123456 |
txnAmount | The amount intended to be loaded into the wallet | 4100 |
accosaRefNo | Auto-generated sequence number | ACC123456789 |
status | Transaction status | SUCCESS/FAILED/PENDING |
responseCode | Numeric response code | 00 |
refundTxnExist | Indicates if the transaction was refunded | false |
message | Response Message or description for the response code. | Failed |
VerifyPaymentResponse.message | Message related to the status | Transaction successful |
VerifyPaymentResponse.status | Status of execution of load enquiry API | 1 |
VerifyPaymentResponse.result | Status result from payment gateway | PG result for Verify Payment API. For more information, refer to . |
Sample Request
curl --location --request POST 'hhttps://apitest.payu.in/loyalty-points/ppi/payment/pg-load/enquiry/v1\
--header 'walletIdentifier: CLW' \
--header 'date: Wed, 12 Jun 2024 08:53:43 GMT' \
--header 'digest: lrGnpxCydiyLo5KPdXrJczwJgtsUbJiBj9N5QHTt+ho=' \
--header 'authorization: hmac username="smsplus", algorithm="hmac-sha256", headers="date digest", signature="v15rnvh1InSEWRq6EW9BCfXlxO0QI/4Sxxmdxd2f4Q0="' \
--header 'Content-Type: application/json' \
--data-raw '{
"clientTxnId": "123parentTxnPayuId"
}
Sample Response
Successful Transaction
{
"merchantCode": "2",
"clientTxnId": "Test_008",
"txnAmount": "10000",
"status": "FAILED",
"responseCode": "1303",
"refundTxnExist": true,
"refundEnquiryResponse": {
"txnId": "999810590007501",
"refundId": "3001378553",
"requestId": "4993824106986",
"merchantId": "3",
"amount": "100.0",
"refundStatus": "PENDING",
"merchantRefId": "loyalty_ppi_9",
"refundType": "FULL",
"lastRefundType": "PARTIAL",
"isReconSuccess": false,
"isAutoRefund": false,
"discountAdjusted": 0,
"reversed": false
},
"verifyPaymentResponse": {
"mihpayId": 999810590007501,
"bankReferenceNumber": "39594217",
"amount": 100,
"mode": "NB",
"requestId": "",
"originalAmount": 100,
"additionalCharges": 0,
"discount": 0,
"netDebitAmount": 100,
"productInfo": "Product Info",
"firstName": "Manali",
"bankcode": "DSHB",
"cardNo": null,
"cardType": null,
"cardToken": null,
"udf1": "loadTag=PG",
"udf2": null,
"udf3": null,
"udf4": null,
"udf5": null,
"field2": null,
"field9": "Transaction Completed Successfully",
"errorCode": "E000",
"errorMessage": "No Error",
"addedOn": "2025-02-12 17:40:35",
"settledAt": "0000-00-00 00:00:00",
"paymentSource": "payu",
"pgType": "NB-PG",
"status": "success",
"unmappedStatus": "captured",
"merchantUTR": null,
"mcpLookupId": null,
"mcpAmount": null,
"mcpCurrency": null,
"mcpExchangeRate": null,
"originalCurrency": "INR",
"merNetAmount": null,
"offerAvailed": null,
"message": "Found TxnId",
"txnId": "Test_008"
}
}
Failed Transaction
{
"merchantCode": "180012",
"clientTxnId": "56894",
"txnAmount": "4100",
"accosaRefNo": null,
"status": "FAILED",
"responseCode": "00",
"refundTxnExist": false,
"refundEnquiryResponse": null,
"verifyPaymentResponse": {
"message": "Success",
"status": 1,
"result": [
{
"payuId": 999000000002603,
"transactionDetails": {
"id": 999000000002603,
"transactionId": "61042",
"merchantKey": "travelibibo",
"merchantName": "Name409208872",
"status": "failed",
"discount": 0,
"amount": 51,
"transactionFee": 51,
"additionalCharges": 0,
"mode": "UPI",
"baseTxnId": 999000000002602,
"firstName": "FGHJ",
"lastName": "FGHJ",
"addedOn": "2025-01-09 17:34:36",
"phone": "XXXXXX693252",
"email": "[email protected]",
"productInfo": "Product Info",
"errorCode": "E317",
"ibiboCode": "UPI",
"address": "",
"city": "",
"zipcode": "",
"cardNo": null,
"cardType": null,
"cardToken": null,
"udf1": "loadTag=PG",
"udf2": null,
"udf3": null,
"udf4": null,
"udf5": null,
"field0": null,
"field1": "kk@okaxis",
"field2": null,
"field3": "kk@okaxis",
"field4": "KUNAL KUKREJA",
"field5": "AXI918605XXXXXXXXXXXX61531422612197",
"field6": null,
"field7": "01",
"field8": "googlepay",
"field9": "01|PENDING|Completed Using Verify API",
"errorMessage": "Bank was unable to authenticate.",
"paymentSource": "payu",
"partnerToken": null,
"clearToken": false,
"ccAvenueOrderid": null,
"merchantUTR": null,
"threeDsEci": null,
"threeDSEnrolled": null,
"threeDSStatus": null,
"appName": "GooglePay",
"mcpLookupId": null,
"mcpAmount": null,
"mcpCurrency": null,
"mcpExchangeRate": null,
"rupayAuthRefNo": null,
"originalCurrency": null,
"curl": "https://pp1api.payu.in/loyalty-points/ppi/payment/pg-load/success/v1",
"furl": "https://pp1api.payu.in/loyalty-points/ppi/payment/pg-load/success/v1",
"surl": null,
"state": null,
"country": null,
"bankRefNo": "868212138432",
"ip": "10.50.10.111",
"issuingBank": null,
"paymentGateway": null,
"address2": ""
}
}
]
}
}
Response codes
Response Code | Description |
---|---|
00 | SUCCESS |
1009 | CARD_CANCELLED_CLOSED_EXPIRED |
1010 | CARD_TEMPORARY_BLOCK |
1012 | CARD_PENDING_CANCELLATION |
1013 | AML_MIN_LIMIT |
1030 | INVALID_MESSAGE |
1045 | UNABLE_TO_PROCESS_REQUEST |
1055 | MALFORMED REQUEST |
1056 | INVALID MESSAGE CODE |
1058 | INVALID_WALLETS |
1088 | INVALID REQUEST DATE format |
1093 | INVALID CLIENT TXN ID |
1101 | UNKNOWN_SOURCE_ACCOUNT_TYPE |
1121 | CARD_CREDIT_DEBIT_BLOCK |
1135 | REFUND_AMOUNT_GREATER_THAN_ORIGINAL_TXN_AMOUNT |
1246 | ORIGINAL_TXN_NOT_EXIST |
1247 | SOURCE_ACC_TYPE_NOT_MACHED_WITH_IMPL |
1303 | CUSTOMER DETAILS NOT PRESENT |
1304 | MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED |
1322 | TRANSACTION AMOUNT CANNOT BE ZERO |
1325 | FUND FLOW TYPE MISMATCH |
1326 | IMPL ID MISMATCH |
1357 | WALLET DETAILS NOT FOUND |
1353 | COOLING OFF PERIOD BETWEEN TWO LOADS NOT COMPLETED |
1354 | CORPORATE_LEVEL_LIMIT_EXCEEDED |
1363 | INVALID ACTIVITY STATUS |
1366 | PROGRAM IS INACTIVE |
1367 | PROGRAM NOT FOUND |
1376 | INVALID UNLOAD AMOUNT |
1368 | WALLET OR ACCOUNTNO SHOULD BE PRESENT |
1398 | ACCOUNTNO SHOULD BE PRESENT |
1501 | SYSTEM_ERROR_DB |
1504 | SYSTEM_CACHE_FAILURE |
3007 | UNLOAD AMOUNT SHOULD BE LESS THAN AVAILABLE BALANCE |
10153 | AMOUNT IS NOT WITHIN MIN-MAX RANGE |
10163 | PROGRAM DAILY LIMIT EXCEEDED |
6000 | ACCOUNT DORMANT |
6002 | ACCOUNT PERMANENTLY BLOCKED OR CLOSED |
6014 | ACCOUNT IN TEMPORARILY BLOCKED STATE |
6016 | ACCOUNT IN CREDIT BLOCKED STATE |
6017 | ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE |
1392 | FUND FLOW TYPE NOT PRESENT IN THE REQUEST |
6909 | SENDER CUSTOMER NOT FOUND |
10044 | SENDER INFO INVALID LENGTH |
1319 | SOURCE_ACCOUNT_INVALID_LENGTH |
1103 | INVALID_TRANSACTION_AMOUNT |
6911 | Invalid reserved field 1 |
6912 | Invalid reserved field 2 |
6913 | Invalid reserved field 3 |
1298 | INVALID_SOURCE_ACCOUNT_TYPE |
1322 | Transaction amount cannot be zero |
10012 | IMPLID NOT PRESENT |
10013 | IMPLTYPE NOT PRESENT |
6933 | INVALID SOURCE TYPE |
84114 | Invalid data type for field Transaction Amount |
9343 | CLIENT TXN ID IS MANDATORY |
303178 | Request Date Time Length should not be more than 14 characters |
1361 | INVALID ACCOUNT NUMBER |
6935 | SOURCE TYPE SHOULD BE 0 OR 1 |
10160 | WALLET DAILY LIMIT EXCEEDED |
10164 | WALLET MONTHLY LIMIT EXCEEDED |
10168 | WALLET YEARLY LIMIT EXCEEDED |
10216 | WALLET DAILY COUNT EXCEEDED |
10220 | WALLET MONTHLY COUNT EXCEEDED |
10224 | WALLET YEARLY COUNT EXCEEDED |
13047 | WALLET_PER_TRANSACTION_LIMIT_EXCEEDED |