Table of contents

Create UPI Sub Merchant

Use this API to create Sub Merchant with Static QR and Dynamic UPI collection methods. The collected money will be settled directly to your merchant's bank account.


Method: POST

Auth: Please refer to the Authorization page.

{ "name": "Sxxxxx Txxx", "name_on_bank": "Hxxxxx Kxx", "phone": "9092xxxxxx", "reference_id": "Txxx", "businessName": "Txxx", "state": "Tamil Nadu", "nature_of_business": "exports", "business_address": "krishnagiri", "bank_name": "xxxxx payments bank", "bank_branch": "xxxxx", "account_number": "9190xxxxxxx", "account_ifsc": "PYTM0123456", "category_code": "0823", "pan_number": "ERLxxxxxxJ", "business_type_code": "1", "address": "krishnagiri", "city": "xxxxx", "pincode": "xxxxxx", "entity_type": "10" }
{ "status": true, "statusCode": 200, "data": {}, "message": "Created", "result": { "merchantId": "BPSUBVA0015", "reference_id": "Test-1707820105", "kycLink": "", "name": "Sathya Test", "phone": "9XXXXX9890" } }

The following tables list the possible values and a brief description as to what they stand for various parameters in the sub-merchant creation APIs.

API Documentation: Sub-merchant Creation Codes List

Sub-merchant Creation Codes List

Business type code

3 Pvt Ltd / Companies registered under AcT
4 Govt / Govt Undertakings
1 Individual- HUF
42 Individuals / Professionals
45 LLPs
2 Partnership
41 Proprietor
44 Regd Trusts

Entity type codes

0 Individual/Freelancers
4 Society/Trust - Education
5 HUF Hindu Undivided Family
7 Limited Liability Partnership
9 Partnership Firm
10 Sole Proprietor
11 Private Ltd/Public Ltd/OPC
12 Trust/NGO - Donations
13 Government Entity
14 Co-operative Credit Society/JV/AOP


Andhra Pradesh Madhya Pradesh West Bengal
Arunachal Pradesh Manipur Andaman and Nicobar Islands
Maharashtra Meghalaya Chandigarh
Assam Mizoram Daman and Diu
Bihar Nagaland Delhi
Chhattisgarh Odisha Puducherry
Goa Punjab Lakshadweep
Gujarat Rajasthan Kerala
Haryana Sikkim Tripura
Himachal Pradesh Uttarakhand Karnataka
Jammu and Kashmir Uttar Pradesh Telangana
Jharkhand Tamil Nadu Dadra and Nagar Haveli

Category code

0742 Veterinary services
0743 Wine producers
0744 Champagne producers
0763 Agricultural co-operatives
0780 Landscaping and horticultural services
0820 Fertilizer Dealers
0821 Pesticides / Insecticides
0822 Seeds
0823 Farm Equipment
0824 Agricultural Machinery
0825 Other Agri Inputs
1520 General contractors residential and commercial
1711 Heating, plumbing and air-conditioning contractors
1731 Electrical contractors
1740 Masonry, stonework, tile setting, plastering and insulation contractors
1750 Carpentry contractors
1761 Roofing, siding and sheet metal work contractors
1771 Concrete work contractors
1799 Special trade contractors not elsewhere classified
2791 Typesetting, platemaking and related services
2842 Speciality cleaning, polishing and sanitation preparations
4011 Railroads
4111 Local and suburban commuter passenger transportation, including ferries
4112 Passenger railways
4119 Ambulance services
4121 Taxi-cabs and limousines
4131 Bus lines
4214 Motor freight carriers and trucking local and long distance, moving and storage companies and local delivery
4215 Courier services air and ground and freight forwarders
4225 Public warehousing and storage farm products, refrigerated goods and household goods
4411 Steamships and cruise lines
4457 Boat rentals and leasing
4468 Marinas, marine service and supplies
4511 Airlines and air carriers
4582 Airports, flying fields and airport terminals
4722 Travel agencies and tour operators
4784 Tolls and bridge fees
4789 Transportation services not elsewhere classified
4812 Telecommunication equipment and telephone sales
4814 Telecommunication services, including local and long distance calls, credit card calls, calls through use of magnetic stripe reading telephones and faxes
4816 Computer network/information services
4829 Wire transfers and money orders
4899 Cable and other pay television services
4900 Utilities electric, gas, water and sanitary
5013 Motor vehicle supplies and new parts
5021 Office and commercial furniture
5039 Construction materials not elsewhere classified
5044 Office, photographic, photocopy and microfilm equipment
5045 Computers, computer peripheral equipment not elsewhere classified
5046 Commercial equipment not elsewhere classified
5047 Dental/laboratory/medical/ophthalmic hospital equipment and supplies
5051 Metal service centres and offices
5065 Electrical parts and equipment
5072 Hardware equipment and supplies
5074 Plumbing and heating equipment and supplies
5085 Industrial supplies not elsewhere classified
5094 Precious stones and metals, watches and jewellery
5099 Durable goods not elsewhere classified
5111 Stationery, office supplies and printing and writing paper
5122 Drugs, drug proprietors
5131 Piece goods, notions and other dry goods
5137 Mens, womens and childrens uniforms and commercial clothing
5139 Commercial footwear
5169 Chemicals and allied products not elsewhere classified
5172 Petroleum and petroleum products
5192 Books, periodicals and newspapers
5193 Florists supplies, nursery stock and flowers
5198 Paints, varnishes and supplies
5199 Non-durable goods not elsewhere classified
5200 Home supply warehouse outlets
5211 Lumber and building materials outlets
5231 Glass, paint and wallpaper shops
5251 Hardware shops
5261 Lawn and garden supply outlets, including nurseries
5271 Mobile home dealers
5300 Wholesale clubs
5309 Duty-free shops
5310 Discount shops
5311 Department stores
5331 Variety stores
5411 Groceries and supermarkets
5422 Freezer and locker meat provisioners
5441 Candy, nut and confectionery shops
5451 Dairies
5462 Bakeries
5511 Car and truck dealers (new and used) sales, services, repairs, parts and leasing
5521 Car and truck dealers (used only) sales, service, repairs, parts and leasing
5531 Auto and home supply outlets
5532 Automotive tyre outlets
5533 Automotive parts and accessories outlets
5541 Service stations (with or without ancillary services)
5542 Automated fuel dispensers
5551 Boat dealers
5561 Camper, recreational and utility trailer dealers
5571 Motorcycle shops and dealers
5592 Motor home dealers
5598 Snowmobile dealers
5611 Mens and boys clothing and accessory shops
5621 Womens ready-to-wear shops
5631 Womens accessory and speciality shops
5641 Childrens and infants wear shops
5651 Family clothing shops
5655 Sports and riding apparel shops
5661 Shoe shops
5681 Furriers and fur shops
5691 Mens and womens clothing shops
5697 Tailors, seamstresses, mending and alterations
5698 Wig and toupee shops
5712 Furniture, home furnishings and equipment shops and manufacturers, except appliances
5713 Floor covering services
5714 Drapery, window covering and upholstery shops
5715 Alcoholic beverage wholesalers
5718 Fireplaces, fireplace screens and accessories shops
5722 Household appliance shops
5732 Electronics shops
5733 Music shops musical instruments, pianos and sheet music
5734 Computer software outlets
5735 Record shops
5811 Caterers
5812 Eating places and restaurants
5813 Drinking places (alcoholic beverages) bars, taverns, night-clubs, cocktail lounges and discothques
5814 Fast food restaurants
5815 Digital Goods: Media, Books, Movies, Music
5816 Digital Goods: Games
5817 Digital Goods: Applications (Excludes Games)
5818 Digital Goods: Large Digital Goods Merchant
5832 Antique Shops - Sales, Repairs, and Restoration Services
5912 Drug stores and pharmacies
5921 Package shops beer, wine and liquor
5931 Used merchandise and second-hand shops
5932 Antique shops - sales, repairs and restoration services
5933 Pawn shops
5935 Wrecking and salvage yards
5937 Antique reproduction shops
5940 Bicycle shops sales and service
5941 Sporting goods shops
5942 Bookshops
5943 Stationery, office and school supply shops
5944 Jewellery, watch, clock and silverware shops
5945 Hobby, toy and game shops
5946 Camera and photographic supply shops
5947 Gift, card, novelty and souvenir shops
5948 Luggage and leather goods shops
5949 Sewing, needlework, fabric and piece goods shops
5950 Glassware and crystal shops
5960 Direct marketing - insurance services
5962 Telemarketing travel-related arrangement services
5963 Door-to-door sales
5964 Direct marketing catalogue merchants
5965 Direct marketing combination catalogue and retail merchants
5966 Direct marketing outbound telemarketing merchants
5967 Direct marketing inbound telemarketing merchants
5968 Direct marketing continuity/subscription merchants
5969 Direct marketing/direct marketers not elsewhere classified
5970 Artist supply and craft shops
5971 Art dealers and galleries
5972 Stamp and coin shops
5973 Religious goods and shops
5975 Hearing aids sales, service and supplies
5976 Orthopaedic goods and prosthetic devices
5977 Cosmetic Stores
5978 Typewriter outlets sales, service and rentals
5983 Fuel dealers fuel oil, wood, coal and liquefied petroleum
5992 Florists
5993 Cigar shops and stands
5994 Newsagents and news-stands
5995 Pet shops, pet food and supplies
5996 Swimming pools sales, service and supplies
5997 Electric razor stores - sales and service
5998 Tent and awning shops
5999 Miscellaneous and speciality retail shops
6010 Financial institutions manual cash disbursements
6011 Financial institutions automated cash disbursements
6012 Financial institutions merchandise and services
6051 Non-financial institutions foreign currency, money orders (not wire transfer), scrip and travellers checks
6211 Securities brokers and dealers
6300 Insurance sales, underwriting and premiums
6513 Real Estate Agents and Managers - Rentals
6529 LIC
6540 Debit card to wallet credit (Wallet top up)
7011 Lodging hotels, motels and resorts
7012 Timeshares
7032 Sporting and recreational camps
7033 Trailer parks and camp-sites
7210 Laundry, cleaning and garment services
7211 Laundry services family and commercial
7216 Dry cleaners
7217 Carpet and upholstery cleaning
7221 Photographic studios
7230 Beauty and barber shops
7251 Shoe repair shops, shoe shine parlours and hat cleaning shops
7261 Funeral services and crematoriums
7273 Dating and escort services
7276 Tax preparation services
7277 Counselling services debt, marriage and personal
7278 Buying and shopping services and clubs
7296 Clothing rentals costumes, uniforms and formal wear
7297 Massage parlours
7298 Health and beauty spas
7311 Advertising services
7321 Consumer credit reporting agencies
7322 Debt collection agencies
7332 Blueprinting and Photocopying Services
7333 Commercial photography, art and graphics
7338 Quick copy, reproduction and blueprinting services
7339 Stenographic and secretarial support services
7342 Exterminating and disinfecting services
7349 Cleaning, maintenance and janitorial services
7361 Employment agencies and temporary help services
7372 Computer programming, data processing and integrated systems design services
7375 Information retrieval services
7379 Computer maintenance and repair services not elsewhere classified
7392 Management, consulting and public relations services
7393 Detective agencies, protective agencies and security services, including armoured cars and guard dogs
7394 Equipment, tool, furniture and appliance rentals and leasing
7395 Photofinishing laboratories and photo developing
7399 Business services not elsewhere classified
7511 Truck Stop
7512 Automobile rentals
7513 Truck and utility trailer rentals
7519 Motor home and recreational vehicle rentals
7523 Parking lots and garages
7531 Automotive body repair shops
7534 Tyre retreading and repair shops
7535 Automotive paint shops
7538 Automotive service shops (non-dealer)
7542 Car washes
7549 Towing services
7622 Electronics repair shops
7623 Air conditioning and refrigeration repair shops
7629 Electrical and small appliance repair shops
7631 Watch, clock and jewellery repair shops
7641 Furniture reupholstery, repair and refinishing
7692 Welding services
7829 Motion picture and video tape production and distribution
7832 Motion picture theatres
7841 Video tape rentals
7911 Dance halls, studios and schools
7922 Theatrical producers (except motion pictures) and ticket agencies
7929 Bands, orchestras and miscellaneous entertainers not elsewhere classified
7932 Billiard and pool establishments
7933 Bowling alleys
7941 Commercial sports, professional sports clubs, athletic fields and sports promoters
7991 Tourist attractions and exhibits
7992 Public golf courses
7993 Video amusement game supplies
7994 Video game arcades and establishments
7995 Betting, including lottery tickets, casino gaming chips, off-track betting and wagers at race tracks
7996 Amusement parks, circuses, carnivals and fortune tellers
7997 Membership clubs (sports, recreation, athletic), country clubs and private golf courses
7998 Aquariums, seaquariums and dolphinariums
7999 Recreation services not elsewhere classified
8011 Doctors and physicians not elsewhere classified
8021 Dentists and orthodontists
8031 Osteopaths
8042 Optometrists and ophthalmologists
8043 Opticians, optical goods and eyeglasses
8049 Podiatrists and chiropodists
8050 Nursing and personal care facilities
8062 Hospitals
8071 Medical and dental laboratories
8099 Medical services and health practitioners not elsewhere classified
8111 Legal services and attorneys
8211 Elementary and secondary schools
8220 Colleges, universities, professional schools and junior colleges
8241 Correspondence schools
8244 Business and secretarial schools
8249 Trade and vocational schools
8299 Schools and educational services not elsewhere classified
8351 Child care services
8398 Charitable and social service organizations
8641 Civic, social and fraternal associations
8651 Political organizations
8661 Religious organizations
8675 Automobile associations
8699 Membership organization not elsewhere classified
8734 Testing laboratories (non-medical)
8911 Architectural, engineering and surveying services
8931 Accounting, auditing and bookkeeping services
8999 Professional services not elsewhere classified
9211 Court costs, including alimony and child support
9222 Fines
9223 Bail and bond payments
9311 Tax payments
9399 Government services not elsewhere classified
9400 PMNRF
9402 Postal services government only
7407 P2PM Merchant