put
https://test-accounts.payu.in/api/v1/merchants//update
The UpdateMerchant PAN + DOB API sets the merchant PAN and date of birth or incorporation (Step 02 of 16).
Notes:
- Refer to Step 01 — Create Merchant to create a merchant to get the uuid value from the response.
- This is applicable to all entities.
HTTP Method: PUT
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v1/merchants/{uuid}/update |
| Production Environment | https://partner.payu.in/api/v1/merchants/{uuid}/update |
Sample Request
Sample request
curl --location --request PUT 'https://test-partner.payu.in/api/v1/merchants/{{uuid}}/update' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'merchant[pancard_number]="ABCDE1234F"' \
--form 'merchant[pancard_name]="MERCHANT LEGAL NAME"' \
--form 'merchant[dob]="2000-01-06"'Sample Response
Success scenario
Success scenario
{
"merchant": {
"mid": 12345678,
"pan_verification_status": "Pending",
"status": "account_created"
}
}Failure scenario
Failure scenario
- 401 Unauthorized — Token invalid or expired; call Step 00 again
{
"error": "unauthorized",
"message": "Invalid or expired token"
}- 422 Validation Failed — Request parameters failed validation
{
"error": "validation_failed",
"message": "Check the error details in the response body"
}- 422 — PAN format invalid
{
"error": "PAN is invalid"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| merchant.mid | integer — Merchant ID | 12345678 |
| merchant.pan_verification_status | string — PAN verification status after submission | Pending |
| merchant.status | string — Current onboarding status | account_created |
Request parameters
Header parameters
Header parameters
| Header | Description | Example |
|---|---|---|
Authorizationmandatory | string — Bearer token from Step 00 (GetToken) | Bearer {{access_token}} |
Content-Typemandatory | string — Must be multipart/form-data | multipart/form-data |
Path parameters
Path parameters
| Parameter | Description | Example |
|---|---|---|
uuidmandatory | string — Merchant UUID from Step 01 (CreateMerchant) | 11ef-d968-6b042d6c-9b94-02975f21d323 |
Body parameters
Body parameters
| Parameter | Description | Example |
|---|---|---|
merchant[pancard_number]mandatory | string — PAN in ABCDE1234F format | ABCDE1234F |
merchant[pancard_name]mandatory | string — Name on PAN card (must match registry) | MERCHANT LEGAL NAME |
merchant[dob]mandatory | string — DOB (Individual) or date of incorporation (YYYY-MM-DD) | 2000-01-06 |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error