Merchants represent legal entities which are interacting with the card
networks.
Onboarding merchants for an account is a prerequisite for creating
network tokens. Depending on the setup of the account, this allows to
render complex ecommerce ecosystem setups.
The key used to encrypt authentication data (for instance network token and cryptogram).
This information is returned only once, when the merchant was initially created. Subsequent calls will return a masked value.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Hellgate Cloud Platform","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/starfishgmbhcokg/fao_mR6VDpBCxc3o/logo/light.svg?fit=max\u0026auto=format\u0026n=fao_mR6VDpBCxc3o\u0026q=85\u0026s=1f2caba60febae2b0dcaddf3e196a132","dark":"https://mintcdn.com/starfishgmbhcokg/fao_mR6VDpBCxc3o/logo/dark.svg?fit=max\u0026auto=format\u0026n=fao_mR6VDpBCxc3o\u0026q=85\u0026s=a89c19b7c5f7607499a161a2db5b0f74","href":"https://developer.hellgate.io"},"favicon":"https://mintcdn.com/starfishgmbhcokg/dfhj2Hm84A9ik5S0/favicon.svg?fit=max\u0026auto=format\u0026n=dfhj2Hm84A9ik5S0\u0026q=85\u0026s=d897b485a1cd938d6af772ddd4885368","api":{"params":{"post":["x-data-classification"]}},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://hellgate.io","label":"Visit hellgate.io"}],"primary":{"type":"button","label":"Write our Support","href":"mailto:support@hellgate.io"}},"footer":{"socials":{"website":"https://hellgate.io","github":"https://github.com/starfish-codes","linkedin":"https://www.linkedin.com/company/hellgate-io","youtube":"https://www.youtube.com/@hellgate-io"}},"seo":{"metatags":{"google-site-verification":"OJ_nWFren-zsecLNqkmvOGrnXjmCZ_fPg5ov1mM8Tno"}},"contextual":{"options":["copy","view","download-spec","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"starfishgmbhcokg","hasAudioNarration":false,"actualSubdomain":"starfishgmbhcokg","customDomains":["developer.hellgate.io"],"gitSource":{"type":"github","owner":"starfish-codes","repo":"cpa-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae1f4810ab3938238c978a0","collectionId":"8ae20ce8-6ddd-493c-a430-ba8f229b79e6","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1f4810ab3938238c978a0"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1f4810ab3938238c978a0","clientVersion":"0.0.4039","searchFilterCounts":[{"language":"default","tag":"API Reference","count":243},{"language":"default","tag":"Commerce","count":181},{"language":"default","tag":"Documentation","count":81},{"language":"default","tag":"Guardian","count":77},{"language":"default","tag":"Tokens","count":67},{"language":"default","tag":"Specter","count":60},{"language":"default","tag":"Admin","count":50},{"language":"default","tag":"Payments","count":36},{"language":"default","tag":"Configuration","count":29},{"language":"default","tag":"Wallet Tokens","count":28}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--hg-classification-bg:#fef3c7;--hg-classification-fg:#92400e}.dark{--hg-classification-bg:rgb(245 158 11 / 0.15);--hg-classification-fg:#fcd34d}.classification-badge,.dark div[data-component-part=field-meta-post],div[data-component-part=field-meta-post]{background-color:var(--hg-classification-bg);color:var(--hg-classification-fg)}.classification-badge{display:inline-block;padding:.125rem .5rem;border-radius:.375rem;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.875em;white-space:nowrap}"}],"page":{"pagePath":"products/commerce/v2/api-reference/merchants/create-a-merchant","slug":"/products/commerce/v2/api-reference/merchants/create-a-merchant","pageMetadata":{"title":"Create a merchant","description":"Create a new merchant.\n\nMerchants represent legal entities which are interacting with the card\nnetworks.\n\nOnboarding merchants for an account is a prerequisite for creating\nnetwork tokens. Depending on the setup of the account, this allows to \nrender complex ecommerce ecosystem setups.\n","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /merchants","href":"/products/commerce/v2/api-reference/merchants/create-a-merchant","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Create a new merchant.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Merchants represent legal entities which are interacting with the card\\nnetworks.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Onboarding merchants for an account is a prerequisite for creating\\nnetwork tokens. Depending on the setup of the account, this allows to\\nrender complex ecommerce ecosystem setups.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a merchant","description":"Create a new merchant.\n\nMerchants represent legal entities which are interacting with the card\nnetworks.\n\nOnboarding merchants for an account is a prerequisite for creating\nnetwork tokens. Depending on the setup of the account, this allows to \nrender complex ecommerce ecosystem setups.\n","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /merchants","href":"/products/commerce/v2/api-reference/merchants/create-a-merchant","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a merchant","description":"Create a new merchant.\n\nMerchants represent legal entities which are interacting with the card\nnetworks.\n\nOnboarding merchants for an account is a prerequisite for creating\nnetwork tokens. Depending on the setup of the account, this allows to \nrender complex ecommerce ecosystem setups.\n","operationId":"onboard_merchant","tags":["merchants"],"security":["fd8408ec-e677-4cb0-8813-d858bff37757"],"requestBody":"cfda9961-b23d-4345-8166-fcfd08a09657","responses":{"200":"07c8455b-33a4-41ae-b2fd-c698c9da01a0","401":"3f576def-9c2b-4656-a42b-7df347005154","403":"e64b606f-8dae-4473-b79c-f1b45ac4ed1d","422":"d7c00807-bcd8-4cd5-be42-33a33e1fb9ae"},"method":"post","type":"path","servers":["177039e8-68d7-48a4-8b0f-1aab076efe1e","f4d3dc43-25ab-4780-9b17-95fa63b320bf"],"path":"/merchants","baseUrlOptions":["https://sandbox.hellgate.io","https://api.hellgate.io"],"title":"Create a merchant","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"company_city":{"type":"string","description":"The city in the merchant's primary address.","isRequired":true,"uniqueKey":"company_city","typeLabel":"string"},"country_code":{"example":"US","type":"string","description":"A two letter country code.\n[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\n","isRequired":true,"uniqueKey":"country_code","typeLabel":"string"},"legal_name":{"type":"string","description":"The name of the merchant","isRequired":true,"uniqueKey":"legal_name","typeLabel":"string"},"website_url":{"type":"string","description":"The URL of the merchant's website","format":"uri","isRequired":true,"uniqueKey":"website_url","typeLabel":"string\u003curi>"},"identity_and_verification_enabled":{"type":"boolean","description":"The flag indicates if the 3DS identity and verification is required or not (only allowed for primary)\n","uniqueKey":"identity_and_verification_enabled","typeLabel":"boolean"},"3ds_enabled":{"type":"boolean","description":"Indicates if 3DS is available or not for the Merchant\n","uniqueKey":"3ds_enabled","typeLabel":"boolean"},"default_currency":{"example":"EUR","type":"string","description":"The three letter currency code.\nSee: [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes)\n","uniqueKey":"default_currency","typeLabel":"string"},"default_merchant_id":{"type":"string","description":"The id for the Merchant","uniqueKey":"default_merchant_id","typeLabel":"string"},"schemes":{"type":"array","description":"The schemes supported by the merchant (required if merchant has a merchant_id)\n","items":{"type":"object","properties":{"name":{"type":"string","description":"The network scheme name","enum":["visa","mastercard"],"isRequired":true,"uniqueKey":"schemes.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"acquirer_bin":{"example":"444444","type":"string","description":"The acquiring institution identification code","isRequired":true,"uniqueKey":"schemes.items.[INDEX].acquirer_bin","typeLabel":"string"},"category_code":{"example":"5411","type":"string","description":"The DS-specific code describing the Merchant type of business","format":"0000","isRequired":true,"uniqueKey":"schemes.items.[INDEX].category_code","typeLabel":"string\u003c0000>"},"requestor_id":{"example":"example-store-3ds","type":"string","description":"The 3DS requestor identifier\nrequestor_id and requestor_name should be sent in pairs.\n","uniqueKey":"schemes.items.[INDEX].requestor_id","typeLabel":"string"},"requestor_name":{"example":"Example Store","type":"string","description":"The 3DS requestor name\nrequestor_id and requestor_name should be sent in pairs.\n","uniqueKey":"schemes.items.[INDEX].requestor_name","typeLabel":"string"},"merchant_id":{"example":"EXAMPLE_STORE_EU","type":"string","description":"Allow override the acquiring merchant id that can be used to specify per card scheme during\nthe authentication.\nmerchant_id and merchant_name should be sent in pairs.\n","uniqueKey":"schemes.items.[INDEX].merchant_id","typeLabel":"string"},"merchant_name":{"example":"Example Store","type":"string","description":"Allow override the merchant name that can be used to specify per card scheme during the\nauthentication.\nmerchant_id and merchant_name should be sent in pairs.\n","uniqueKey":"schemes.items.[INDEX].merchant_name","typeLabel":"string"}},"required":["name","acquirer_bin","category_code"],"uniqueKey":"schemes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"schemes","typeLabel":"object[]"}},"example":{"company_city":"Berlin","country_code":"DE","legal_name":"Example Merchant","website_url":"https://example.com","identity_and_verification_enabled":false,"3ds_enabled":true,"default_currency":"EUR","default_merchant_id":"1234567890","schemes":[{"name":"visa","acquirer_bin":"40001","requestor_id":"123456789.visa","requestor_name":"3dsclient.local.visa","category_code":"3200","merchant_id":"","merchant_name":""}]},"required":["company_city","country_code","legal_name","website_url"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"company_city":"Berlin","country_code":"DE","legal_name":"Example Merchant","website_url":"https://example.com","identity_and_verification_enabled":false,"3ds_enabled":true,"default_currency":"EUR","default_merchant_id":"1234567890","schemes":[{"name":"visa","acquirer_bin":"40001","requestor_id":"123456789.visa","requestor_name":"3dsclient.local.visa","category_code":"3200","merchant_id":"","merchant_name":""}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"07c8455b-33a4-41ae-b2fd-c698c9da01a0":{"description":"Success response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"example":"5d6b2c9a-9b0b-4b0c-8c7d-9e9d5d7e9d5d","type":"string","description":"The ID of the merchant","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"created_at":{"example":"2025-01-15T09:00:00Z","type":"string","description":"The date-time the merchant was created (following ISO 8601)","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"company_city":{"example":"Milford","type":"string","description":"The city in the merchant's primary address.","isRequired":true,"uniqueKey":"company_city","typeLabel":"string"},"country_code":{"example":"US","type":"string","description":"A two letter country code.\n[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\n","isRequired":true,"uniqueKey":"country_code","typeLabel":"string"},"encryption_key":{"example":"eyJhbGciO[redacted]","type":"string","description":"The key used to encrypt authentication data (for instance network token and cryptogram).\nThis information is returned only once, when the merchant was initially created. Subsequent calls will return a masked value.\n","isRequired":true,"uniqueKey":"encryption_key","typeLabel":"string"},"legal_name":{"example":"Example Store Inc.","type":"string","description":"The name of the merchant","isRequired":true,"uniqueKey":"legal_name","typeLabel":"string"},"website_url":{"example":"https://www.example-store.com","type":"string","description":"The URL of the merchant's website","format":"uri","isRequired":true,"uniqueKey":"website_url","typeLabel":"string\u003curi>"}},"example":{"id":"00000000-0000-0000-0000-000000000000","created_at":"2023-10-10T00:00:00Z","company_city":"Berlin","country_code":"DE","encryption_key":"eyJhbGciOiJSUzI1NiIsImVudGl0bGVtZW50IjoiYWF4NXdq...","legal_name":"Example Merchant","website_url":"https://example.com"},"required":["id","created_at","company_city","country_code","encryption_key","legal_name","website_url"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"00000000-0000-0000-0000-000000000000","created_at":"2023-10-10T00:00:00Z","company_city":"Berlin","country_code":"DE","encryption_key":"eyJhbGciOiJSUzI1NiIsImVudGl0bGVtZW50IjoiYWF4NXdq...","legal_name":"Example Merchant","website_url":"https://example.com"}}},"exampleType":"generated"}},"exampleType":"generated"},"3f576def-9c2b-4656-a42b-7df347005154":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"The corresponding HTTP status code for the error","uniqueKey":"code","typeLabel":"integer"},"classifier":{"type":"string","description":"Technical code that helps to identify the error","uniqueKey":"classifier","typeLabel":"string"},"message":{"type":"string","description":"Human readable representation of the error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":401,"message":"No valid means of authentication was provided","classifier":"UNAUTHORIZED"},"examples":{"Example":{"title":"Example","value":{"code":401,"message":"No valid means of authentication was provided","classifier":"UNAUTHORIZED"}}},"exampleType":"examples"}},"exampleType":"examples"},"e64b606f-8dae-4473-b79c-f1b45ac4ed1d":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"The corresponding HTTP status code for the error","uniqueKey":"code","typeLabel":"integer"},"classifier":{"type":"string","description":"Technical code that helps to identify the error","uniqueKey":"classifier","typeLabel":"string"},"message":{"type":"string","description":"Human readable representation of the error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":403,"message":"Not allowed to access this resource or feature","classifier":"FORBIDDEN"},"examples":{"Example":{"title":"Example","value":{"code":403,"message":"Not allowed to access this resource or feature","classifier":"FORBIDDEN"}}},"exampleType":"examples"}},"exampleType":"examples"},"d7c00807-bcd8-4cd5-be42-33a33e1fb9ae":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"The corresponding HTTP status code for the error","uniqueKey":"code","typeLabel":"integer"},"classifier":{"type":"string","description":"Technical code that helps to identify the error","uniqueKey":"classifier","typeLabel":"string"},"message":{"type":"string","description":"Human readable representation of the error","uniqueKey":"message","typeLabel":"string"},"validation_errors":{"type":"array","items":{"type":"object","properties":{"path":{"example":"$.transaction.amount","type":"string","description":"Json-path in the request which points to the validation error","uniqueKey":"validation_errors.items.[INDEX].path","typeLabel":"string"},"message":{"example":"is required","type":"string","description":"Human readable validation message","uniqueKey":"validation_errors.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"validation_errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"validation_errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":422,"classifier":"VALIDATION_ERROR","message":"Validation error","validation_errors":[{"path":"json-path","message":"human readable error message"}]},"examples":{"Example":{"title":"Example","value":{"code":422,"classifier":"VALIDATION_ERROR","message":"Validation error","validation_errors":[{"path":"json-path","message":"human readable error message"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"fd8408ec-e677-4cb0-8813-d858bff37757":{"APIKeyAuth":{"type":"apiKey","name":"X-API-Key","in":"header","scopes":[],"schemeName":"APIKeyAuth"}}},"servers":{"177039e8-68d7-48a4-8b0f-1aab076efe1e":{"url":"https://sandbox.hellgate.io","description":"Commerce SaaS Sandbox"},"f4d3dc43-25ab-4780-9b17-95fa63b320bf":{"url":"https://api.hellgate.io","description":"Commerce SaaS Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"X-API-Key","in":"header","scopes":[],"schemeName":"APIKeyAuth"},"schema":{"title":"X-API-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyAuth","name":"X-API-Key"}],"title":"APIKeyAuth"}]},"originalFileLocation":"products/commerce/v2/openapi.yaml"},"subdomain":"starfishgmbhcokg","siteName":"Hellgate Cloud Platform","title":"Create a merchant - Hellgate Cloud Platform","navMaps":{"firstHrefInVersion":{"V2":{"href":"/products/commerce/v2/api-reference/merchants/create-a-merchant","matchLevel":0},"V1":{"href":"/products/commerce/v1/api-reference/accounts/overview","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-09T09:53:09.149Z","originalFileLocation":"products/commerce/v2/api-reference/merchants/create-a-merchant.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new merchant. Merchants represent legal entities which are interacting with the card networks. Onboarding merchants for an account is a prerequisite for creating network tokens. Depending on the setup of the account, this allows to render complex ecommerce ecosystem setups.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hellgate Cloud Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a merchant - Hellgate Cloud Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new merchant. Merchants represent legal entities which are interacting with the card networks. Onboarding merchants for an account is a prerequisite for creating network tokens. Depending on the setup of the account, this allows to render complex ecommerce ecosystem setups.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Hellgate Cloud Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://starfishgmbhcokg.mintlify.app/_mintlify/api/og/v2?division=Merchants\u0026amp;title=Create+a+merchant\u0026amp;description=Create+a+new+merchant.%0A%0AMerchants+represent+legal+entities+which+are+interacting+with+the+card%0Anetworks.%0A%0AOnboarding+merchants+for+an+account+is+a+prerequisite+\u0026amp;theme=6ac995623c7ee3e28a6aa4a3\u0026amp;signature=1c3b53efae643d5420bba6c4356a6f02f2e5626d0a9d29ec98a79071df8a82b3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a merchant - Hellgate Cloud Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new merchant. Merchants represent legal entities which are interacting with the card networks. Onboarding merchants for an account is a prerequisite for creating network tokens. Depending on the setup of the account, this allows to render complex ecommerce ecosystem setups.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://starfishgmbhcokg.mintlify.app/_mintlify/api/og/v2?division=Merchants\u0026amp;title=Create+a+merchant\u0026amp;description=Create+a+new+merchant.%0A%0AMerchants+represent+legal+entities+which+are+interacting+with+the+card%0Anetworks.%0A%0AOnboarding+merchants+for+an+account+is+a+prerequisite+\u0026amp;theme=6ac995623c7ee3e28a6aa4a3\u0026amp;signature=1c3b53efae643d5420bba6c4356a6f02f2e5626d0a9d29ec98a79071df8a82b3\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/starfishgmbhcokg/ehX6KGXou7_zUBXs/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Hellgate Cloud Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"OJ_nWFren-zsecLNqkmvOGrnXjmCZ_fPg5ov1mM8Tno\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/commerce/v2/api-reference/merchants/create-a-merchant.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.hellgate.io/#organization\",\"name\":\"Hellgate Cloud Platform\",\"url\":\"https://developer.hellgate.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/starfishgmbhcokg/fao_mR6VDpBCxc3o/logo/light.svg?fit=max\u0026auto=format\u0026n=fao_mR6VDpBCxc3o\u0026q=85\u0026s=1f2caba60febae2b0dcaddf3e196a132\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.hellgate.io#website\",\"name\":\"Hellgate Cloud Platform\",\"url\":\"https://developer.hellgate.io\",\"publisher\":{\"@id\":\"https://developer.hellgate.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant#webpage\",\"url\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant\",\"name\":\"Create a merchant\",\"description\":\"Create a new merchant. Merchants represent legal entities which are interacting with the card networks. Onboarding merchants for an account is a prerequisite for creating network tokens. Depending on the setup of the account, this allows to render complex ecommerce ecosystem setups.\",\"dateModified\":\"2026-10-09T09:53:09.149Z\",\"isPartOf\":{\"@id\":\"https://developer.hellgate.io#website\"},\"breadcrumb\":{\"@id\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configuration\",\"item\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/configuration/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a merchant\",\"item\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant#apireference\",\"headline\":\"Create a merchant\",\"name\":\"Create a merchant\",\"description\":\"Create a new merchant. Merchants represent legal entities which are interacting with the card networks. Onboarding merchants for an account is a prerequisite for creating network tokens. Depending on the setup of the account, this allows to render complex ecommerce ecosystem setups.\",\"url\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant\",\"mainEntityOfPage\":{\"@id\":\"https://developer.hellgate.io/products/commerce/v2/api-reference/merchants/create-a-merchant#webpage\"},\"dateModified\":\"2026-10-09T09:53:09.149Z\",\"publisher\":{\"@id\":\"https://developer.hellgate.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.hellgate.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Hellgate Cloud Platform\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Hellgate Cloud Platform","nav":{"global":null,"products":[{"product":"Cloud Platform","icon":"cloud","pages":[{"title":"Cloud Platform","href":"/platform"}]},{"product":"Guardian","icon":"vault","pages":[{"title":"Guardian","href":"/products/guardian/overview"}]},{"product":"Specter","icon":"shield","pages":[{"title":"Specter","href":"/products/specter/overview"}]},{"product":"Commerce","icon":"cart-shopping","versions":[{"version":"V2","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/products/commerce/v2/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/products/commerce/v2/guides/account-management"}]},{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"API Information","href":"/products/commerce/v2/api-reference/getting-started"}]},{"group":"Payments","pages":[{"title":"Overview","href":"/products/commerce/v2/api-reference/payments/overview"},{"group":"Customer Initiated","pages":[{"title":"One-off","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/one-off","href":"/products/commerce/v2/api-reference/payments_ci/one-off"},{"title":"Initial unscheduled","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/unscheduled","href":"/products/commerce/v2/api-reference/payments_ci/initial-unscheduled"},{"title":"Initial recurring","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/recurring","href":"/products/commerce/v2/api-reference/payments_ci/initial-recurring"}]},{"group":"Merchant Initiated","pages":[{"title":"Unscheduled","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/unscheduled/{id}/subsequent","href":"/products/commerce/v2/api-reference/payments_mi/unscheduled"},{"title":"Recurring","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/recurring/{id}/subsequent","href":"/products/commerce/v2/api-reference/payments_mi/recurring"}]},{"group":"Payment Modifications","pages":[{"title":"Capture","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/{id}/capture","href":"/products/commerce/v2/api-reference/payments_modifications/capture"},{"title":"Void","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/{id}/void","href":"/products/commerce/v2/api-reference/payments_modifications/void"},{"title":"Refund","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payments/{id}/refunds","href":"/products/commerce/v2/api-reference/payments_modifications/refund"}]},{"group":"Payment Data","pages":[{"title":"Get payments","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /payments","href":"/products/commerce/v2/api-reference/payments_data/get-payments"},{"title":"Get payment details","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /payments/{id}","href":"/products/commerce/v2/api-reference/payments_data/get-payment-details"},{"title":"List transactions","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /payments/{id}/transactions","href":"/products/commerce/v2/api-reference/payments_data/list-transactions"},{"title":"Get refunds","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /payments/{id}/refunds","href":"/products/commerce/v2/api-reference/payments_data/get-refunds"}]},{"group":"Refund Data","pages":[{"title":"Get refund details","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /refunds/{id}","href":"/products/commerce/v2/api-reference/refunds_data/get-refund-details"},{"title":"List transactions","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /refunds/{id}/transactions","href":"/products/commerce/v2/api-reference/refunds_data/list-transactions"}]},{"group":"Webhook Notifications","pages":[{"title":"Payment notification","version":null,"deprecated":null,"openapi":"/products/commerce/v2/openapi.yaml webhook paymentNotification","href":"/products/commerce/v2/api-reference/payment-notification"},{"title":"Refund notification","version":null,"deprecated":null,"openapi":"/products/commerce/v2/openapi.yaml webhook refundNotification","href":"/products/commerce/v2/api-reference/refund-notification"}]}]},{"group":"Authentications","pages":[{"title":"Overview","href":"/products/commerce/v2/api-reference/authentications/overview"},{"group":"Customer Initiated","pages":[{"title":"One-off","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /authentications/one-off","href":"/products/commerce/v2/api-reference/authentications_ci/one-off"},{"title":"Initial recurring","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /authentications/recurring","href":"/products/commerce/v2/api-reference/authentications_ci/initial-recurring"},{"title":"Initial installment","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /authentications/installment","href":"/products/commerce/v2/api-reference/authentications_ci/initial-installment"}]},{"group":"Merchant Initiated (3RI)","pages":[{"title":"Subsequent recurring","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /authentications/recurring/{id}/subsequent","href":"/products/commerce/v2/api-reference/authentications_mi/subsequent-recurring"},{"title":"Subsequent installment","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /authentications/installment/{id}/subsequent","href":"/products/commerce/v2/api-reference/authentications_mi/subsequent-installment"}]},{"group":"Authentication Data","pages":[{"title":"Get authentications","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /authentications","href":"/products/commerce/v2/api-reference/authentications_data/get-authentications"},{"title":"Get an authentication","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /authentications/{id}","href":"/products/commerce/v2/api-reference/authentications_data/get-an-authentication"}]}]},{"group":"Customer Data","pages":[{"title":"Overview","href":"/products/commerce/v2/api-reference/customer-data/overview"},{"group":"Credentials on File","pages":[{"title":"Get credentials","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /credentials","href":"/products/commerce/v2/api-reference/credentials_management/get-credentials"},{"title":"Get credential details","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /credentials/{id}","href":"/products/commerce/v2/api-reference/credentials_management/get-credential-details"},{"title":"Delete credentials","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml delete /credentials/{id}","href":"/products/commerce/v2/api-reference/credentials_management/delete-credentials"}]}]},{"group":"Tokens","pages":[{"title":"Overview","href":"/products/commerce/v2/api-reference/tokens/overview"},{"group":"Create Tokens","pages":[{"title":"Request a token session","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/session","href":"/products/commerce/v2/api-reference/tokens_create/request-a-token-session"},{"title":"Create token from FPAN","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /cde-import","href":"/products/commerce/v2/api-reference/tokens_create/create-token-from-fpan"}]},{"group":"Token Management","pages":[{"title":"Get tokens","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens","href":"/products/commerce/v2/api-reference/tokens_management/get-tokens"},{"title":"Get token details","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens/{id}","href":"/products/commerce/v2/api-reference/tokens_management/get-token-details"},{"title":"Delete a token","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml delete /tokens/{id}","href":"/products/commerce/v2/api-reference/tokens_management/delete-a-token"},{"title":"Check CVC2","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens/{id}/security-code","href":"/products/commerce/v2/api-reference/tokens_management/check-cvc2"},{"title":"Refresh CVC2","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/{id}/refresh-session","href":"/products/commerce/v2/api-reference/tokens_management/refresh-cvc2"},{"title":"Consume a token","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/{id}/consume","href":"/products/commerce/v2/api-reference/tokens_management/consume-a-token"},{"title":"Refresh token metadata","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/{id}/refresh-metadata","href":"/products/commerce/v2/api-reference/tokens_management/refresh-token-metadata"},{"title":"Get card art","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens/{id}/card-art","href":"/products/commerce/v2/api-reference/tokens_management/get-card-art"},{"title":"Download card art","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens/card-art/{id}","href":"/products/commerce/v2/api-reference/tokens_management/download-card-art"}]},{"group":"Compliance Service","pages":[{"title":"Forward card data","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /forward","href":"/products/commerce/v2/api-reference/compliance_service/forward-card-data"}]},{"group":"Network Tokens","pages":[{"title":"Update a network token","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/{id}/provisions","href":"/products/commerce/v2/api-reference/network_tokens/update-a-network-token"},{"title":"Request payment-data","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /tokens/{id}/payment-data","href":"/products/commerce/v2/api-reference/network_tokens/request-payment-data"},{"title":"Get payment-data","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /tokens/{id}/payment-data","href":"/products/commerce/v2/api-reference/network_tokens/get-payment-data"},{"title":"Forward payment-data","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /payment-data/{id}/forward","href":"/products/commerce/v2/api-reference/network_tokens/forward-payment-data"}]},{"group":"Webhook Notifications","pages":[{"title":"Token notification","version":null,"deprecated":null,"openapi":"/products/commerce/v2/openapi.yaml webhook tokenNotification","href":"/products/commerce/v2/api-reference/token-notification"}]}]},{"group":"Configuration","pages":[{"title":"Overview","description":"Configure and manage merchant accounts","href":"/products/commerce/v2/api-reference/configuration/overview"},{"group":"Merchants","pages":[{"title":"Create a merchant","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml post /merchants","href":"/products/commerce/v2/api-reference/merchants/create-a-merchant"},{"title":"Get merchants","description":"Get a list of all merchants that belong to this account.\n\nThe results are grouped into pages. The caller can specify how many\ncustomers per page shall be listed (maximum is 500).\n","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /merchants","href":"/products/commerce/v2/api-reference/merchants/get-merchants"},{"title":"Get merchant details","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /merchants/{id}","href":"/products/commerce/v2/api-reference/merchants/get-merchant-details"},{"title":"Update merchant","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml patch /merchants/{id}","href":"/products/commerce/v2/api-reference/merchants/update-merchant"},{"title":"Delete a merchant","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml delete /merchants/{id}","href":"/products/commerce/v2/api-reference/merchants/delete-a-merchant"}]}]},{"group":"Automation","pages":[{"title":"Overview","href":"/products/commerce/v2/api-reference/automation/overview"},{"group":"Reconciliation","pages":[{"title":"Token Import Report","deprecated":null,"version":null,"openapi":"/products/commerce/v2/openapi.yaml get /reports/tokens","href":"/products/commerce/v2/api-reference/reconciliation/token-import-report"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/products/commerce/v2/changelog"}]}]},{"version":"V1","pages":[{"title":"V1","href":"/products/commerce/v1/api-reference/accounts/overview"}]}]},{"product":"Link","icon":"link","pages":[{"title":"Link","href":"/products/link/overview"}]}]},"basePath":"","title":"Create a merchant - Hellgate Cloud Platform","buildId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","deploymentId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CVpqyvFO.js","utils-vpweLD0v.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BIOodqb0.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1LM3qmu.js","snippetPresets-C5xK0GtN.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CN9QbZiA.js","ApiExamples-CCsxLnQl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C2-WKG22.js","shallow-SdoLUC-q.js","getApiPlaygroundDisplay-BnI8L2hB.js","CodeSnippet-D5M8NCHI.js","CodeSnippets-CXRO8Uom.js","getPastedJson-CrfHEdRt.js","icon-Cr8AyUnW.js","MethodPill-J_Cs0kNw.js","DuplicateIcon-DrMboxGw.js","createIcon-B4CIWVbU.js","DynamicMarkdown-D9cdbgj9.js","SectionHeading-BO4CouT0.js","axios-vUo_bRtp.js","Markdown-L1m1-PSi.js","clsx-rIpTdK8h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-ptfS1uB_.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D31Sm3f9.js"]}