> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidoc-v1.maniscloud.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidoc-v1.maniscloud.com/_mcp/server. # Update Beneficiary PUT https://api/v1/beneficiaries/%7BbeneficiaryId%7D Content-Type: application/json This API is used to update beneficiary information in the Manis database, as well as that of the PSP beneficiary. This API is used to update the **beneficiary**. The request body contains personal or company information, depending on the `type`. The beneficiary information will be called to the PSP is registered. **Request Body:** | Field | Type | Required | Description | | --- | --- | --- | --- | | `type` | string | Yes | Beneficiary type: `INDIVIDUAL` or `COMPANY`. | | `beneficiaryName` | string | Yes | A custom internal name for the beneficiary. Must be unique. | | `companyInfo` | object | Required if type = COMPANY | Information about the company beneficiary. | | └─ `name` | string | Yes | Company name. | | └─ `registrationNumber` | string | Yes | Company registration number. | | └─ `incorporationCountry` | string | No | The country where the company was incorporated. | | └─ `email` | string | No | The email address of the beneficiary company. | | └─ `phoneCountryCode` | string | No | Phone number country code (e.g., `+84`). | | └─ `phoneNumber` | string | No | Phone number | | └─ `addressCountry` | string | Conditional | Country of the beneficiary address. | | └─ `addressZipCode` | string | No | ZIP/postal code. | | └─ `addressCity` | string | Yes | City of the address. | | └─ `addressStreet` | string | Yes | Street name and number. | | └─ `addressState` | string | No | State/province of the address. | | └─ `addressLocation` | string | No | Additional address info (e.g., suite, building). | | `firstName` | string | Yes | First name of the contact person or individual beneficiary. | | `lastName` | string | Yes | Last name of the contact person or individual beneficiary. | | `dob` | string | No | Date of birth (format: `YYYY-MM-DD`). Applicable for individuals. | | `email` | string | No | Email address of the beneficiary. | | `phoneCountryCode` | string | No | Phone number country code (e.g., `+84`). | | `phoneNumber` | string | No | Phone number. | | `addressCountry` | string | Yes | Country of the beneficiary address. | | `addressCity` | string | Yes | City of the address. | | `addressState` | string | No | State/province of the address. | | `addressZipCode` | string | No | ZIP/postal code. | | `addressStreet` | string | Yes | Street name and number. | | `addressLocation` | string | No | Additional address info (e.g., suite, building). | | `identificationType` | string | No | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | No | ID number or code. | | `identificationCustomType` | string | No | Custom identification type (used when `identificationType` is null). | | `description` | string | No | Free text description or note about the beneficiary. | | relationship | string | No | relationship with the customer | | accountInfo | object | Yes | account information | | └─ `accountType` | string | Yes | account type, one of value: BANK, CARD, WALLET, PROXY, CASH | | └─ `accountNumber` | string | Conditional | Account number of the beneficiary (may be null or optional for some PSPs). | | └─ `currency` | string | Yes | Transaction currency (e.g., `USD`, `SGD`). | | └─ `bankName` | string | No | Beneficiary bank name. | | └─ `bankCity` | string | No | Beneficiary bank city. | | └─ `bankCountry` | string | No | Country of Bank | | └─ `routingCodeType1` | string | No | Local payment routing system. If supplied, a value for routing_code_value_1 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue1` | string | No | The value for any routing system is specified in routing_code_type_1. If supplied, a value for routing_code_type_1 must also be provided. | | └─ `routingCodeType2` | string | No | Local payment routing system. If supplied, a value for routing_code_value_2 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue2` | string | No | The value for any routing system is specified in routing_code_type_2. If supplied, a value for routing_code_type_2 must also be provided. | | └─ `routingCodeType3` | string | No | Local payment routing system. If supplied, a value for routing_code_value_3 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue3` | string | No | The value for any routing system is specified in routing_code_type_3. If supplied, a value for routing_code_type_3 must also be provided. | | └─ `proxyType` | string | Conditional | The proxy type for this payout is MOBILE, UEN, or NRIC | | └─ `proxyValue` | string | Conditional | Proxy values are dependent on proxy type | | └─ `intermediaryBicSwift` | string | no | SWIFT BIC associated with the Intermediary Agent | | └─ `payId` | string | No (Finmo only) | NPP PayID (AU Specific) | | └─ `payIdType` | string | No (Finmo only) | Mention the type of PayID, it takes values \["EMAIL, PHONE, ORG, ABN"\] | #### **Response Body** 200 OK | Field | Type | Description | | --- | --- | --- | | `id` | string | Identifier of the beneficiary in manis | | `merchantId` | string | merchant id | | `customerId` | string | ID of the customer | | `type` | string | Beneficiary type: `INDIVIDUAL` or `COMPANY`. | | `beneficiaryName` | string | A custom internal name for the beneficiary. Must be unique. | | `companyInfo` | object | Information about the company beneficiary. | | └─ `name` | string | Company name. | | └─ `registrationNumber` | string | Company registration number. | | └─ `incorporationCountry` | string | The country where the company was incorporated. | | └─ `email` | string | The email address of the beneficiary company. | | └─ `phoneCountryCode` | string | Phone number country code (e.g., `+84`). | | └─ `phoneNumber` | string | Phone number | | └─ `addressCountry` | string | Country of the beneficiary address. | | └─ `addressZipCode` | string | ZIP/postal code. | | └─ `addressCity` | string | City of the address. | | └─ `addressStreet` | string | Street name and number. | | └─ `addressState` | string | State/province of the address. | | └─ `addressLocation` | string | Additional address info (e.g., suite, building). | | └─ `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `createdBy` | string | | | └─ `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `updatedBy` | string | | | `firstName` | string | First name of the contact person or individual beneficiary. | | `lastName` | string | Last name of the contact person or individual beneficiary. | | `dob` | string | Date of birth (format: `YYYY-MM-DD`). Applicable for individuals. | | `email` | string | Email address of the beneficiary. | | `phoneCountryCode` | string | Phone number country code (e.g., `+84`). | | `phoneNumber` | string | Phone number. | | `addressCountry` | string | Country of the beneficiary address. | | `addressCity` | string | City of the address. | | `addressState` | string | State/province of the address. | | `addressZipCode` | string | ZIP/postal code. | | `addressStreet` | string | Street name and number. | | `addressLocation` | string | Additional address info (e.g., suite, building). | | `identificationType` | string | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | ID number or code. | | `identificationCustomType` | string | Custom identification type (used when `identificationType` is null). | | `description` | string | Free text description or note about the beneficiary. | | `relationship` | string | relationship with the customer | | `accountInfo` | object | account information | | └─ `accountType` | string | account type, one of value: BANK, CARD, WALLET, PROXY, CASH | | └─ `accountNumber` | string | Account number of the beneficiary (may be null or optional for some PSPs). | | └─ `currency` | string | Transaction currency (e.g., `USD`, `SGD`). | | └─ `bankName` | string | Beneficiary bank name. | | └─ `bankCity` | string | Beneficiary bank city. | | └─ `bankCountry` | string | Country of bank | | └─ `routingCodeType1` | string | Local payment routing system. If supplied, a value for routing_code_value_1 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue1` | string | The value for any routing system is specified in routing_code_type_1. If supplied, a value for routing_code_type_1 must also be provided. | | └─ `routingCodeType2` | string | Local payment routing system. If supplied, a value for routing_code_value_2 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue2` | string | The value for any routing system is specified in routing_code_type_2. If supplied, a value for routing_code_type_2 must also be provided. | | └─ `routingCodeType3` | string | Local payment routing system. If supplied, a value for routing_code_value_3 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue3` | string | The value for any routing system is specified in routing_code_type_3. If supplied, a value for routing_code_type_3 must also be provided. | | └─ `proxyType` | string | Proxy type for this payout is MOBILE, UEN, or NRIC | | └─ `proxyValue` | string | Proxy values are dependent on proxy type | | └─ `intermediaryBicSwift` | string | SWIFT BIC associated with the Intermediary Agent | | └─ `payId` | string | NPP PayID (AU Specific) | | └─ `payIdType` | string | Mention the type of PayID, it takes values \["EMAIL, PHONE, ORG, ABN"\] | | └─ `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `createdBy` | string | | | └─ `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ updatedBy | string | | | pspResults | array | | | └─ pspId | string | ID of the PSP | | └─ pspName | string | Name of the PSP | | └─ success | string | Status update from PSP | | └─ errorMessage | string | Error message | | `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `createdBy` | string | | | `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `updatedBy` | string | | 400 BAD REQUEST | **Field** | **Type** | | --- | --- | | `type` | string | | `status` | number | | `timestamp` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | `title` | string | | `soaCode` | string | | `fieldErrors` | array | | └─ `object` | string | | └─ `field` | string | | └─ `rejectedValue` | string | | └─ `message` | string | 401 UNAUTHORIZED Reference: https://apidoc-v1.maniscloud.com/manis-unified-api-v-1-0/payout-beneficiary/update-beneficiary ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /api/v1/beneficiaries/%7BbeneficiaryId%7D: put: operationId: update-beneficiary summary: Update Beneficiary description: >- This API is used to update beneficiary information in the Manis database, as well as that of the PSP beneficiary. This API is used to update the **beneficiary**. The request body contains personal or company information, depending on the `type`. The beneficiary information will be called to the PSP is registered. **Request Body:** | Field | Type | Required | Description | | --- | --- | --- | --- | | `type` | string | Yes | Beneficiary type: `INDIVIDUAL` or `COMPANY`. | | `beneficiaryName` | string | Yes | A custom internal name for the beneficiary. Must be unique. | | `companyInfo` | object | Required if type = COMPANY | Information about the company beneficiary. | | └─ `name` | string | Yes | Company name. | | └─ `registrationNumber` | string | Yes | Company registration number. | | └─ `incorporationCountry` | string | No | The country where the company was incorporated. | | └─ `email` | string | No | The email address of the beneficiary company. | | └─ `phoneCountryCode` | string | No | Phone number country code (e.g., `+84`). | | └─ `phoneNumber` | string | No | Phone number | | └─ `addressCountry` | string | Conditional | Country of the beneficiary address. | | └─ `addressZipCode` | string | No | ZIP/postal code. | | └─ `addressCity` | string | Yes | City of the address. | | └─ `addressStreet` | string | Yes | Street name and number. | | └─ `addressState` | string | No | State/province of the address. | | └─ `addressLocation` | string | No | Additional address info (e.g., suite, building). | | `firstName` | string | Yes | First name of the contact person or individual beneficiary. | | `lastName` | string | Yes | Last name of the contact person or individual beneficiary. | | `dob` | string | No | Date of birth (format: `YYYY-MM-DD`). Applicable for individuals. | | `email` | string | No | Email address of the beneficiary. | | `phoneCountryCode` | string | No | Phone number country code (e.g., `+84`). | | `phoneNumber` | string | No | Phone number. | | `addressCountry` | string | Yes | Country of the beneficiary address. | | `addressCity` | string | Yes | City of the address. | | `addressState` | string | No | State/province of the address. | | `addressZipCode` | string | No | ZIP/postal code. | | `addressStreet` | string | Yes | Street name and number. | | `addressLocation` | string | No | Additional address info (e.g., suite, building). | | `identificationType` | string | No | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | No | ID number or code. | | `identificationCustomType` | string | No | Custom identification type (used when `identificationType` is null). | | `description` | string | No | Free text description or note about the beneficiary. | | relationship | string | No | relationship with the customer | | accountInfo | object | Yes | account information | | └─ `accountType` | string | Yes | account type, one of value: BANK, CARD, WALLET, PROXY, CASH | | └─ `accountNumber` | string | Conditional | Account number of the beneficiary (may be null or optional for some PSPs). | | └─ `currency` | string | Yes | Transaction currency (e.g., `USD`, `SGD`). | | └─ `bankName` | string | No | Beneficiary bank name. | | └─ `bankCity` | string | No | Beneficiary bank city. | | └─ `bankCountry` | string | No | Country of Bank | | └─ `routingCodeType1` | string | No | Local payment routing system. If supplied, a value for routing_code_value_1 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue1` | string | No | The value for any routing system is specified in routing_code_type_1. If supplied, a value for routing_code_type_1 must also be provided. | | └─ `routingCodeType2` | string | No | Local payment routing system. If supplied, a value for routing_code_value_2 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue2` | string | No | The value for any routing system is specified in routing_code_type_2. If supplied, a value for routing_code_type_2 must also be provided. | | └─ `routingCodeType3` | string | No | Local payment routing system. If supplied, a value for routing_code_value_3 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue3` | string | No | The value for any routing system is specified in routing_code_type_3. If supplied, a value for routing_code_type_3 must also be provided. | | └─ `proxyType` | string | Conditional | The proxy type for this payout is MOBILE, UEN, or NRIC | | └─ `proxyValue` | string | Conditional | Proxy values are dependent on proxy type | | └─ `intermediaryBicSwift` | string | no | SWIFT BIC associated with the Intermediary Agent | | └─ `payId` | string | No (Finmo only) | NPP PayID (AU Specific) | | └─ `payIdType` | string | No (Finmo only) | Mention the type of PayID, it takes values \["EMAIL, PHONE, ORG, ABN"\] | #### **Response Body** 200 OK | Field | Type | Description | | --- | --- | --- | | `id` | string | Identifier of the beneficiary in manis | | `merchantId` | string | merchant id | | `customerId` | string | ID of the customer | | `type` | string | Beneficiary type: `INDIVIDUAL` or `COMPANY`. | | `beneficiaryName` | string | A custom internal name for the beneficiary. Must be unique. | | `companyInfo` | object | Information about the company beneficiary. | | └─ `name` | string | Company name. | | └─ `registrationNumber` | string | Company registration number. | | └─ `incorporationCountry` | string | The country where the company was incorporated. | | └─ `email` | string | The email address of the beneficiary company. | | └─ `phoneCountryCode` | string | Phone number country code (e.g., `+84`). | | └─ `phoneNumber` | string | Phone number | | └─ `addressCountry` | string | Country of the beneficiary address. | | └─ `addressZipCode` | string | ZIP/postal code. | | └─ `addressCity` | string | City of the address. | | └─ `addressStreet` | string | Street name and number. | | └─ `addressState` | string | State/province of the address. | | └─ `addressLocation` | string | Additional address info (e.g., suite, building). | | └─ `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `createdBy` | string | | | └─ `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `updatedBy` | string | | | `firstName` | string | First name of the contact person or individual beneficiary. | | `lastName` | string | Last name of the contact person or individual beneficiary. | | `dob` | string | Date of birth (format: `YYYY-MM-DD`). Applicable for individuals. | | `email` | string | Email address of the beneficiary. | | `phoneCountryCode` | string | Phone number country code (e.g., `+84`). | | `phoneNumber` | string | Phone number. | | `addressCountry` | string | Country of the beneficiary address. | | `addressCity` | string | City of the address. | | `addressState` | string | State/province of the address. | | `addressZipCode` | string | ZIP/postal code. | | `addressStreet` | string | Street name and number. | | `addressLocation` | string | Additional address info (e.g., suite, building). | | `identificationType` | string | Type of ID document (e.g., `PASSPORT`, `NATIONAL_ID`). | | `identificationValue` | string | ID number or code. | | `identificationCustomType` | string | Custom identification type (used when `identificationType` is null). | | `description` | string | Free text description or note about the beneficiary. | | `relationship` | string | relationship with the customer | | `accountInfo` | object | account information | | └─ `accountType` | string | account type, one of value: BANK, CARD, WALLET, PROXY, CASH | | └─ `accountNumber` | string | Account number of the beneficiary (may be null or optional for some PSPs). | | └─ `currency` | string | Transaction currency (e.g., `USD`, `SGD`). | | └─ `bankName` | string | Beneficiary bank name. | | └─ `bankCity` | string | Beneficiary bank city. | | └─ `bankCountry` | string | Country of bank | | └─ `routingCodeType1` | string | Local payment routing system. If supplied, a value for routing_code_value_1 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue1` | string | The value for any routing system is specified in routing_code_type_1. If supplied, a value for routing_code_type_1 must also be provided. | | └─ `routingCodeType2` | string | Local payment routing system. If supplied, a value for routing_code_value_2 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue2` | string | The value for any routing system is specified in routing_code_type_2. If supplied, a value for routing_code_type_2 must also be provided. | | └─ `routingCodeType3` | string | Local payment routing system. If supplied, a value for routing_code_value_3 must also be provided.
Enum: ABA
BSB
BIC_SWIFT
BANK_CODE
BRANCH_CODE
IFSC
IBAN
SORT_CODE | | └─ `routingCodeValue3` | string | The value for any routing system is specified in routing_code_type_3. If supplied, a value for routing_code_type_3 must also be provided. | | └─ `proxyType` | string | Proxy type for this payout is MOBILE, UEN, or NRIC | | └─ `proxyValue` | string | Proxy values are dependent on proxy type | | └─ `intermediaryBicSwift` | string | SWIFT BIC associated with the Intermediary Agent | | └─ `payId` | string | NPP PayID (AU Specific) | | └─ `payIdType` | string | Mention the type of PayID, it takes values \["EMAIL, PHONE, ORG, ABN"\] | | └─ `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ `createdBy` | string | | | └─ `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | └─ updatedBy | string | | | pspResults | array | | | └─ pspId | string | ID of the PSP | | └─ pspName | string | Name of the PSP | | └─ success | string | Status update from PSP | | └─ errorMessage | string | Error message | | `createdAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `createdBy` | string | | | `updatedAt` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | | `updatedBy` | string | | 400 BAD REQUEST | **Field** | **Type** | | --- | --- | | `type` | string | | `status` | number | | `timestamp` | date(yyyy-MM-dd'T'HH:mm:ss.SSS'Z') | | `title` | string | | `soaCode` | string | | `fieldErrors` | array | | └─ `object` | string | | └─ `field` | string | | └─ `rejectedValue` | string | | └─ `message` | string | 401 UNAUTHORIZED tags: - subpackage_payoutBeneficiary responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/Payout Beneficiary_Update Beneficiary_Response_200 requestBody: content: application/json: schema: type: object properties: type: type: string accountInfo: $ref: >- #/components/schemas/ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaAccountInfo companyInfo: $ref: >- #/components/schemas/ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaCompanyInfo description: type: string beneficiaryName: type: string required: - type - accountInfo - companyInfo - description - beneficiaryName servers: - url: https:/ description: https://{url} components: schemas: ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaAccountInfo: type: object properties: payId: type: string format: email bankName: type: string currency: type: string payIdType: type: string proxyType: type: string proxyValue: type: string accountType: type: string accountNumber: type: string routingCodeType1: type: string routingCodeType2: type: string routingCodeValue1: type: string routingCodeValue2: type: string intermediaryBicSwift: type: string required: - payId - bankName - currency - payIdType - proxyType - proxyValue - accountType - accountNumber - routingCodeType1 - routingCodeType2 - routingCodeValue1 - routingCodeValue2 - intermediaryBicSwift title: >- ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaAccountInfo ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaCompanyInfo: type: object properties: name: type: string email: type: string format: email addressCity: type: string phoneNumber: type: string addressState: type: string addressStreet: type: string addressCountry: type: string addressZipCode: type: string addressLocation: type: string phoneCountryCode: type: string registrationNumber: type: string incorporationCountry: type: string required: - name - email - addressCity - phoneNumber - addressState - addressStreet - addressCountry - addressZipCode - addressLocation - phoneCountryCode - registrationNumber - incorporationCountry title: >- ApiV1Beneficiaries7BbeneficiaryId7DPutRequestBodyContentApplicationJsonSchemaCompanyInfo ApiV1Beneficiaries7BbeneficiaryId7DPutResponsesContentApplicationJsonSchemaAccountInfo: type: object properties: payId: type: string format: email bankName: type: string currency: type: string payIdType: type: string proxyType: type: string proxyValue: type: string accountType: type: string accountNumber: type: string routingCodeType1: type: string routingCodeType2: type: string routingCodeValue1: type: string routingCodeValue2: type: string intermediaryBicSwift: type: string required: - payId - bankName - currency - payIdType - proxyType - proxyValue - accountType - accountNumber - routingCodeType1 - routingCodeType2 - routingCodeValue1 - routingCodeValue2 - intermediaryBicSwift title: >- ApiV1Beneficiaries7BbeneficiaryId7DPutResponsesContentApplicationJsonSchemaAccountInfo Payout Beneficiary_Update Beneficiary_Response_200: type: object properties: id: type: string type: type: string email: type: string format: email lastName: type: string createdAt: type: string format: date-time createdBy: type: string format: uuid firstName: type: string updatedAt: type: string format: date-time updatedBy: type: string format: uuid customerId: type: string merchantId: type: string pspResults: type: array items: description: Any type accountInfo: $ref: >- #/components/schemas/ApiV1Beneficiaries7BbeneficiaryId7DPutResponsesContentApplicationJsonSchemaAccountInfo addressCity: type: string description: type: string phoneNumber: type: string addressState: type: string addressStreet: type: string addressCountry: type: string addressZipCode: type: string addressLocation: type: string beneficiaryName: type: string phoneCountryCode: type: string required: - id - type - email - lastName - createdAt - createdBy - firstName - updatedAt - updatedBy - customerId - merchantId - pspResults - accountInfo - addressCity - description - phoneNumber - addressState - addressStreet - addressCountry - addressZipCode - addressLocation - beneficiaryName - phoneCountryCode title: Payout Beneficiary_Update Beneficiary_Response_200 ``` ## Examples ### 400: Bad request **Request** ```json undefined ``` **Response** ```json { "id": "string", "type": "https://api-docs.manis.com/problems/validation-error", "email": "string", "lastName": "string", "createdAt": "2024-01-15T09:30:00Z", "createdBy": "string", "firstName": "string", "updatedAt": "2024-01-15T09:30:00Z", "updatedBy": "string", "customerId": "string", "merchantId": "string", "pspResults": [ null ], "accountInfo": { "payId": "string", "bankName": "string", "currency": "string", "payIdType": "string", "proxyType": "string", "proxyValue": "string", "accountType": "string", "accountNumber": "string", "routingCodeType1": "string", "routingCodeType2": "string", "routingCodeValue1": "string", "routingCodeValue2": "string", "intermediaryBicSwift": "string" }, "addressCity": "string", "description": "string", "phoneNumber": "string", "addressState": "string", "addressStreet": "string", "addressCountry": "string", "addressZipCode": "string", "addressLocation": "string", "beneficiaryName": "string", "phoneCountryCode": "string", "title": "Input data is invalid", "status": 400, "soaCode": "4000", "timestamp": "2025-07-30T23:47:47.248Z", "fieldErrors": [ { "field": "accountInfo.currency", "object": "updateBeneficiaryRequestDto", "message": "Invalid currency code", "rejectedValue": "USDF" } ] } ``` **SDK Code** ```python 400: Bad request import requests url = "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" headers = {"Content-Type": "application/json"} response = requests.put(url, headers=headers) print(response.json()) ``` ```javascript 400: Bad request const url = 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D'; const options = {method: 'PUT', headers: {'Content-Type': 'application/json'}, body: undefined}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go 400: Bad request package main import ( "fmt" "net/http" "io" ) func main() { url := "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" req, _ := http.NewRequest("PUT", url, nil) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby 400: Bad request require 'uri' require 'net/http' url = URI("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Content-Type"] = 'application/json' response = http.request(request) puts response.read_body ``` ```java 400: Bad request import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") .header("Content-Type", "application/json") .asString(); ``` ```php 400: Bad request request('PUT', 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D', [ 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp 400: Bad request using RestSharp; var client = new RestClient("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D"); var request = new RestRequest(Method.PUT); request.AddHeader("Content-Type", "application/json"); IRestResponse response = client.Execute(request); ``` ```swift 400: Bad request import Foundation let headers = ["Content-Type": "application/json"] let request = NSMutableURLRequest(url: NSURL(string: "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### 200: Update Beneficiary **Request** ```json undefined ``` **Response** ```json { "id": "benef-01k0s4mfyvwp3dp4n328tc08q4", "type": "INDIVIDUAL", "email": "testNiumIndividual104@gmail.com", "lastName": "Miracle", "createdAt": "2025-06-11T09:41:39.838Z", "createdBy": "7eea1a78-6e23-49e4-a6c7-31d3181edb56", "firstName": "Nigma", "updatedAt": "2025-06-11T09:41:39.838Z", "updatedBy": "7eea1a78-6e23-49e4-a6c7-31d3181edb56", "customerId": "cus-01k0s4dm5g62ts91et7gk59rbv", "merchantId": "merch-01k0rbsaxefz0j7f88xreveszy", "pspResults": [], "accountInfo": { "payId": "email@gmail.com", "bankName": "Bank of America", "currency": "USD", "payIdType": "EMAIL", "proxyType": "MOBILE", "proxyValue": "+919021221212", "accountType": "BANK", "accountNumber": "318351267899", "routingCodeType1": "BIC_SWIFT", "routingCodeType2": "ABA", "routingCodeValue1": "BOFAUS3N", "routingCodeValue2": "121000358", "intermediaryBicSwift": "intermediaryBicSwift" }, "addressCity": "City", "description": "description", "phoneNumber": "0904547087", "addressState": "State", "addressStreet": "Street1", "addressCountry": "US", "addressZipCode": "1000", "addressLocation": "Location1", "beneficiaryName": "beneficiary indicidual with SG dev", "phoneCountryCode": "+84" } ``` **SDK Code** ```python 200: Update Beneficiary import requests url = "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" headers = {"Content-Type": "application/json"} response = requests.put(url, headers=headers) print(response.json()) ``` ```javascript 200: Update Beneficiary const url = 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D'; const options = {method: 'PUT', headers: {'Content-Type': 'application/json'}, body: undefined}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go 200: Update Beneficiary package main import ( "fmt" "net/http" "io" ) func main() { url := "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" req, _ := http.NewRequest("PUT", url, nil) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby 200: Update Beneficiary require 'uri' require 'net/http' url = URI("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Content-Type"] = 'application/json' response = http.request(request) puts response.read_body ``` ```java 200: Update Beneficiary import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") .header("Content-Type", "application/json") .asString(); ``` ```php 200: Update Beneficiary request('PUT', 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D', [ 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp 200: Update Beneficiary using RestSharp; var client = new RestClient("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D"); var request = new RestRequest(Method.PUT); request.AddHeader("Content-Type", "application/json"); IRestResponse response = client.Execute(request); ``` ```swift 200: Update Beneficiary import Foundation let headers = ["Content-Type": "application/json"] let request = NSMutableURLRequest(url: NSURL(string: "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Payout Beneficiary_Update Beneficiary_example **Request** ```json { "type": "COMPANY", "accountInfo": { "payId": "email@gmail.com", "bankName": "Bank of America", "currency": "USD", "payIdType": "EMAIL", "proxyType": "MOBILE", "proxyValue": "+919021221212", "accountType": "BANK", "accountNumber": "318351267899", "routingCodeType1": "BIC_SWIFT", "routingCodeType2": "ABA", "routingCodeValue1": "BOFAUS3N", "routingCodeValue2": "121000358", "intermediaryBicSwift": "IRVTUS3NXXX" }, "companyInfo": { "name": "Nigma Miracle", "email": "email_@gmail.com", "addressCity": "City", "phoneNumber": "0904547087", "addressState": "State", "addressStreet": "Street", "addressCountry": "US", "addressZipCode": "1000", "addressLocation": "Location", "phoneCountryCode": "+84", "registrationNumber": "123456", "incorporationCountry": "US" }, "description": "description", "beneficiaryName": "beneficiary company with US dev" } ``` **Response** ```json { "id": "string", "type": "https://api-docs.manis.com/problems/validation-error", "email": "string", "lastName": "string", "createdAt": "2024-01-15T09:30:00Z", "createdBy": "string", "firstName": "string", "updatedAt": "2024-01-15T09:30:00Z", "updatedBy": "string", "customerId": "string", "merchantId": "string", "pspResults": [ null ], "accountInfo": { "payId": "string", "bankName": "string", "currency": "string", "payIdType": "string", "proxyType": "string", "proxyValue": "string", "accountType": "string", "accountNumber": "string", "routingCodeType1": "string", "routingCodeType2": "string", "routingCodeValue1": "string", "routingCodeValue2": "string", "intermediaryBicSwift": "string" }, "addressCity": "string", "description": "string", "phoneNumber": "string", "addressState": "string", "addressStreet": "string", "addressCountry": "string", "addressZipCode": "string", "addressLocation": "string", "beneficiaryName": "string", "phoneCountryCode": "string", "title": "Input data is invalid", "status": 400, "soaCode": "4000", "timestamp": "2025-07-30T23:47:47.248Z", "fieldErrors": [ { "field": "accountInfo.currency", "object": "updateBeneficiaryRequestDto", "message": "Invalid currency code", "rejectedValue": "USDF" } ] } ``` **SDK Code** ```python Payout Beneficiary_Update Beneficiary_example import requests url = "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" payload = { "type": "COMPANY", "accountInfo": { "payId": "email@gmail.com", "bankName": "Bank of America", "currency": "USD", "payIdType": "EMAIL", "proxyType": "MOBILE", "proxyValue": "+919021221212", "accountType": "BANK", "accountNumber": "318351267899", "routingCodeType1": "BIC_SWIFT", "routingCodeType2": "ABA", "routingCodeValue1": "BOFAUS3N", "routingCodeValue2": "121000358", "intermediaryBicSwift": "IRVTUS3NXXX" }, "companyInfo": { "name": "Nigma Miracle", "email": "email_@gmail.com", "addressCity": "City", "phoneNumber": "0904547087", "addressState": "State", "addressStreet": "Street", "addressCountry": "US", "addressZipCode": "1000", "addressLocation": "Location", "phoneCountryCode": "+84", "registrationNumber": "123456", "incorporationCountry": "US" }, "description": "description", "beneficiaryName": "beneficiary company with US dev" } headers = {"Content-Type": "application/json"} response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Payout Beneficiary_Update Beneficiary_example const url = 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D'; const options = { method: 'PUT', headers: {'Content-Type': 'application/json'}, body: '{"type":"COMPANY","accountInfo":{"payId":"email@gmail.com","bankName":"Bank of America","currency":"USD","payIdType":"EMAIL","proxyType":"MOBILE","proxyValue":"+919021221212","accountType":"BANK","accountNumber":"318351267899","routingCodeType1":"BIC_SWIFT","routingCodeType2":"ABA","routingCodeValue1":"BOFAUS3N","routingCodeValue2":"121000358","intermediaryBicSwift":"IRVTUS3NXXX"},"companyInfo":{"name":"Nigma Miracle","email":"email_@gmail.com","addressCity":"City","phoneNumber":"0904547087","addressState":"State","addressStreet":"Street","addressCountry":"US","addressZipCode":"1000","addressLocation":"Location","phoneCountryCode":"+84","registrationNumber":"123456","incorporationCountry":"US"},"description":"description","beneficiaryName":"beneficiary company with US dev"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Payout Beneficiary_Update Beneficiary_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D" payload := strings.NewReader("{\n \"type\": \"COMPANY\",\n \"accountInfo\": {\n \"payId\": \"email@gmail.com\",\n \"bankName\": \"Bank of America\",\n \"currency\": \"USD\",\n \"payIdType\": \"EMAIL\",\n \"proxyType\": \"MOBILE\",\n \"proxyValue\": \"+919021221212\",\n \"accountType\": \"BANK\",\n \"accountNumber\": \"318351267899\",\n \"routingCodeType1\": \"BIC_SWIFT\",\n \"routingCodeType2\": \"ABA\",\n \"routingCodeValue1\": \"BOFAUS3N\",\n \"routingCodeValue2\": \"121000358\",\n \"intermediaryBicSwift\": \"IRVTUS3NXXX\"\n },\n \"companyInfo\": {\n \"name\": \"Nigma Miracle\",\n \"email\": \"email_@gmail.com\",\n \"addressCity\": \"City\",\n \"phoneNumber\": \"0904547087\",\n \"addressState\": \"State\",\n \"addressStreet\": \"Street\",\n \"addressCountry\": \"US\",\n \"addressZipCode\": \"1000\",\n \"addressLocation\": \"Location\",\n \"phoneCountryCode\": \"+84\",\n \"registrationNumber\": \"123456\",\n \"incorporationCountry\": \"US\"\n },\n \"description\": \"description\",\n \"beneficiaryName\": \"beneficiary company with US dev\"\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Payout Beneficiary_Update Beneficiary_example require 'uri' require 'net/http' url = URI("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Content-Type"] = 'application/json' request.body = "{\n \"type\": \"COMPANY\",\n \"accountInfo\": {\n \"payId\": \"email@gmail.com\",\n \"bankName\": \"Bank of America\",\n \"currency\": \"USD\",\n \"payIdType\": \"EMAIL\",\n \"proxyType\": \"MOBILE\",\n \"proxyValue\": \"+919021221212\",\n \"accountType\": \"BANK\",\n \"accountNumber\": \"318351267899\",\n \"routingCodeType1\": \"BIC_SWIFT\",\n \"routingCodeType2\": \"ABA\",\n \"routingCodeValue1\": \"BOFAUS3N\",\n \"routingCodeValue2\": \"121000358\",\n \"intermediaryBicSwift\": \"IRVTUS3NXXX\"\n },\n \"companyInfo\": {\n \"name\": \"Nigma Miracle\",\n \"email\": \"email_@gmail.com\",\n \"addressCity\": \"City\",\n \"phoneNumber\": \"0904547087\",\n \"addressState\": \"State\",\n \"addressStreet\": \"Street\",\n \"addressCountry\": \"US\",\n \"addressZipCode\": \"1000\",\n \"addressLocation\": \"Location\",\n \"phoneCountryCode\": \"+84\",\n \"registrationNumber\": \"123456\",\n \"incorporationCountry\": \"US\"\n },\n \"description\": \"description\",\n \"beneficiaryName\": \"beneficiary company with US dev\"\n}" response = http.request(request) puts response.read_body ``` ```java Payout Beneficiary_Update Beneficiary_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D") .header("Content-Type", "application/json") .body("{\n \"type\": \"COMPANY\",\n \"accountInfo\": {\n \"payId\": \"email@gmail.com\",\n \"bankName\": \"Bank of America\",\n \"currency\": \"USD\",\n \"payIdType\": \"EMAIL\",\n \"proxyType\": \"MOBILE\",\n \"proxyValue\": \"+919021221212\",\n \"accountType\": \"BANK\",\n \"accountNumber\": \"318351267899\",\n \"routingCodeType1\": \"BIC_SWIFT\",\n \"routingCodeType2\": \"ABA\",\n \"routingCodeValue1\": \"BOFAUS3N\",\n \"routingCodeValue2\": \"121000358\",\n \"intermediaryBicSwift\": \"IRVTUS3NXXX\"\n },\n \"companyInfo\": {\n \"name\": \"Nigma Miracle\",\n \"email\": \"email_@gmail.com\",\n \"addressCity\": \"City\",\n \"phoneNumber\": \"0904547087\",\n \"addressState\": \"State\",\n \"addressStreet\": \"Street\",\n \"addressCountry\": \"US\",\n \"addressZipCode\": \"1000\",\n \"addressLocation\": \"Location\",\n \"phoneCountryCode\": \"+84\",\n \"registrationNumber\": \"123456\",\n \"incorporationCountry\": \"US\"\n },\n \"description\": \"description\",\n \"beneficiaryName\": \"beneficiary company with US dev\"\n}") .asString(); ``` ```php Payout Beneficiary_Update Beneficiary_example request('PUT', 'https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D', [ 'body' => '{ "type": "COMPANY", "accountInfo": { "payId": "email@gmail.com", "bankName": "Bank of America", "currency": "USD", "payIdType": "EMAIL", "proxyType": "MOBILE", "proxyValue": "+919021221212", "accountType": "BANK", "accountNumber": "318351267899", "routingCodeType1": "BIC_SWIFT", "routingCodeType2": "ABA", "routingCodeValue1": "BOFAUS3N", "routingCodeValue2": "121000358", "intermediaryBicSwift": "IRVTUS3NXXX" }, "companyInfo": { "name": "Nigma Miracle", "email": "email_@gmail.com", "addressCity": "City", "phoneNumber": "0904547087", "addressState": "State", "addressStreet": "Street", "addressCountry": "US", "addressZipCode": "1000", "addressLocation": "Location", "phoneCountryCode": "+84", "registrationNumber": "123456", "incorporationCountry": "US" }, "description": "description", "beneficiaryName": "beneficiary company with US dev" }', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Payout Beneficiary_Update Beneficiary_example using RestSharp; var client = new RestClient("https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D"); var request = new RestRequest(Method.PUT); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"type\": \"COMPANY\",\n \"accountInfo\": {\n \"payId\": \"email@gmail.com\",\n \"bankName\": \"Bank of America\",\n \"currency\": \"USD\",\n \"payIdType\": \"EMAIL\",\n \"proxyType\": \"MOBILE\",\n \"proxyValue\": \"+919021221212\",\n \"accountType\": \"BANK\",\n \"accountNumber\": \"318351267899\",\n \"routingCodeType1\": \"BIC_SWIFT\",\n \"routingCodeType2\": \"ABA\",\n \"routingCodeValue1\": \"BOFAUS3N\",\n \"routingCodeValue2\": \"121000358\",\n \"intermediaryBicSwift\": \"IRVTUS3NXXX\"\n },\n \"companyInfo\": {\n \"name\": \"Nigma Miracle\",\n \"email\": \"email_@gmail.com\",\n \"addressCity\": \"City\",\n \"phoneNumber\": \"0904547087\",\n \"addressState\": \"State\",\n \"addressStreet\": \"Street\",\n \"addressCountry\": \"US\",\n \"addressZipCode\": \"1000\",\n \"addressLocation\": \"Location\",\n \"phoneCountryCode\": \"+84\",\n \"registrationNumber\": \"123456\",\n \"incorporationCountry\": \"US\"\n },\n \"description\": \"description\",\n \"beneficiaryName\": \"beneficiary company with US dev\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Payout Beneficiary_Update Beneficiary_example import Foundation let headers = ["Content-Type": "application/json"] let parameters = [ "type": "COMPANY", "accountInfo": [ "payId": "email@gmail.com", "bankName": "Bank of America", "currency": "USD", "payIdType": "EMAIL", "proxyType": "MOBILE", "proxyValue": "+919021221212", "accountType": "BANK", "accountNumber": "318351267899", "routingCodeType1": "BIC_SWIFT", "routingCodeType2": "ABA", "routingCodeValue1": "BOFAUS3N", "routingCodeValue2": "121000358", "intermediaryBicSwift": "IRVTUS3NXXX" ], "companyInfo": [ "name": "Nigma Miracle", "email": "email_@gmail.com", "addressCity": "City", "phoneNumber": "0904547087", "addressState": "State", "addressStreet": "Street", "addressCountry": "US", "addressZipCode": "1000", "addressLocation": "Location", "phoneCountryCode": "+84", "registrationNumber": "123456", "incorporationCountry": "US" ], "description": "description", "beneficiaryName": "beneficiary company with US dev" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://https/api/v1/beneficiaries/%7BbeneficiaryId%7D")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```