Update Recipient

Overview

If a recipient already exists on the platform with an AVAILABLE or DECLINED status, you can call this method to update any of their details. The request will result in a full data update.

Resource Access

• HTTP Method: POST
• Endpoint: /banking/iban/api/recipient/v2/update
• Authentication: Bearer token required

Request Headers

Header	Value	Required	Description
Accept	application/json	Yes	Content type for the response
Authorization	Bearer {access_token}	Yes	Bearer token for authentication
Content-Type	application/json	Yes	Request body content type
on-behalf-of	string	No	Customer ID for on-behalf-of operations

Request Body

{
  "biz_id": "R202412311029369694",
  "holder_type": "PERSONAL",
  "account_type": "RECIPIENT_BANK",
  "bank_detail": {
    "currency": "INR",
    "account_name": "SHASHANK VIJAYSHANKAR TIWARI",
    "account_no": "7039650261",
    "bank_name": "BANK OF BARODA",
    "location": "IN",
    "swift_code": "BARBINBBIBK"
  },
  "recipient_detail": {
    "recipient_type": "20",
    "recipient_location": "IN",
    "email": "recipient@example.com",
    "address": "SUMAN HEIGHTS LODHA HERITAGE",
    "name": "SHASHANK VIJAYSHANKAR TIWARI"
  }
}

Request Fields

Field	Type	Required	Description
biz_id	string	No	Recipient ID (if updating by ID)
holder_type	string	Yes	PERSONAL or BUSINESS
account_type	string	Yes	RECIPIENT_BANK
bank_detail	object	Yes	Banking information
recipient_detail	object	Yes	Recipient personal information

Response

Success Response (200 OK)

{
  "biz_id": "R202412311029369694",
  "status": "PENDING",
  "updated_at": "2026-01-14T10:00:00.000Z",
  "message": "Recipient updated successfully. Pending verification."
}

Response Fields

Field	Type	Description
biz_id	string	Recipient identifier
status	string	Current recipient status
updated_at	string (date-time)	Update timestamp
message	string	Status message

Error Responses

• 400 Bad Request: Invalid input data
• 401 Unauthorized: Invalid or missing authentication token
• 404 Not Found: Recipient not found
• 409 Conflict: Cannot update recipient with current status

Code Examples

cURL

curl -X POST \
  'https://gateway.ahrvo.network/banking/iban/api/recipient/v2/update' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "biz_id": "R202412311029369694",
    "holder_type": "PERSONAL",
    "account_type": "RECIPIENT_BANK",
    "bank_detail": {},
    "recipient_detail": {}
  }'

Python

import requests

url = "https://gateway.ahrvo.network/banking/iban/api/recipient/v2/update"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "biz_id": "R202412311029369694",
    "holder_type": "PERSONAL",
    "account_type": "RECIPIENT_BANK",
    "bank_detail": {},
    "recipient_detail": {}
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

JavaScript (Node.js)

const axios = require('axios');

const url = 'https://gateway.ahrvo.network/banking/iban/api/recipient/v2/update';
const headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
  'Content-Type': 'application/json'
};
const data = {
  biz_id: 'R202412311029369694',
  holder_type: 'PERSONAL',
  account_type: 'RECIPIENT_BANK',
  bank_detail: {},
  recipient_detail: {}
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error.response.data);
  });

Usage Notes

• Full data update - all fields must be provided
• Recipient status will be reset to PENDING for re-verification
• Only recipients with AVAILABLE or DECLINED status can be updated
• Cannot update recipients with PENDING status
• Use this endpoint to correct errors or update outdated information

Interactive API Explorer