PG Load Enquiry API

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
clientTxnId `mandatory`	`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 Verify Payment API .

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