Update Whitelisted Account

Update details of a customer's already existing whitelisted bank account.

Last updated: 2026-08-03

Endpoint (Requires Authentication)

PATCH /api/v1/connected-banking/public/upi-collection/whitelist

This API endpoint is used to update details of a customer's already existing whitelisted bank account. Only the fields provided in the payload are updated; omitted fields retain their existing values.

Request Headers

Content-Type: application/json
Authorization: Bearer <jwt_token>

Required Fields

The following fields must be encrypted before being sent to the server:

Field	Required	Type	Description
custId	Yes	String	Unique ID of the customer the account belongs to.
accountNumber	Yes	String	Existing bank account number.
ifsc	Yes	String	Existing IFSC code of the bank account.
accountHolderName	Optional	String	Account holder name to be updated.
newAccountNumber	Optional	String	Account number to be updated.
newIfsc	Optional	String	IFSC to be updated.
enableUpi	Optional	Boolean	Whether UPI collection is enabled for this account.
enableVam	Optional	Boolean	Whether VAM (Virtual Account) collection is enabled for this account.

Decrypted Payload Structure

{
  "custId": "828668227300006",
  "accountNumber": "123456789012",
  "ifsc": "SBIN0014121",
  "accountHolderName": "John Doe",
  "newAccountNumber": "987654321012",
  "newIfsc": "SBIN0012345",
  "enableUpi": true,
  "enableVam": false
}

Success Response (Encrypted) (200 OK)

{
  "respCode": 2006,
  "respMessage": "Account updated successfully",
  "data": "WllwZSl5lKfTPpz0JHD4sL8V7pq7Bn+AasFOsEBu1hFNFMi81WiQN7ffjk22rcBC4SItHVpIzaSkvyGImVm4XGdobB...encrypted_data_here"
}

Decrypted Response

{
  "id": "05d21bc2-65dd-44b2-9ea1-faca32c7c975",
  "custId": "828668227300006",
  "accountHolderName": "John Doe",
  "accountNumber": "XXXXXXXX1012",
  "ifsc": "SBINXXXXX45",
  "upiEnabled": true,
  "vamEnabled": false,
  "status": 1
}

All Response Codes

Code	Message
2006	Account updated successfully
4180	No active whitelisted account found for this customer
4181	At least one field to update must be provided
4001	Unauthorized access
5000	Internal server error

PreviousAdd Whitelist Account

NextWebhook Notification

Required Fields

The following fields must be encrypted before being sent to the server:

Field	Required	Type	Description
custId	Yes	String	Unique ID of the customer the account belongs to.
accountNumber	Yes	String	Existing bank account number.
ifsc	Yes	String	Existing IFSC code of the bank account.
accountHolderName	Optional	String	Account holder name to be updated.
newAccountNumber	Optional	String	Account number to be updated.
newIfsc	Optional	String	IFSC to be updated.
enableUpi	Optional	Boolean	Whether UPI collection is enabled for this account.
enableVam	Optional	Boolean	Whether VAM (Virtual Account) collection is enabled for this account.

{ "custId": "828668227300006", "accountNumber": "123456789012", "ifsc": "SBIN0014121", "accountHolderName": "John Doe", "newAccountNumber": "987654321012", "newIfsc": "SBIN0012345", "enableUpi": true, "enableVam": false }

{ "id": "05d21bc2-65dd-44b2-9ea1-faca32c7c975", "custId": "828668227300006", "accountHolderName": "John Doe", "accountNumber": "XXXXXXXX1012", "ifsc": "SBINXXXXX45", "upiEnabled": true, "vamEnabled": false, "status": 1 }

2006

Account updated successfully

4180

No active whitelisted account found for this customer

4181

At least one field to update must be provided

4001

Unauthorized access

5000

Internal server error