The Create Beneficiary API command is used to register a beneficiary under the merchant. After registering, the merchant can use the beneficiary id to make the payout.
HTTP Method: POST
Environment
| Test Environment | https://uatoneapi.payu.in/payout/beneficiary |
| Production Environment | https://payout.payumoney.com/payout/beneficiary |
Request header
| Parameter | Description | Example |
|---|---|---|
Authorization mandatory | String 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-Typemandatory | 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
| Parameters | Description |
|---|---|
accountNo conditional | StringIndicates Account number of customer |
ifscconditional | StringIndicates IFSC code of the bank account |
vpaconditional | StringIndicates UPI ID of customerNote: Same value will be used by the merchant in the status check of transfer. |
name optional | StringIndicates of the customer |
emailoptional | StringIndicates Email Address of customer |
mobile conditional | StringIndicates Mobile Number of customer |
Sample request
curl --location 'https://uatoneapi.payu.in/payout/beneficiary' \
--header 'Content-Type: application/json' \
--header 'payoutMerchantId: 1111157' \
--header 'Authorization: Bearer 1d7e2db3cce25cb3a0a8753f18663cceb4e060538c118498f3f18cf6cb7c7f9b' \
--data \
-raw '{
"name": "test",
"email": "[email protected]",
"mobile": "1234567890",
"ifsc": "ABCD0123456",
"vpa": "test@upi",
"cardNo": "1234567890123456",
"beneCode": "BENECODE123"
}'
Response parameters
| Parameter | Description |
|---|---|
| status | This parameter returns the status of web service call. The status can be any of the following: - 0 - If web service call succeeded - 1 - If web service call failed |
| msg | This parameter returns the success or failure message. |
| code | This parameter returns the error code if the API failed to verify or invalid details. |
| data | This parameter returns the saved card details in a JSON format. For more information, refer to the next table. |
Description of data JSON Fields
| Field | Description |
|---|---|
| beneficiaryId | This field returns PayU beneficiary ID for the beneficiary added. |
| name | This field returns the beneficiary name. |
| This field returns the email ID of the beneficiary. | |
| mobile | This field returns the mobile number of the beneficiary. |
| accountNo | This fields returns the account number of the beneficiary. |
| ifsc | This field returns the IFSC code of the bank brach with which the beneficiary holds the account. |
| vpa | This field returns the VPA ID of the beneficiary if they have registered for UPI. |
| merchantId | This field returns the PayU merchant ID of the beneficiary. |
| isValid | This field returns any of the following values to indicate whether the account is valid or not: |
| addedOn | This field returns any of the date and time stamp when the beneficiary was added with PayU. |
| updatedOn | This field returns any of the date and time stamp when the beneficiary details were updated with PayU. |
| isVerified | This field returns any of the following values to indicate account was verified by PayU. The value null is returned if the account is yet to be verified. |
| nameWithBank | This field returns the beneficiary name as in the bank records. |
| cardNo | This field returns the card number if the beneficiary holds a card with bank. |
Sample response
- Success scenario
{
"status": 0,
"msg": "Beneficiary Created with Id :16",
"code": null,
"data": {
"beneficiaryId": 16,
"name": "Deepak",
"email": "[email protected]",
"mobile": "1234567890",
"accountNo": "12",
"ifsc": "ICIC1234567",
"vpa": null,
"merchantId": 1111167,
"isValid": true,
"addedOn": "2020-06-22T08:13:37.000+0000",
"updatedOn": "2020-06-22T08:13:37.000+0000",
"isVerified": null,
"nameWithBank": null,
"cardNo": null
}
- Failure scenario
{
"status": 0,
"msg": null,
"code": null,
"data": {
"error": "card beneficiary creation is not supported",
"errorCodes": [
1018
]
}
}