Get Split Info API

The Get Split Info API is used for getting split info of the parent transaction in the aggregator flow.

Environment


Test Environment	https://test.payu.in/merchant/postservice.php?form=2
Production Environment	https://info.payu.in/merchant/postservice.php?form=2

Request parameters

The request body contains the following parameters:

Params	Description	Example
key `mandatory`	Merchant key provided by PayU	JPM\\\*g
command\ `mandatory`	This parameter must contain the API Command for getting Transaction. It should be `get_split_info` for Get Split Info API.
var1\ `mandatory`	This parameter must contain the PayU ID	403993715532325577
hash\ `mandatory`	This parameter must contain the hash value to be calculated at your end. Hash logic for this API is: ``` sha512(key\|command\|payuId\|salt) sha512 ```

Sample request

curl --location 'https://test.payu.in/merchant/postservice.php?form=1' \
--header 'Cookie: PHPSESSID=j601h8g2u1cofo4u5it8v1lk8r; PHPSESSID=670cf11080b74' \
--form 'key="JPM***g"' \
--form 'command="get_split_info"' \
--form 'var1="403993715532325577"' \
--form 'hash="49fa996d81f66374fbe2eedfc494b48149f1abb9555afa0b0c03d671d7a769efd07e40eabee6571fba124966b1a2d219b8118ff9500456effb1e0ae63d94a3e2"' \

Response parameters

Parameter	Description	Example
status	This parameter returns the status of web service call. The status can be any of the following: * 0 - If web service call failed. * 1 - If web service call succeeded	0
payuId	This parameter returns the parent merchant PayU ID that was posted in the API request.	403993715532325577
splitStatus	This parameter returns the reason string. For a list of error codes for failure scenarios, refer to [Error codes for failure scenario](#error-codes-for-failure-scenario)	success
splits	This parameter contains the response in a JSON array format. Each JSON object contains the following: * merchant key * aggregator sub-transaction ID * amount * Transaction\_details field.	``` { "merchantKey": "iC***G", "aggregatorSubTxnId": "dkjgfrfgnfm", "amount": 900.00, "splitType": "split" } ```

Sample response

Success scenario

{
    "status": 1,
    "payuId": 403993715532325577,
    "splitStatus": "success",
    "splits": [
        {
            "merchantKey": "iC***G",
            "aggregatorSubTxnId": "dkjgfrfgnfm",
            "amount": 900.00,
            "splitType": "split"
        },
        {
            "merchantKey": "ut***U",
            "aggregatorSubTxnId": "dkfhdgfcdcddfn",
            "amount": 100.00,
            "splitType": "commission"
        }
    ]
}

Error codes for failure scenario

Condition	error\_code	error\_message
Hash validation failed	AGG-300	Hash validation failed
invalid parent transaction Payu ID: * non-existent PayuID * PayuID is not a parent transaction of aggregator flow * Payu ID belongs to some other merchant.	AGG-301	Invalid PayuID
Split doesn’t exist for the transaction	AGG-302	Split doesn't exist for this transaction