View Beneficiary Details API

The View Beneficiary Details API is used to get all the beneficiaries available under the merchant account.

HTTP Method: GET

Environment

Test Environmenthttps://uatoneapi.payu.in/payout/beneficiary?beneficiaryId={id}
Production Environmenthttps://payout.payumoney.com/payout/beneficiary?beneficiaryId={id}

Request header

ParameterDescriptionExample
Authorization mandatoryString Specify the access token generated earlier in this parameter.Bearer {access_token}
payoutMerchantId
mandatory`		String Specify the payout merchant id provided while onboarding or creating Payout account.1111126
Content-Type
mandatory		String Indicates the format in which the request is sent.application/json

📘

Note:

The pid is payoutMerchantId, however it is different from the PayU merchant id. Check the Payouts Dashboard or call the PayU Customer Support if you don’t know your payoutsMerchantID.

Request parameters

ParametersDescriptionExample
beneficiaryId
mandatory		Long Indicates beneficiary ID returned while creation 

Sample request

curl --location 'https://test.payumoney.com/payout/beneficiary?beneficiaryId=14' \ 
--header 'payoutMerchantId: 1111167' \ 
--header 'Authorization: 1d7e2db3cce25cb3a0a8753f18663cceb4e060538c118498f3f18cf6cb7c7f9b'

Sample response

{
    ""status"": 0,
    ""msg"": ""Beneficiary Created with Id :12120"",
    ""code"": null,
    ""data"": {
        ""beneficiaryId"": 12120,
        ""name"": ""Ankush"",
        ""email"": ""[email protected]"",
        ""mobile"": ""1234567890"",
        ""accountNo"": ""123456789012"",
        ""ifsc"": ""ICIC0000046"",
        ""vpa"": null,
        ""merchantId"": 2222740,
        ""isValid"": true,
        ""addedOn"": ""2022-09-06T07:28:40.000+0000"",
        ""updatedOn"": ""2022-09-06T07:28:40.000+0000"",
        ""isVerified"": null,
        ""isRegistered"": null,
        ""nameWithBank"": null,
        ""cardNo"": null,
        ""beneCode"": null
    }
}