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

EnvironmentURL
Testhttps://apitest.payu.in/loyalty-points/ppi/payment/pg-load/enquiry/v1
Productionhttps://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

ParameterDescriptionExample
clientTxnId
mandatory
Alphanumeric(100) Unique transaction ID from the PG Load requestPGLOAD123456

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 CodeDescription
00SUCCESS
1009CARD_CANCELLED_CLOSED_EXPIRED
1010CARD_TEMPORARY_BLOCK
1012CARD_PENDING_CANCELLATION
1013AML_MIN_LIMIT
1030INVALID_MESSAGE
1045UNABLE_TO_PROCESS_REQUEST
1055MALFORMED REQUEST
1056INVALID MESSAGE CODE
1058INVALID_WALLETS
1088INVALID REQUEST DATE format
1093INVALID CLIENT TXN ID
1101UNKNOWN_SOURCE_ACCOUNT_TYPE
1121CARD_CREDIT_DEBIT_BLOCK
1135REFUND_AMOUNT_GREATER_THAN_ORIGINAL_TXN_AMOUNT
1246ORIGINAL_TXN_NOT_EXIST
1247SOURCE_ACC_TYPE_NOT_MACHED_WITH_IMPL
1303CUSTOMER DETAILS NOT PRESENT
1304MORE THAN ONE CUSTOMER IDENTIFIER NOT ALLOWED
1322TRANSACTION AMOUNT CANNOT BE ZERO
1325FUND FLOW TYPE MISMATCH
1326IMPL ID MISMATCH
1357WALLET DETAILS NOT FOUND
1353COOLING OFF PERIOD BETWEEN TWO LOADS NOT COMPLETED
1354CORPORATE_LEVEL_LIMIT_EXCEEDED
1363INVALID ACTIVITY STATUS
1366PROGRAM IS INACTIVE
1367PROGRAM NOT FOUND
1376INVALID UNLOAD AMOUNT
1368WALLET OR ACCOUNTNO SHOULD BE PRESENT
1398ACCOUNTNO SHOULD BE PRESENT
1501SYSTEM_ERROR_DB
1504SYSTEM_CACHE_FAILURE
3007UNLOAD AMOUNT SHOULD BE LESS THAN AVAILABLE BALANCE
10153AMOUNT IS NOT WITHIN MIN-MAX RANGE
10163PROGRAM DAILY LIMIT EXCEEDED
6000ACCOUNT DORMANT
6002ACCOUNT PERMANENTLY BLOCKED OR CLOSED
6014ACCOUNT IN TEMPORARILY BLOCKED STATE
6016ACCOUNT IN CREDIT BLOCKED STATE
6017ACCOUNT ALREADY IN CREDIT_DEBIT BLOCKED STATE
1392FUND FLOW TYPE NOT PRESENT IN THE REQUEST
6909SENDER CUSTOMER NOT FOUND
10044SENDER INFO INVALID LENGTH
1319SOURCE_ACCOUNT_INVALID_LENGTH
1103INVALID_TRANSACTION_AMOUNT
6911Invalid reserved field 1
6912Invalid reserved field 2
6913Invalid reserved field 3
1298INVALID_SOURCE_ACCOUNT_TYPE
1322Transaction amount cannot be zero
10012IMPLID NOT PRESENT
10013IMPLTYPE NOT PRESENT
6933INVALID SOURCE TYPE
84114Invalid data type for field Transaction Amount
9343CLIENT TXN ID IS MANDATORY
303178Request Date Time Length should not be more than 14 characters
1361INVALID ACCOUNT NUMBER
6935SOURCE TYPE SHOULD BE 0 OR 1
10160WALLET DAILY LIMIT EXCEEDED
10164WALLET MONTHLY LIMIT EXCEEDED
10168WALLET YEARLY LIMIT EXCEEDED
10216WALLET DAILY COUNT EXCEEDED
10220WALLET MONTHLY COUNT EXCEEDED
10224WALLET YEARLY COUNT EXCEEDED
13047WALLET_PER_TRANSACTION_LIMIT_EXCEEDED
Ask AI Beta

Hi! I am an AI Assistant. Ask me about PayU and get help with your integration.
Responses are generated by AI, may contain some mistakes.

EXAMPLE QUESTIONS