UpdateMerchant: Website Details — Step 07 of 16
Endpoint
PUT /api/v1/merchants/{uuid}/update
Request Body (form-data)
| Parameter | Type | Required | Validation | Description |
|---|---|---|---|---|
merchant[website_details][website_url] | string | Conditional | Valid URL | Website URL |
merchant[website_details][android_url] | string | No | Valid Play Store URL | Android app URL |
merchant[website_details][ios_url] | string | No | Valid App Store URL | iOS app URL |
At least one URL should be provided if the merchant has an online presence.
Next Step
Proceed to Step 08 — Add Signatory Details.
API path:
PUT /api/v1/merchants/{uuid}/update— use the merchantuuidfrom Step 01 in the path. (OpenAPI uses a distinct path-parameter name on this page so ReadMe can import multiple Update-Merchant step groups that share the same HTTP method and path.)
The UpdateMerchant Website Details API adds the merchant website and/or app store URLs (Step 07 of 16).
Prerequisite: Step 05 (bank details) or Step 06 (bank proof), as applicable.
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[website_details][website_url]="https://www.example.com"' \
--form 'merchant[website_details][android_url]="https://play.google.com/store/apps/details?id=com.example"' \
--form 'merchant[website_details][ios_url]="https://apps.apple.com/app/example/id123456"'Sample Response
Success scenario
Success scenario
{
"merchant": {
"mid": 12345678,
"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"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| merchant.mid | integer — Merchant ID | 12345678 |
| 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[website_details][website_url]conditional | string — Merchant website URL | https://www.example.com |
merchant[website_details][android_url]optional | string — Android app store URL | https://play.google.com/store/apps/details?id=com.example |
merchant[website_details][ios_url]optional | string — iOS App Store URL | https://apps.apple.com/app/example/id123456 |
400Bad Request
401Unauthorized - Invalid or expired token
403Forbidden - No access to this resource
404Not Found
422Validation Failed
500Internal Server Error
