# POST /merchants/create

## POST /merchants/create

> Create Merchant ---- \[auth scope:  admin, grandparent, parent]

```json
{"openapi":"3.0.0","info":{"title":"Merchant API","version":"1.0"},"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"CreateMerchantDto":{"type":"object","properties":{"redirectUrl":{"type":"string","description":"The new merchant URL"},"merchantName":{"type":"string","description":"The new merchant name"},"status":{"type":"object","description":"The new merchant status"},"parentId":{"type":"string","description":"The new merchant parent"},"theme":{"description":"The new merchant theme","allOf":[{"$ref":"#/components/schemas/ThemeDto"}]},"preferredDisplayMode":{"type":"string","description":"The new merchant Preferred display mode for payment"},"paymentStatusFetchEnabled":{"type":"boolean","description":"Whether to fetch payment status after processing"},"popupOverlayConfig":{"description":"Configuration for popup overlay content","allOf":[{"$ref":"#/components/schemas/PopupOverlayConfigDto"}]}},"required":["redirectUrl","merchantName","status","parentId","theme","preferredDisplayMode"]},"ThemeDto":{"type":"object","properties":{"logo":{"type":"string","description":"The merchant logo"},"leftSidebarBgColor":{"type":"string","description":"The left sidebar background color"},"leftSidebarActiveColor":{"type":"string","description":"The left sidebar active color"},"leftSidebarHoverColor":{"type":"string","description":"The left sidebar hover color"},"leftSidebarTextColor":{"type":"string","description":"The left sidebar text color"},"topBarTextColor":{"type":"string","description":"The top bar text color"},"topBarBgColor":{"type":"string","description":"The top bar background color"},"paymentLinkMenuAlias":{"type":"string","description":"The alias for \"Optty Direct\" label on UPP"}},"required":["logo","leftSidebarBgColor","leftSidebarActiveColor","leftSidebarHoverColor","leftSidebarTextColor","topBarTextColor","topBarBgColor","paymentLinkMenuAlias"]},"PopupOverlayConfigDto":{"type":"object","properties":{"title":{"type":"string","description":"Title displayed in the popup overlay"},"message":{"type":"string","description":"Message displayed in the popup overlay"}},"required":["title","message"]},"CreateMerchantResponse":{"type":"object","properties":{"merchantId":{"type":"string","description":"The merchant ID"},"redirectUrl":{"type":"string","description":"The merchant redirect url"},"merchantName":{"type":"string","description":"The merchant name"},"status":{"type":"boolean","description":"The merchant status"},"parentId":{"type":"string","description":"The parent ID"},"authClientId":{"type":"string","description":"The merchant client ID"},"authClientSecret":{"type":"string","description":"The merchant client secret"},"hmacKey":{"type":"string","description":"The merchant hmac key"},"theme":{"description":"The merchant theme","allOf":[{"$ref":"#/components/schemas/ThemeDto"}]},"partnerMerchantId":{"type":"string","description":"The partner's merchant id"}},"required":["merchantId","redirectUrl","merchantName","status","parentId","authClientId","authClientSecret","hmacKey","theme","partnerMerchantId"]}}},"paths":{"/merchants/create":{"post":{"operationId":"MerchantsController_create","summary":"Create Merchant ---- [auth scope:  admin, grandparent, parent]","deprecated":false,"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantDto"}}}},"responses":{"200":{"description":"Merchant created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMerchantResponse"}}}}},"tags":["merchants"]}}}}
```