put
https://test-accounts.payu.in/api/v1/merchants//update
The UpdateMerchant Addresses API adds registration and operating addresses for the merchant (Step 10 of 16).
Notes:
- Prerequisite: Step 09 (DigiLocker) completed or skipped per branching rules.
- Entity applicability: 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[registration_address][address_line]="123 MG Road"' \
--form 'merchant[registration_address][city]="Bangalore"' \
--form 'merchant[registration_address][state]="Karnataka"' \
--form 'merchant[registration_address][pincode]="560001"' \
--form 'merchant[operating_address][address_line]="456 Indiranagar"' \
--form 'merchant[operating_address][city]="Bangalore"' \
--form 'merchant[operating_address][state]="Karnataka"' \
--form 'merchant[operating_address][pincode]="560038"'Sample Response
Success scenario
Success scenario
{
"merchant": {
"mid": 760070201,
"operating_address": {
"address_line": "M1704, Banashankari",
"city": "Gurgaon",
"state": "HARYANA",
"pincode": 122018
},
"registration_address": {
"address_line": "M1704, banashankari",
"city": "Gurgaon",
"state": "HARYANA",
"pincode": 122018
},
"status": "third_party_on_hold"
}
}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"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| merchant.mid | integer — Merchant ID | 760070201 |
| merchant.registration_address | object — Registered business address | { address_line, city, state, pincode } |
| merchant.operating_address | object — Operating / office address | { address_line, city, state, pincode } |
| merchant.status | string — Current onboarding status | third_party_on_hold |
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[registration_address][address_line]mandatory | string — Registered address line | 123 MG Road |
merchant[registration_address][city]mandatory | string — City | Bangalore |
merchant[registration_address][state]mandatory | string — Valid Indian state | Karnataka |
merchant[registration_address][pincode]mandatory | string — 6-digit pincode | 560001 |
merchant[operating_address][address_line]mandatory | string — Operating address line | 456 Indiranagar |
merchant[operating_address][city]mandatory | string — City | Bangalore |
merchant[operating_address][state]mandatory | string — Valid Indian state | Karnataka |
merchant[operating_address][pincode]mandatory | string — 6-digit pincode | 560038 |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error