post
https://test-accounts.payu.in/api/v3/merchants
The CreateMerchant API creates a new merchant shell account on PayU (Step 01 of 16).
Notes:
- Prerequisite: Step 00 — valid bearer token with
refer_merchantscope.- Entity applicability: All entities.
- Store
mid,uuid, andproduct_account_uuidfrom the response — later steps use different identifiers.
HTTP Method: POST
Environment
| URL | |
|---|---|
| Test Environment | https://test-partner.payu.in/api/v3/merchants |
| Production Environment | https://partner.payu.in/api/v3/merchants |
Note:
merchant[product]=PayUbizis required. Omitting it can cause a backend error in the test environment. Contact your PayU Key Account Manager (KAM) if credentials or product enablement are unclear.
Sample Request
Sample request
curl --location 'https://test-partner.payu.in/api/v3/merchants' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'merchant[display_name]="Acme Stores"' \
--form 'merchant[email]="[email protected]"' \
--form 'merchant[mobile]="9876543210"' \
--form 'merchant[product]="PayUbiz"' \
--form 'merchant[business_details][business_entity_type]="Private Limited"'Sample Response
Success scenario
Success scenario
{
"mid": 12345678,
"uuid": "11ef-d968-6b042d6c-9b94-02975f21d323",
"product_account_uuid": "11ef-d968-6b042d6c-9b94-02975f21d323"
}Failure scenario
Failure scenario
- 422 Validation Failed — Duplicate email or invalid mobile
{
"error": "Email has already been taken"
}- 401 Unauthorized — Token invalid or expired; call Step 00 again
{
"error": "unauthorized",
"message": "Invalid or expired token"
}Response parameters
Response parameters
| Parameter | Description | Example |
|---|---|---|
| mid | integer — Numeric merchant ID for KYC document APIs (Steps 06, 09, 14, 15) | 12345678 |
| uuid | string — Merchant UUID for update/signatory APIs (Steps 02, 04, 05, 07, 08, 10, 12, 13, 16) | 11ef-d968-6b042d6c-9b94-02975f21d323 |
| product_account_uuid | string — Product account UUID used in E-Sign (Step 16) | 11ef-d968-6b042d6c-9b94-02975f21d323 |
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 |
Body parameters
Body parameters
| Parameter | Description | Example |
|---|---|---|
merchant[display_name]mandatory | string — Business or display name | Acme Stores |
merchant[email]mandatory | string — Unique merchant email across PayU | [email protected] |
merchant[mobile]mandatory | string — Exactly 10-digit Indian mobile number | 9876543210 |
merchant[product]mandatory | string — Must be PayUbiz (required to avoid backend errors) | PayUbiz |
merchant[business_details][business_entity_type]mandatory | string — Entity type; determines CKYC method and later steps | Private Limited |
Bad Request
Unauthorized - Invalid or expired token
Forbidden - No access to this resource
Not Found
Validation Failed
Internal Server Error