Update Merchant Details API

The Update Merchant Details API is used to:

  • Add or update any information about the merchant
  • Update PAN details
  • Authorized through User token (merchant token), obtained using Send OTP and Verify OTP APIs.

📘

Notes:

  • The Update Merchant API uses the uuid value as the path parameter. Use the uuid value that is in the **Create Merchant **API response for the corresponding merchant. For more information, refer to Create Merchant API.
  • The PAN verification will happen asynchronously, and the status will be made available in the Get Merchant API.
  • PAN name has to be the same as the business name for successful verification
  • Partner needs to create a form within the application to collect this information
  • All the fields in this API are not mandatory except the GST details, but when you are using this API, you must update atleast a merchant's details using a parameter.
  • The entire payload needs to be submitted for update requests as well
  • No updates are allowed after successful PAN verification. PAN verification status is available in the get merchant API. If the merchant wants to update any information after PAN verification, you need to contact the PayU Care team through help.payu.in

📘

Bearer Token:

The bearer token is required on the header that is generated using the following APIs:

Sample request
curl --location --request PUT 'https://uat-partner.payu.in/api/v1/merchants/11ec-ed65-770862dc-8758-026e3e71538e/update' \
--header 'Authorization: Bearer 5a0260ef08e0a6e7b925b350521f10073a3d4713442e62c489c74e804938843d' \
--form 'merchant[business_sub_category]="Flowers and Gifts"' \
--form 'merchant[business_category]="Ecommerce"' \
--form 'merchant[business_entity]="Sole Proprietorship"' \
--form 'merchant[business_name]="Harsh Agarwal"' \
--form 'merchant[pancard_number]="AUKPA1386M"' \
--form 'merchant[signing_authority_details][email]="[email protected]"' \
--form 'merchant[signing_authority_details][name]="Harsh Agarwal"' \
--form 'merchant[signing_authority_details][pancard_number]="AUKPA1386M"' \
--form 'merchant[signing_authority_details][email]="[email protected]"' \
--form 'merchant[signing_authority_details][name]="Ashish Kumar"' \
--form 'merchant[signing_authority_details][pancard_number]="OPSPS0921B"' \
--form 'merchant[signing_authority_details][cin_number]="U72400MH2006PTC293037"' \
--form 'merchant[director1_details][name]="John Doe"' \
--form 'merchant[director1_details][email]="[email protected]"' \
--form 'merchant[director2_details][name]="Jane Doe"' \
--form 'merchant[director2_details][email]="[email protected]"' \
--form 'merchant[monthly_expected_volume]="60000"' \
--form 'merchant[operating_address][address_line]="Sector 98"' \
--form 'merchant[operating_address][city]="Noida"' \
--form 'merchant[operating_address][state]="UTTAR PRADESH"' \
--form 'merchant[operating_address][pincode]="201307"' \
--form 'merchant[registration_address][address_line]="Sector 98"' \
--form 'merchant[registration_address][city]="Noida"' \
--form 'merchant[registration_address][state]="UTTAR PRADESH"' \
--form 'merchant[registration_address][pincode]="201306"'
Sample response
{
"merchant": {
"name": "Merchant",
"email": "[email protected]",
"registered_mobile": "8447641351",
"mid": 5018124,
"product": "PayUbiz",
"business_type": "LongTail",
"business_name": "Harsh Agarwal",
"pancard_name": "Harsh Agarwal",
"pancard_number": "AUKPA1386M",
"website_url": null,
"android_url": null,
"ios_url": null,
"gst_number": null,
"created_at": "2022-06-16T11:14:19.000Z",
"mobile": "8447641351",
"blocked": false,
"first_name": "",
"last_name": "Merchant",
"bank_detail": {
"bank_account_number": "8388282849123",
"ifsc_code": "SBIN0008239",
"holder_name": "Harsh Agarwal",
"nodal_code": null,
"nodal_status": null
},
"operating_address": {
"address_line": "Sector 98",
"city": "Noida",
"state": "UTTAR PRADESH",
"pincode": "201307"
},
"registration_address": {
"address_line": "Sector 98",
"city": "Noida",
"state": "UTTAR PRADESH",
"pincode": "201307"
},
"business_entity": "Sole Proprietorship",
"status": "account_created",
"partner_source": "Create Merchant API",
"pan_verification_status": "Pending",
"website_approval_status": null,
"notification_email": "[email protected]",
"settlement_status": null,
"is_service_agreement_accepted": false,
"is_authorisation_letter_required": false,
"monthly_expected_volume": "60000",
"business_category": "Ecommerce",
"business_sub_category": "Flowers and Gifts",
"bank_verification_status": null,
"uuid": "11ec-ed65-770862dc-8758-026e3e71538e",
"penny_deposit_status": null,
"service_intent": "default",
"signing_authority": {
"name": "Harsh Agarwal",
"email": "[email protected]"
}
}
}

Request parameters

Language
Credentials
Bearer
Click Try It! to start a request and see the response here!