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?form=2 |
| Production Environment | https://info.payu.in/merchant/postservice?form=2 |
Request parameters
Header
| Params | Description | Example |
|---|---|---|
mid mandatory | This parameter must contain the parent merchant’s MID. | 720043 |
commandmandatory | This parameter must contain the API Command for getting Transaction. It should be get_split_info for Get Split Info API. | Get Split Info |
Body
| Params | Description | Example |
|---|---|---|
payuIdmandatory | PayU id in array | "payuId" : ["17066265059"], "payuId" : ["10006265058"] |
splitTypemandatory | Value should always be 2 | 2 |
hashmandatory | This parameter must contain the hash value to be calculated at your end. Hash logic for this API is: sha512(key|command|var1|salt)
sha512 |
Sample request
curl -X POST https://api.example.com/get_split_info \
-H "mid: 720043" \
-H "command: get_split_info" \
-H "Content-Type: application/json" \
-d '{
"payuId": ["17066265059", "10006265058"],
"splitType": 2,
"hash": "your_calculated_hash_here"
}'
Response parameters
| Parameter | Description | Example |
|---|---|---|
| message | This parameter returns the reason string. For a list of error codes for failure scenarios, refer to Error codes for failure scenario | Hash validation failed |
| 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 |
| result | This parameter contains the response in a JSON array format. Each JSON object contains the mihpayuid and Transaction_details field. For more information on transactionDetails field, refer to transactionDetails fields description. |
transactionDetails fields description
| Field | Description |
|---|---|
| id | This field contains the PayU transaction ID. |
| transactionId | This field contains the transaction ID. |
| merchantkey | This field contains the chidl merchant key. |
| merchantname | This field contains the child merchant name. |
| status | This field contains the transaction status. For more information, refer to Payment State Explanations. |
| txnid | This field contains the transaction ID. |
| base_id | This field contains the base PayU Transaction ID. It will be null for a parent transaction. |
| firstname | This field contains the first name of the customer who did the transaction. |
| lastname | This field contains the last name of the customer who did the transaction. |
| addedon | This field contains the transaction created date and time. Format: yyyy-mm-dd hh:ii:ss |
| bank_name | This field contains the bank name of payment transaction. |
| payment_gateway | This field contains the payment gateway used in the transaction. |
| phone | This field contains the contact number of the customer who did the transaction. |
| This field contains the email ID of the customer who did the transaction. | |
| transaction_fee | This field contains the transaction fee without discount and additional charges. |
| amount | This field contains the total amount paid by customer. |
| discount | This field contains the discount or Subvention charges on the transaction. |
| additional_charges | This field contains the additional charges on transaction. |
| productinfo | This field contains the product information provided by merchant. |
| error_code | This field contains the transaction error code. For more information on errors, refer to Error codes for failure scenario |
| bank_ref_no | This field contains the bank reference number. |
| ibibo_code | This field contains the IBIBO Code or bank_code that was submitted in transaction by the merchant to PayU. |
| mode | This field contains the Mode of transaction, such as, CC, DC, NB, EMI. |
| address2 | This field contains the address of the customer. |
| city | This field contains the city of the customer. |
| zipcode | This field contains the PIN code of the customer. |
Sample response
Success scenariro
{
"message": "Success",
"status": 1,
"result": [
{
"payuId": 17066265059,
"transactionDetails": {
"id": 17066265059,
"transactionId": "339024503",
"merchantKey": "w770KY",
"merchantName": "OMNIWARE TECHNOLOGIES PRIVATE LIMITED",
"status": "captured",
"discount": 0.0,
"amount": 708.0,
"transactionFee": 708.0,
"additionalCharges": 0.0,
"mode": "UPI",
"baseTxnId": 0,
"firstName": "DemoName",
"lastName": "",
"addedOn": "2023-03-28 00:05:15",
"phone": "9600260031",
"email": "[email protected]",
"productInfo": "ValidityExtn",
"errorCode": "E000",
"ibiboCode": "UPI",
"address": "",
"city": "",
"zipcode": "",
"cardNo": null,
"cardType": null,
"cardToken": null,
"udf1": "",
"udf2": "",
"udf3": "",
"udf4": "",
"udf5": "",
"field0": null,
"field1": "vinothou35@okaxis",
"field2": null,
"field3": "vinothou35@okaxis",
"field4": "D VINOTH KUMAR",
"field5": null,
"field6": "D VINOTH KUMAR|0000000000",
"field7": "00|APPROVED OR COMPLETED SUCCESSFULLY",
"field8": null,
"field9": "Success|Completed Using Callback",
"errorMessage": "No Error",
"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": null,
"furl": null,
"surl": null,
"state": null,
"country": null,
"bankRefNo": "308761993790",
"ip": "103.126.229.249",
"issuingBank": null,
"paymentGateway": "ICICIU",
"address2": ""
},
"splitTransactionDetails": [
{
"payuId": 17067801351,
"transactionDetails": {
"id": 17067801351,
"transactionId": "splitTxn33902450310",
"merchantKey": "ySHBj2",
"merchantName": "KAROPADIS SHANMUGAM LOGANATHAN",
"status": "captured",
"discount": 0.0,
"amount": 692.97,
"transactionFee": 692.97,
"additionalCharges": 0.0,
"mode": "UPI",
"baseTxnId": 17066265059,
"firstName": "DemoName",
"lastName": "",
"addedOn": "2023-03-28 11:03:22",
"phone": "9600260031",
"email": "[email protected]",
"productInfo": "ValidityExtn",
"errorCode": "E000",
"ibiboCode": "UPI",
"address": "",
"city": "",
"zipcode": "",
"cardNo": null,
"cardType": null,
"cardToken": null,
"udf1": "",
"udf2": "",
"udf3": "",
"udf4": "",
"udf5": "",
"field0": null,
"field1": "vinothou35@okaxis",
"field2": null,
"field3": "vinothou35@okaxis",
"field4": "D VINOTH KUMAR",
"field5": null,
"field6": "D VINOTH KUMAR|0000000000",
"field7": "00|APPROVED OR COMPLETED SUCCESSFULLY",
"field8": null,
"field9": "Success|Completed Using Callback",
"errorMessage": "No Error",
"paymentSource": "child-aggregator",
"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": null,
"furl": null,
"surl": null,
"state": null,
"country": null,
"bankRefNo": "308761993790",
"ip": "103.126.229.249",
"issuingBank": null,
"paymentGateway": "ICICIU",
"address2": ""
}
},
{
"payuId": 17067801352,
"transactionDetails": {
"id": 17067801352,
"transactionId": "339024503",
"merchantKey": "w770KY",
"merchantName": "OMNIWARE TECHNOLOGIES PRIVATE LIMITED",
"status": "captured",
"discount": 0.0,
"amount": 15.03,
"transactionFee": 15.03,
"additionalCharges": 0.0,
"mode": "UPI",
"baseTxnId": 17066265059,
"firstName": "DemoName",
"lastName": "",
"addedOn": "2023-03-28 11:03:22",
"phone": "9600260031",
"email": "[email protected]",
"productInfo": "ValidityExtn",
"errorCode": "E000",
"ibiboCode": "UPI",
"address": "",
"city": "",
"zipcode": "",
"cardNo": null,
"cardType": null,
"cardToken": null,
"udf1": "",
"udf2": "",
"udf3": "",
"udf4": "",
"udf5": "",
"field0": null,
"field1": "vinothou35@okaxis",
"field2": null,
"field3": "vinothou35@okaxis",
"field4": "D VINOTH KUMAR",
"field5": null,
"field6": "D VINOTH KUMAR|0000000000",
"field7": "00|APPROVED OR COMPLETED SUCCESSFULLY",
"field8": null,
"field9": "Success|Completed Using Callback",
"errorMessage": "No Error",
"paymentSource": "child-aggregator",
"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": null,
"furl": null,
"surl": null,
"state": null,
"country": null,
"bankRefNo": "308761993790",
"ip": "103.126.229.249",
"issuingBank": null,
"paymentGateway": "ICICIU",
"address2": ""
}
}
]
}
]
}
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 |