---
updatedAt: 2026-11-12T11:25:14.000Z
agentTools:
  projectIndex: https://docs.decentro.tech/llms.txt
---

# Manage Beneficiaries (To be deprecated)

> 🙌 Important Note
>
> Please use only **Staging Credentials** on each API Reference page to test the APIs directly from our Documentation.

### API Endpoints

| Environment       | Endpoint                                                                            |
| :---------------- | :---------------------------------------------------------------------------------- |
| Staging / Sandbox | <https://in.staging.decentro.tech/core_banking/money_transfer/manage_beneficiaries> |
| Production        | <https://in.decentro.tech/core_banking/money_transfer/manage_beneficiaries>         |

[Add / Update / Disable any beneficiary](https://docs.decentro.tech/docs/payments-direct-payouts) for sending money from the virtual account (on top of the underlying physical bank account)

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "decentro-staging",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://in.staging.decentro.tech"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/core_banking/money_transfer/manage_beneficiaries": {
      "post": {
        "summary": "Manage Beneficiaries (To be deprecated)",
        "description": "",
        "operationId": "payments_api-manage-beneficiaries",
        "parameters": [
          {
            "name": "client_id",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "client_secret",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "module_secret",
            "in": "header",
            "description": "Use the accounts module secret",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "provider_secret",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "action",
                  "ifsc_code",
                  "account_number",
                  "beneficiary_code",
                  "transfer_type",
                  "currency_code"
                ],
                "properties": {
                  "action": {
                    "type": "string",
                    "description": "Can be ADD/ VERIFY/ UPDATE/ DEACTIVATE/ DELETE"
                  },
                  "ifsc_code": {
                    "type": "string",
                    "description": "Beneficiary bank IFSC code"
                  },
                  "sender_account_number": {
                    "type": "string",
                    "description": "Account number against which the beneficiary is to be added. If not passed, beneficiary will be added to company's virtual account"
                  },
                  "account_number": {
                    "type": "string",
                    "description": "Beneficiary account number"
                  },
                  "beneficiary_code": {
                    "type": "string",
                    "description": "Unique code assigned by you to the beneficiary. Mandatory only if action is not ADD"
                  },
                  "transfer_type": {
                    "type": "string",
                    "description": "Can be NEFT/ IMPS/ RTGS/ OTHR (for the beneficiary to support all incoming transfer types). If not specified for the ADD action, defaulted to OTHR. Optional only if action is ADD"
                  },
                  "currency_code": {
                    "type": "string",
                    "description": "A valid currency code value such as INR"
                  },
                  "name": {
                    "type": "string",
                    "description": "Beneficiary name to be added, Alphanumeric characters are allowed but special characters such as “@ # $ % ^ & * ! ; : ~ ` ? = + ) ( apostrophe, double quotes” are not allowed. Minimum length is 5 characters and Maximum length is 255 characters"
                  },
                  "email_address": {
                    "type": "string",
                    "description": "A valid email address for the beneficiary. Mandatory only if action is ADD; Optional in case of all other action types"
                  },
                  "mobile_number": {
                    "type": "string",
                    "description": "Beneficiary mobile number. Mandatory only if action is ADD; Optional in case of all other action types"
                  },
                  "email_notification": {
                    "type": "integer",
                    "description": "If the beneficiary needs to be notified by email for transfers. 0 by default",
                    "format": "int32"
                  },
                  "sms_notification": {
                    "type": "integer",
                    "description": "If the beneficiary needs to be notified by SMS for transfers. 0 by default",
                    "format": "int32"
                  }
                }
              },
              "examples": {
                "Action: Verify": {
                  "value": {
                    "action": "verify",
                    "beneficiary_code": "DEC00XXXXXXXXXXXXXIMPS",
                    "account_number": "111111111111111",
                    "ifsc_code": "ABCD0000999",
                    "transfer_type": "IMPS",
                    "currency_code": "INR"
                  }
                },
                "Action: Add": {
                  "value": {
                    "action": "ADD",
                    "sender_account_number": "111111111111110",
                    "name": "Test Name",
                    "ifsc_code": "ABCD0000999",
                    "account_number": "111111111111111",
                    "transfer_type": "IMPS",
                    "currency_code": "INR",
                    "address": "Bengaluru",
                    "email_address": "abcd@mail.com",
                    "mobile_number": "9999999999"
                  }
                },
                "Action: Deactivate": {
                  "value": {
                    "action": "DEACTIVATE",
                    "beneficiary_code": "BENEFICIARY_01",
                    "account_number": "111111111111111",
                    "ifsc_code": "ABCD0000999",
                    "transfer_type": "IMPS",
                    "currency_code": "INR"
                  }
                },
                "Action: Update": {
                  "value": {
                    "action": "update",
                    "beneficiary_code": "DEC00XXXXXXXXXXXXXIMPS",
                    "account_number": "111111111111111",
                    "ifsc_code": "ABCD0000999",
                    "transfer_type": "IMPS",
                    "currency_code": "INR",
                    "name": "Updated Test Name",
                    "email_address": "updatedtest123@mail.com",
                    "mobile_number": "9000000000",
                    "address": "Updated Address"
                  }
                },
                "Action: Delete": {
                  "value": {
                    "action": "DELETE",
                    "beneficiary_code": "BENEFICIARY_01",
                    "account_number": "111111111111111",
                    "ifsc_code": "ABCD0000999",
                    "transfer_type": "IMPS",
                    "currency_code": "INR"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Action: Verify": {
                    "value": "{\n    \"status\": \"success\",\n    \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"accountNumber\": \"00XXXXXXXXXXXXX\",\n    \"ifscCode\": \"XXXXXXXXXX\",\n    \"name\": \"DEC00XXXXXXXXXXXXXIMPS\",\n    \"beneficiaryCode\": \"DEC00XXXXXXXXXXXXXIMPS\"\n}"
                  },
                  "Action: Add": {
                    "value": "{\n    \"status\": \"success\",\n    \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"accountNumber\": \"00XXXXXXXXXXXXX\",\n    \"ifscCode\": \"XXXXXXXXXX\",\n    \"name\": \"DEC00XXXXXXXXXXXXXIMPS\",\n    \"beneficiaryCode\": \"DEC00XXXXXXXXXXXXXIMPS\"\n}"
                  },
                  "Action: Deactivate": {
                    "value": "{\n    \"status\": \"success\",\n    \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"accountNumber\": \"00XXXXXXXXXXXXX\",\n    \"ifscCode\": \"XXXXXXXXXX\",\n    \"name\": \"Test Name\",\n    \"beneficiaryCode\": \"DEC00XXXXXXXXXXXXXIMPS\"\n}"
                  },
                  "Action: Update": {
                    "value": "{\n    \"status\": \"success\",\n    \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"accountNumber\": \"00XXXXXXXXXXXXX\",\n    \"ifscCode\": \"XXXXXXXXXX\",\n    \"name\": \"Updated Test Name\",\n    \"beneficiaryCode\": \"DEC00XXXXXXXXXXXXXIMPS\"\n}"
                  },
                  "Action: Delete": {
                    "value": "{\n    \"status\": \"success\",\n    \"decentroTxnId\": \"DECXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\n    \"accountNumber\": \"00XXXXXXXXXXXXX\",\n    \"ifscCode\": \"XXXXXXXXXX\",\n    \"name\": \"Test Name\",\n    \"beneficiaryCode\": \"DEC00XXXXXXXXXXXXXIMPS\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Action: Verify",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "success"
                        },
                        "decentroTxnId": {
                          "type": "string",
                          "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "00XXXXXXXXXXXXX"
                        },
                        "ifscCode": {
                          "type": "string",
                          "example": "XXXXXXXXXX"
                        },
                        "name": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        },
                        "beneficiaryCode": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        }
                      }
                    },
                    {
                      "title": "Action: Add",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "success"
                        },
                        "decentroTxnId": {
                          "type": "string",
                          "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "00XXXXXXXXXXXXX"
                        },
                        "ifscCode": {
                          "type": "string",
                          "example": "XXXXXXXXXX"
                        },
                        "name": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        },
                        "beneficiaryCode": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        }
                      }
                    },
                    {
                      "title": "Action: Deactivate",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "success"
                        },
                        "decentroTxnId": {
                          "type": "string",
                          "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "00XXXXXXXXXXXXX"
                        },
                        "ifscCode": {
                          "type": "string",
                          "example": "XXXXXXXXXX"
                        },
                        "name": {
                          "type": "string",
                          "example": "Test Name"
                        },
                        "beneficiaryCode": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        }
                      }
                    },
                    {
                      "title": "Action: Update",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "success"
                        },
                        "decentroTxnId": {
                          "type": "string",
                          "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "00XXXXXXXXXXXXX"
                        },
                        "ifscCode": {
                          "type": "string",
                          "example": "XXXXXXXXXX"
                        },
                        "name": {
                          "type": "string",
                          "example": "Updated Test Name"
                        },
                        "beneficiaryCode": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        }
                      }
                    },
                    {
                      "title": "Action: Delete",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "example": "success"
                        },
                        "decentroTxnId": {
                          "type": "string",
                          "example": "DECXXXXXXXXXXXXXXXXXXXXXXXXXXX"
                        },
                        "accountNumber": {
                          "type": "string",
                          "example": "00XXXXXXXXXXXXX"
                        },
                        "ifscCode": {
                          "type": "string",
                          "example": "XXXXXXXXXX"
                        },
                        "name": {
                          "type": "string",
                          "example": "Test Name"
                        },
                        "beneficiaryCode": {
                          "type": "string",
                          "example": "DEC00XXXXXXXXXXXXXIMPS"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```