Get Settlement Details API

You can use the Get Settlement Details API to retrieve settlement details which the bank has to settle for you. The input is the date for which settlement details are required, where the var1 parameter is the date you want to know the settlement status or UTR (Unique Transaction Reference number). This API can be posted with version (1 or 2) in the var5 parameter.

Environment

Request parameters

Example values

Use the following sample values while trying out the API:

• var1 (date of the transaction/UTR number): 2020-10-26
• var2: 5
• var3: 2000 or more

Sample request

For version 1

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=JP***g&command=get_settlement_details&var1=2021-08-10&hash=259ded5457ad8d078b3c06294413680d0b9eb341682a4f0eecad17256388c2e096f37f5077480e3a56000cc0a3585f7cd73a7d2d10d8225a05b3b93cd27fd5f8"

For version 2

curl -X POST "https://test.payu.in/merchant/postservice?form=2
-H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d

"key=JP***g&command=get_settlement_details&var1=2021-08-10&hash=259ded5457ad8d078b3c06294413680d0b9eb341682a4f0eecad17256388c2e096f37f5077480e3a56000cc0a3585f7cd73a7d2d10d8225a05b3b93cd27fd5f8&var2&var3&var4=L&var5=2"

📘

Note

The dates queried in the above requests using version 1 or version 2 are the same. The second sample request (under Sample Request for Version 2) includes the var5 parameter with the value 2 to indicate that it is for version 2.

Response parameters description

Sample response

Success Scenario

On successful processing from PayU, the response is similar to the following:

(
	    [status] => 1
	    [msg] => 1 transactions settled on 2021-08-11
	    [Txn_details] => Array
        (
			[1] => Array
                (
                    [payuid] => 13799177287
                    [txnid] => 13818
                    [txndate] => 2021-08-10 23:46:25
                    [mode] => DC
                    [amount] => 11979.88
                    [requestid] => 9586840660
                    [requestdate] => 2021-08-10 23:49:16
                    [requestaction] => capture
                    [requestamount] => 11979.88
                    [mer_utr] => N223211598444659
                    [mer_service_fee] => 239.6000
                    [mer_service_tax] => 43.1300
                    [mer_net_amount] => 11697.1500
                    [bank_name] => MAST
                    [issuing_bank] => SBI
                    [merchant_subvention_amount] => 0.00
                    [cgst] => 0.00000
                    [igst] => 43.13000
                    [sgst] => 0.00000
                    [PG_TYPE] => HDFC_Internal_Plus
                    [Card Type] => 
                    [token] => 
                )

        )

)

Failure scenario

If the date format is incorrect:

{
      "status": 0,
      "msg": "Please check date format it should be YYYY-MM-DD"
}

If no data found for the particular date queried:

Array 
(
      [status] => 1
      [msg] => 0 transactions settled on 2015-05-01 
      [Txn_details] => Array
                (
                 ) 
)

To learn more about the possible error codes and their description, refer to Error Codes.