AddUpdateUBO

put

https://test-partner.payu.in/api/v1/merchants/{uuid}/signatory_details

Add/Update UBO — Step 12 of 16

Endpoint

PUT /api/v1/merchants/{uuid}/signatory_details

Entity Applicability

Only: Pvt Ltd, Public Ltd, Partnership, Trust, LLP, Society.

Request Body (x-www-form-urlencoded)

Per UBO (indexed: ubo[0], ubo[1], etc.):

Parameter	Type	Required	Description
`merchant[ubo[N][beneficiary_name]]`	string	Yes	Full name
`merchant[ubo[N][ubo_pan_number]]`	string	Yes	PAN number
`merchant[ubo[N][ownership_percent]]`	string	Yes	Ownership %
`merchant[ubo[N][dob]]`	string	Yes	YYYY-MM-DD
`merchant[ubo[N][nationality]]`	string	Yes	ISO country code
`merchant[ubo[N][address][address_line]]`	string	Yes	Address
`merchant[ubo[N][address][pincode]]`	string	Yes	6-digit pincode
`merchant[ubo_exist]`	string	Yes	`"1"`

Response Fields (200 OK — when successful via Postman)

Returns full merchant object including ultimate_beneficiaries[] array with added UBOs.

Error Response Fields

Field	Type	Description
`error`	string	`"param is missing or the value is empty: bank_detail"` — bank_detail params must be included

Multiple UBOs (Up to 4)

Submit up to 4 UBOs in a single request using array indexing ubo[0], ubo[1], ubo[2], ubo[3].

UBOs 0-1 are enabled by default; UBOs 2-3 are disabled — enable as needed
Each UBO requires: beneficiary_name, ubo_pan_number, ownership_percent, dob, nationality, address, pincode
Email is optional but recommended
Total ownership percentages should be consistent with business records
merchant[ubo_exist] must be "1" when any UBOs are submitted

Next Step

Proceed to Step 13 (Business Members) if applicable, or Step 14.

Path Params

uuid

string

required

Merchant UUID from Step 01 create merchant response

Form Data

merchant[ubo[0][beneficiary_name]]

string

UBO 1: Full name of the Ultimate Beneficial Owner.

merchant[ubo[0][ubo_pan_number]]

string

UBO 1: PAN number.

merchant[ubo[0][ownership_percent]]

number

UBO 1: Ownership percentage. UBOs typically own 25%+ of the business.

merchant[ubo[0][dob]]

string

UBO 1: Date of birth. Format: YYYY-MM-DD.

merchant[ubo[0][nationality]]

string

UBO 1: 2-letter ISO country code (e.g., IN for India).

merchant[ubo[0][email]]

string

UBO 1: Email address (optional but recommended).

merchant[ubo[0][address][address_line]]

string

UBO 1: Street address.

merchant[ubo[0][address][pincode]]

integer

UBO 1: 6-digit pincode.

merchant[ubo[1][beneficiary_name]]

string

UBO 2: Full name of the Ultimate Beneficial Owner.

merchant[ubo[1][ubo_pan_number]]

string

UBO 2: PAN number.

merchant[ubo[1][ownership_percent]]

number

UBO 2: Ownership percentage. UBOs typically own 25%+ of the business.

merchant[ubo[1][dob]]

string

UBO 2: Date of birth. Format: YYYY-MM-DD.

merchant[ubo[1][nationality]]

string

UBO 2: 2-letter ISO country code (e.g., IN for India).

merchant[ubo[1][email]]

string

UBO 2: Email address (optional but recommended).

merchant[ubo[1][address][address_line]]

string

UBO 2: Street address.

merchant[ubo[1][address][pincode]]

integer

UBO 2: 6-digit pincode.

merchant[ubo[2][beneficiary_name]]

string

UBO 3: Full name of the Ultimate Beneficial Owner.

merchant[ubo[2][ubo_pan_number]]

string

UBO 3: PAN number.

merchant[ubo[2][ownership_percent]]

number

UBO 3: Ownership percentage. UBOs typically own 25%+ of the business.

merchant[ubo[2][dob]]

string

UBO 3: Date of birth. Format: YYYY-MM-DD.

merchant[ubo[2][nationality]]

string

UBO 3: 2-letter ISO country code (e.g., IN for India).

merchant[ubo[2][email]]

string

UBO 3: Email address (optional but recommended).

merchant[ubo[2][address][address_line]]

string

UBO 3: Street address.

merchant[ubo[2][address][pincode]]

integer

UBO 3: 6-digit pincode.

merchant[ubo[3][beneficiary_name]]

string

UBO 4: Full name of the Ultimate Beneficial Owner.

merchant[ubo[3][ubo_pan_number]]

string

UBO 4: PAN number.

merchant[ubo[3][ownership_percent]]

number

UBO 4: Ownership percentage. UBOs typically own 25%+ of the business.

merchant[ubo[3][dob]]

string

UBO 4: Date of birth. Format: YYYY-MM-DD.

merchant[ubo[3][nationality]]

string

UBO 4: 2-letter ISO country code (e.g., IN for India).

merchant[ubo[3][email]]

string

UBO 4: Email address (optional but recommended).

merchant[ubo[3][address][address_line]]

string

UBO 4: Street address.

merchant[ubo[3][address][pincode]]

integer

UBO 4: 6-digit pincode.

merchant[ubo_exist]

integer

Must be '1' when submitting UBO details.

Headers

Authorization

string

Bearer token obtained from Step 00 (GetToken). Must include 'refer_merchant' scope.

Content-Type

string

Response

422Unprocessable Entity

EXAMPLE QUESTIONS