Update a Beneficiary

Overview

Updates an existing beneficiary's metadata, address, or banking parameters. Requires review and triggers a status webhook upon approval.

HTTP Request

PUT /banking/ibans/v2/profile/v2.1/beneficiaries/{id}

Authentication

This endpoint requires an active Bearer JWT token in the Authorization header obtained via POST /banking/ibans/v2/users/login:

Authorization: Bearer <your_access_token>

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Unique numerical identifier of the beneficiary to update (e.g. 283)

Request Body Fields

Field	Type	Description
beneficiaryEntityType	str	Sample value: company
beneficiaryFirstName	str	Sample value: ``
beneficiaryLastName	str	Sample value: ``
beneficiaryCompanyName	str	Sample value: Verto
currency	str	Sample value: INR
beneficiaryCountryCode	str	Sample value: IN
accountNumber	str	Sample value: 2000293918130
nationalId	str	Sample value: PUNB0644100
country	str	Sample value: India

Code Examples

cURL

curl -X PUT "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>" \
  -d '{
  "beneficiaryEntityType": "company",
  "beneficiaryFirstName": "",
  "beneficiaryLastName": "",
  "beneficiaryCompanyName": "Verto",
  "currency": "INR",
  "beneficiaryCountryCode": "IN",
  "accountNumber": "2000293918130",
  "nationalId": "PUNB0644100",
  "country": "India"
}'

JavaScript (Axios)

import axios from 'axios';

const response = await axios.put('https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}', {
  "beneficiaryEntityType": "company",
  "beneficiaryFirstName": "",
  "beneficiaryLastName": "",
  "beneficiaryCompanyName": "Verto",
  "currency": "INR",
  "beneficiaryCountryCode": "IN",
  "accountNumber": "2000293918130",
  "nationalId": "PUNB0644100",
  "country": "India"
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_access_token>'
  }
});

console.log(response.data);

Python (Requests)

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_access_token>" 
}
payload = {
  "beneficiaryEntityType": "company",
  "beneficiaryFirstName": "",
  "beneficiaryLastName": "",
  "beneficiaryCompanyName": "Verto",
  "currency": "INR",
  "beneficiaryCountryCode": "IN",
  "accountNumber": "2000293918130",
  "nationalId": "PUNB0644100",
  "country": "India"
}

response = requests.put(url, json=payload, headers=headers)
print(response.json())

Response (200)

{
  "success": true,
  "account": {
    "id": 283,
    "accountNumber": "2000293918130",
    "bankName": "PUNJAB NATIONAL BANK",
    "beneficiaryAddress": "INSTITUTIONAL AREA, PLOT, NO.05 PNB SWIFT CENTRE - FLOOR 1 GURUGRAM - SECTOR 32",
    "beneficiaryCity": "HARYANA",
    "beneficiaryCompanyName": "Verto",
    "beneficiaryCountryCode": "IN",
    "beneficiaryEntityType": "company",
    "beneficiaryPostcode": "122001",
    "country": "India",
    "reference": "RP-16062022-001",
    "beneficiaryFirstName": "",
    "beneficiaryLastName": "",
    "nationalId": "PUNB0644100",
    "currency": "INR",
    "clientReference": null,
    "status": "approved"
  }
}

Interactive API Explorer

Test this endpoint live against the Ahrvo gateway and Verto sandbox environments: