put
https://uat-partner.payu.in/api/v1/merchants//update
Use this API to update or skip Website details for your merchant account.
When you skip the Website, your account will only be eligible to collect payment using payment link or invoices.
PrerequisiteStep 01 to 06 must be updated before updating/skipping the website.
Entity applicability: All entities.
HTTP Method: PUT
Environment
| URL | |
|---|---|
| Test Environment | https://uat-partner.payu.in/api/v1/merchants/{uuid}/update |
| Production Environment | https://partner.payu.in/api/v1/merchants/{uuid}/update |
Sample Request
Update website
Sample request to update website
curl --location --request PUT 'https://uat-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"'Skip website
Sample request to skip website
curl --location --request PUT 'https://uat-partner.payu.in/api/v1/merchants/{{uuid}}/update' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'merchant[integration_type]="tools"' \
Sample Response
Success scenario
Update Website
Success scenario for update website
{
"merchant": {
"mid": 760070201,
"website_url": "www.borosil.com",
"android_url": "www.borosil.com",
"ios_url": "www.borosil.com",
"website_approval_status": "Pending"
}
}Skip website
Success scenario for skip website
{
"merchant": {
"mid": 760070201,
"integration_type":"tools"
}
}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 |
Additional Request Parameters Info
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 |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error
