Create a new merchant under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"WalletConnect Pay Docs","description":"Documentation for WalletConnect Pay. Integrate secure crypto payments into your app with step-by-step guides, APIs, and best practices.","colors":{"primary":"#0988f0","light":"#0988f0","dark":"#0988f0"},"logo":{"light":"https://mintcdn.com/walletconnect_pay_docs/hAPTTKKg55YyUMTO/logo/light.svg?fit=max\u0026auto=format\u0026n=hAPTTKKg55YyUMTO\u0026q=85\u0026s=ebf607462c774689b134b3c9d014f2b6","dark":"https://mintcdn.com/walletconnect_pay_docs/hAPTTKKg55YyUMTO/logo/dark.svg?fit=max\u0026auto=format\u0026n=hAPTTKKg55YyUMTO\u0026q=85\u0026s=c6587dca1b7047e52e05128cae4d761d"},"favicon":"https://mintcdn.com/walletconnect_pay_docs/lm0OdcLBlwNo7Hlw/favicon.ico?fit=max\u0026auto=format\u0026n=lm0OdcLBlwNo7Hlw\u0026q=85\u0026s=79443c7fd764d213336cee1ac43b8872","navbar":{"links":[{"href":"https://walletguide.walletconnect.com/","label":"WalletGuide"}],"primary":{"type":"button","label":"Request Demo","href":"https://share.hsforms.com/19Dpp4ayYR9uriB3xNAh0JAnxw6s"}},"footer":{"socials":{"website":"https://walletconnect.com","x":"https://x.com/walletconnect","discord":"https://discord.walletconnect.com","github":"https://github.com/WalletConnect","linkedin":"https://www.linkedin.com/company/walletconnectnetwork"}},"integrations":{"posthog":{"apiKey":"phc_yUywlbA5HctEGSHSK7ueMEH56ktyqyqEBtY4Cl35Fgf","apiHost":"https://pineapple.walletconnect.com"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"WalletConnect","icon":"globe","href":"https://walletconnect.com"},{"anchor":"Blog","icon":"newspaper","href":"https://walletconnect.com/blog"},{"anchor":"Whitepaper","icon":"book","href":"https://whitepaper.walletconnect.com/"},{"anchor":"Report an Issue","icon":"bug","href":"/report-an-issue"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"walletconnect_pay_docs","hasAudioNarration":false,"actualSubdomain":"walletconnect_pay_docs","customDomains":["docs.walletconnect.com"],"gitSource":{"type":"github","owner":"walletconnect","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae36b7f941bc18f0c834cd3","collectionId":"63fbf074-46a6-43bd-9a81-38e65f095ec1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae36b7f941bc18f0c834cd3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae36b7f941bc18f0c834cd3","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Wallets","count":103},{"language":"default","tag":"Payments","count":56},{"language":"default","tag":"API Reference","count":49},{"language":"default","tag":"Wallet SDK - Overview","count":36},{"language":"default","tag":"Core","count":30},{"language":"default","tag":"Merchants","count":22},{"language":"default","tag":"For Wallets","count":19},{"language":"default","tag":"Get Started","count":18},{"language":"default","tag":"Cloud","count":18},{"language":"default","tag":"Android","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"payments/api-reference/2026-02-18/post-v1-merchants","slug":"/payments/api-reference/2026-02-18/post-v1-merchants","pageMetadata":{"title":"Create a merchant","openapi":"api/2026-02-18.json POST /v1/merchants","description":"Create a new merchant under the authenticated partner. Requires an `Idempotency-Key` header so retries safely return the originally-created merchant rather than creating duplicates.","href":"/payments/api-reference/2026-02-18/post-v1-merchants"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a new merchant under the authenticated partner. Requires an \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" header so retries safely return the originally-created merchant rather than creating duplicates.\"]\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","openapi":"api/2026-02-18.json POST /v1/merchants","description":"Create a new merchant under the authenticated partner. Requires an `Idempotency-Key` header so retries safely return the originally-created merchant rather than creating duplicates.","href":"/payments/api-reference/2026-02-18/post-v1-merchants"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/walletconnect--5f--pay--5f--docs/3bc26322da5c91d6/copy-agent-prompt.js"],"openApiReferenceData":{"operation":{"operationId":"MerchantManagement_create","tags":["Merchant Management"],"summary":"Create a merchant","description":"Create a new merchant under the authenticated partner. Requires an `Idempotency-Key` header so retries safely return the originally-created merchant rather than creating duplicates.","parameters":["963ac4f0-6ddc-49eb-9f5c-aeb7311b4ff6"],"responses":{"201":"453d1d90-b8c3-45bc-ab2b-b455bea0bc2c","400":"1385a59a-76a3-4e13-9e1c-6d768fdc74cb","401":"dd33810b-bc82-4363-83bd-b1567d11004e","409":"1cdbbc6f-2bf2-42f4-9e23-3e82d107d774","500":"52e93119-1afc-47d6-91e4-cf6e48095e99","502":"f7fc7a73-95bf-41a9-827f-cc7ffa2e2fe5"},"requestBody":"2ff4dfd1-7d07-427b-b647-6bf717a63ffc","method":"post","type":"path","servers":["2cc0008c-dc4d-483f-bfbc-ac7731f30e3a"],"security":["e26c1f20-13fe-4e85-ac42-b1e9a918f2bf","9fc12753-7c29-48f1-b157-54abcd13fd2e","c6596607-0309-47a3-852a-f47efc142515"],"path":"/v1/merchants","baseUrlOptions":["https://api.pay.walletconnect.com"],"title":"Create a merchant","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"963ac4f0-6ddc-49eb-9f5c-aeb7311b4ff6":{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key to ensure idempotent request processing. Max 255 characters.","schema":{"type":"string","maxLength":255,"isRequired":true,"description":"Unique key to ensure idempotent request processing. Max 255 characters.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"merchantName":{"type":"string","minLength":1,"maxLength":256,"description":"Display name for the merchant","examples":["Acme Store"],"isRequired":true,"uniqueKey":"merchantName","typeLabel":"string"},"merchantEmail":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Contact email for the merchant","examples":["billing@acme.store"],"isRequired":true,"uniqueKey":"merchantEmail","typeLabel":"string\u003cemail>"},"iconUrl":{"oneOf":[{"type":"string","description":"Merchant logo URL (HTTPS only), or null to unset","format":"uri","example":"https://example.com/logo.png","uniqueKey":"iconUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","description":"Merchant logo URL (HTTPS only), or null to unset","example":"https://example.com/logo.png","uniqueKey":"iconUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"iconUrl","typeLabel":"string\u003curi> | null"}},"required":["merchantName","merchantEmail"],"examples":[{"merchantName":"Acme Store","merchantEmail":"billing@acme.store","iconUrl":"https://example.com/logo.png"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"merchantName":"Acme Store","merchantEmail":"billing@acme.store","iconUrl":"https://example.com/logo.png"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"453d1d90-b8c3-45bc-ab2b-b455bea0bc2c":{"description":"Merchant created","content":{"application/json":{"schema":{"type":"object","properties":{"merchant":{"type":"object","properties":{"id":{"type":"string","description":"Merchant ID","examples":["mrch_7kBz2qR9xPvLmN4Yw"],"isRequired":true,"uniqueKey":"merchant.id","typeLabel":"string"},"name":{"description":"Merchant display name","type":"string","isRequired":true,"uniqueKey":"merchant.name","typeLabel":"string"},"email":{"oneOf":[{"type":"string","description":"Contact email","example":"billing@acme.store","isRequired":true,"uniqueKey":"merchant.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Contact email","example":"billing@acme.store","isRequired":true,"uniqueKey":"merchant.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"merchant.email","typeLabel":"string | null"},"status":{"type":"string","enum":["active","inactive","suspended"],"description":"Current merchant status","examples":["active"],"isRequired":true,"uniqueKey":"merchant.status","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","description":"ISO 8601 creation timestamp","examples":["2025-06-15T10:30:00.000Z"],"isRequired":true,"uniqueKey":"merchant.createdAt","typeLabel":"string"}},"required":["id","name","email","status","createdAt"],"isRequired":true,"uniqueKey":"merchant","typeLabel":"object"}},"required":["merchant"],"uniqueKey":"","typeLabel":"object"},"example":{"merchant":{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store","email":"billing@acme.store","status":"active","createdAt":"2025-06-15T10:30:00.000Z"}},"examples":{"Example":{"title":"Example","value":{"merchant":{"id":"mrch_7kBz2qR9xPvLmN4Yw","name":"Acme Store","email":"billing@acme.store","status":"active","createdAt":"2025-06-15T10:30:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"1385a59a-76a3-4e13-9e1c-6d768fdc74cb":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["params_validation","missing_idempotency_key"],"description":"Machine-readable error code","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"},"issues":{"type":"array","description":"Field-level validation issues (present on validation errors)","items":{"type":"object","required":["field","message"],"properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"issues.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"issues.items.[INDEX]","typeLabel":"object"},"uniqueKey":"issues","typeLabel":"object[]"}},"required":["message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"params_validation":{"title":"params_validation","value":{"code":"params_validation","message":"Validation failed"}},"missing_idempotency_key":{"title":"missing_idempotency_key","value":{"code":"missing_idempotency_key","message":"Missing Idempotency-Key header"}}},"exampleType":"examples"}},"exampleType":"examples"},"dd33810b-bc82-4363-83bd-b1567d11004e":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","enum":["missing_api_key","invalid_api_key"],"description":"Machine-readable error code","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"required":["message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"missing_api_key":{"title":"missing_api_key","value":{"code":"missing_api_key","message":"Missing API key"}},"invalid_api_key":{"title":"invalid_api_key","value":{"code":"invalid_api_key","message":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"1cdbbc6f-2bf2-42f4-9e23-3e82d107d774":{"description":"Idempotency conflict","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"idempotency_conflict","description":"Machine-readable error code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"required":["message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"idempotency_conflict":{"title":"idempotency_conflict","value":{"code":"idempotency_conflict","message":"Idempotency key conflict: same key was used with a different request body"}}},"exampleType":"examples"}},"exampleType":"examples"},"52e93119-1afc-47d6-91e4-cf6e48095e99":{"description":"Internal error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"internal_error","description":"Machine-readable error code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"required":["message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"internal_error":{"title":"internal_error","value":{"code":"internal_error","message":"Internal Server Error"}}},"exampleType":"examples"}},"exampleType":"examples"},"f7fc7a73-95bf-41a9-827f-cc7ffa2e2fe5":{"description":"Bad gateway","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","const":"bad_gateway","description":"Machine-readable error code","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"details":{"description":"Additional structured error details","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"details.additionalProperties","typeLabel":"any"},"uniqueKey":"details","typeLabel":"object"}},"required":["message","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"bad_gateway":{"title":"bad_gateway","value":{"code":"bad_gateway","message":"Bad Gateway"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e26c1f20-13fe-4e85-ac42-b1e9a918f2bf":{"API Key":{"type":"apiKey","in":"header","name":"Api-Key","scopes":[]}},"9fc12753-7c29-48f1-b157-54abcd13fd2e":{"ApiKey":{"type":"apiKey","in":"header","name":"Api-Key","description":"Private API key for wallet authentication","scopes":[]}},"c6596607-0309-47a3-852a-f47efc142515":{"AppId":{"type":"apiKey","in":"header","name":"App-Id","description":"Public App ID for wallet authentication. When using this auth mode, the Client-Id header is also required.","scopes":[]}}},"servers":{"2cc0008c-dc4d-483f-bfbc-ac7731f30e3a":{"url":"https://api.pay.walletconnect.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Api-Key","scopes":[]},"schema":{"title":"Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"API Key","name":"Api-Key"}],"title":"API Key"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Api-Key","description":"Private API key for wallet authentication","scopes":[]},"schema":{"title":"Api-Key","type":"string","description":"Private API key for wallet authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"Api-Key"}],"title":"ApiKey"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"App-Id","description":"Public App ID for wallet authentication. When using this auth mode, the Client-Id header is also required.","scopes":[]},"schema":{"title":"App-Id","type":"string","description":"Public App ID for wallet authentication. When using this auth mode, the Client-Id header is also required.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"AppId","name":"App-Id"}],"title":"AppId"}]},"originalFileLocation":"api/2026-02-18.json"},"subdomain":"walletconnect--5f--pay--5f--docs","siteName":"WalletConnect Pay Docs","title":"Create a merchant - WalletConnect Pay Docs","navMaps":{"firstHrefInVersion":{"2026-02-18":{"href":"/payments/api-reference/2026-02-18/post-v1-merchants","matchLevel":0},"2026-02-19.preview":{"href":"/payments/api-reference/2026-02-19.preview/post-v1-merchants","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-09-07T14:24:32.848Z","originalFileLocation":"payments/api-reference/2026-02-18/post-v1-merchants.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 under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WalletConnect Pay Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a merchant - WalletConnect Pay Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new merchant under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WalletConnect Pay Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://walletconnect_pay_docs.mintlify.app/_mintlify/api/og/v2?division=Merchants\u0026amp;title=Create+a+merchant\u0026amp;description=Create+a+new+merchant+under+the+authenticated+partner.+Requires+an+%60Idempotency-Key%60+header+so+retries+safely+return+the+originally-created+merchant+rather+than\u0026amp;theme=b1dae4acff00d11c99d5cf94\u0026amp;signature=7dfc86315e4362bfa29036e51e6c89acea535fdec1335c542eb3ea1ab881aa5d\">\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 - WalletConnect Pay Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new merchant under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://walletconnect_pay_docs.mintlify.app/_mintlify/api/og/v2?division=Merchants\u0026amp;title=Create+a+merchant\u0026amp;description=Create+a+new+merchant+under+the+authenticated+partner.+Requires+an+%60Idempotency-Key%60+header+so+retries+safely+return+the+originally-created+merchant+rather+than\u0026amp;theme=b1dae4acff00d11c99d5cf94\u0026amp;signature=7dfc86315e4362bfa29036e51e6c89acea535fdec1335c542eb3ea1ab881aa5d\">\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/walletconnect_pay_docs/AOcwI5P3wfLhVKH9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WalletConnect Pay Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0988f0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/payments/api-reference/2026-02-18/post-v1-merchants.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.walletconnect.com/#organization\",\"name\":\"WalletConnect Pay Docs\",\"url\":\"https://docs.walletconnect.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/walletconnect_pay_docs/hAPTTKKg55YyUMTO/logo/light.svg?fit=max\u0026auto=format\u0026n=hAPTTKKg55YyUMTO\u0026q=85\u0026s=ebf607462c774689b134b3c9d014f2b6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.walletconnect.com#website\",\"name\":\"WalletConnect Pay Docs\",\"url\":\"https://docs.walletconnect.com\",\"publisher\":{\"@id\":\"https://docs.walletconnect.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants#webpage\",\"url\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants\",\"name\":\"Create a merchant\",\"description\":\"Create a new merchant under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.\",\"dateModified\":\"2026-09-07T14:24:32.848Z\",\"isPartOf\":{\"@id\":\"https://docs.walletconnect.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Merchants\",\"item\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/get-v1-merchants-payments\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a merchant\",\"item\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants#apireference\",\"headline\":\"Create a merchant\",\"name\":\"Create a merchant\",\"description\":\"Create a new merchant under the authenticated partner. Requires an Idempotency-Key header so retries safely return the originally-created merchant rather than creating duplicates.\",\"url\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants\",\"mainEntityOfPage\":{\"@id\":\"https://docs.walletconnect.com/payments/api-reference/2026-02-18/post-v1-merchants#webpage\"},\"dateModified\":\"2026-09-07T14:24:32.848Z\",\"publisher\":{\"@id\":\"https://docs.walletconnect.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.walletconnect.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WalletConnect Pay Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"WalletConnect Pay Docs","nav":{"global":{"anchors":[{"anchor":"WalletConnect","icon":"globe","href":"https://walletconnect.com"},{"anchor":"Blog","icon":"newspaper","href":"https://walletconnect.com/blog"},{"anchor":"Whitepaper","icon":"book","href":"https://whitepaper.walletconnect.com/"},{"anchor":"Report an Issue","icon":"bug","href":"/report-an-issue"}]},"tabs":[{"tab":"Wallets","icon":"wallet","dropdowns":[{"dropdown":"Wallet SDK - Overview","icon":"wallet","pages":[{"mode":"frame","title":"WalletConnect Documentation","sidebarTitle":"Home","href":""},{"group":"Getting Started","pages":[{"title":"WalletConnect Wallet SDK","sidebarTitle":"Quickstart","href":"/wallets/overview"}]},{"group":"Features","pages":[{"title":"Verify API","sidebarTitle":"Verify","href":"/wallets/features/verify"},{"title":"Link Mode","href":"/wallets/features/link-mode"},{"title":"One-Click Auth","href":"/wallets/features/one-click-auth"}]},{"group":"Chain Support","pages":[{"title":"Chain Support","sidebarTitle":"Overview","href":"/wallets/chains/overview"},{"title":"Ethereum","href":"/wallets/chains/evm"},{"title":"Solana","href":"/wallets/chains/solana"},{"title":"Bitcoin","href":"/wallets/chains/bitcoin"},{"title":"Sui","href":"/wallets/chains/sui"},{"title":"Stacks","href":"/wallets/chains/stacks"},{"title":"TON","href":"/wallets/chains/ton"},{"title":"Tron","href":"/wallets/chains/tron"},{"title":"ADI Chain","href":"/wallets/chains/adi"},{"title":"Canton","href":"/wallets/chains/canton"},{"title":"Stellar","href":"/wallets/chains/stellar"}]},{"group":"WalletGuide","pages":[{"title":"WalletGuide Submission","sidebarTitle":"Submit New Wallet","href":"/wallets/walletguide/submit-wallet"},{"title":"Wallets","sidebarTitle":"Wallet List","href":"/wallets/walletguide/wallet-list"},{"title":"Chain Onboarding","sidebarTitle":"Submit New Chain","href":"/wallets/walletguide/submit-chain"},{"title":"Supported Chains","href":"/wallets/walletguide/chain-list"},{"title":"Explorer API","href":"/wallets/walletguide/explorer-api"},{"title":"WalletConnect Certified","sidebarTitle":"WalletConnect Certified","href":"/wallets/walletguide/certified"}]},{"group":"More","pages":[{"sidebarTitle":"Best Practices","title":"Best Practices for Wallets","href":"/wallets/more/best-practices"},{"sidebarTitle":"Push Notifications","title":"Push Notifications","href":"/wallets/more/push-notifications"},{"title":"Staying up to date","href":"/wallets/more/updating-wallet-sdk"},{"group":"Web3Wallet to Wallet SDK","pages":[{"title":"Upgrade from Web3Wallet to Reown WalletKit","sidebarTitle":"Overview","href":"/wallets/more/web3wallet-migration/quickstart"},{"title":"Upgrade from Web3Wallet to WalletKit for Web","sidebarTitle":"WalletKit - Web","href":"/wallets/more/web3wallet-migration/web"},{"title":"Upgrade from Web3Wallet to WalletKit for React Native","sidebarTitle":"WalletKit - React Native","href":"/wallets/more/web3wallet-migration/react-native"},{"title":"Upgrade from Web3Wallet to WalletKit for Flutter","sidebarTitle":"WalletKit - Flutter","href":"/wallets/more/web3wallet-migration/flutter"},{"title":"Upgrade from Web3Wallet to WalletKit for Android","sidebarTitle":"WalletKit - Android","href":"/wallets/more/web3wallet-migration/android"},{"title":"Upgrade from Web3Wallet to WalletKit for iOS","sidebarTitle":"WalletKit - iOS","href":"/wallets/more/web3wallet-migration/ios"},{"title":"Upgrade from Web3Wallet to WalletKit for .NET","sidebarTitle":"WalletKit - Unity","href":"/wallets/more/web3wallet-migration/unity"}]}]},{"group":"Custodians \u0026 Institutions","pages":[{"title":"WalletConnect for Custodians and Institutions","sidebarTitle":"Quickstart","href":"/wallets/custodians/overview"},{"title":"How to Control Which Apps Can Connect to Your Users’ Wallets","sidebarTitle":"Managing Dapp Access","href":"/wallets/custodians/app-access-control"},{"title":"How to Control Which Smart Contracts Your Users Can Interact With","sidebarTitle":"Managing Smart Contract Access","href":"/wallets/custodians/contract-access-control"},{"title":"Extended WalletConnect Sessions Request","sidebarTitle":"Extended Sessions Request","href":"/wallets/custodians/extended-sessions"}]}]},{"dropdown":"Web","icon":"js","description":"Wallet SDK on Web","pages":[{"title":"Installation","href":"/wallets/web/installation"},{"title":"Usage","href":"/wallets/web/usage"},{"title":"One-click Auth","href":"/wallets/web/one-click-auth"},{"title":"Verify API","href":"/wallets/web/verify"},{"title":"Wallet Call API","href":"/wallets/web/eip5792"},{"title":"Chain Abstraction","href":"/wallets/web/chain-abstraction"},{"title":"Best Practices","href":"/wallets/web/best-practices"},{"title":"Resources","href":"/wallets/web/resources"},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/web/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/web/cloud/relay"},{"title":"Analytics","href":"/wallets/web/cloud/analytics"}]}]},{"dropdown":"Android","icon":"android","description":"Wallet SDK on Android","pages":[{"group":"Core","pages":[{"title":"Installation","href":"/wallets/android/installation"},{"title":"Usage","href":"/wallets/android/usage"},{"title":"One-click Auth","href":"/wallets/android/one-click-auth"},{"title":"Mobile Linking","href":"/wallets/android/mobile-linking"},{"title":"Link Mode","href":"/wallets/android/link-mode"},{"title":"Verify API","href":"/wallets/android/verify"},{"title":"Wallet Call API","href":"/wallets/android/eip5792"},{"title":"Chain Abstraction","href":"/wallets/android/chain-abstraction"},{"title":"Best Practices","href":"/wallets/android/best-practices"},{"title":"Resources","href":"/wallets/android/resources"}]},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/android/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/android/cloud/relay"},{"title":"Analytics","href":"/wallets/android/cloud/analytics"}]}]},{"dropdown":"iOS","icon":"apple","description":"Wallet SDK on iOS","pages":[{"group":"Core","pages":[{"title":"Installation","href":"/wallets/ios/installation"},{"title":"Usage","href":"/wallets/ios/usage"},{"title":"One-click Auth","href":"/wallets/ios/one-click-auth"},{"title":"Mobile Linking","href":"/wallets/ios/mobile-linking"},{"title":"Link Mode","href":"/wallets/ios/link-mode"},{"title":"Verify API","href":"/wallets/ios/verify"},{"title":"Wallet Call API","href":"/wallets/ios/eip5792"},{"title":"Chain Abstraction","href":"/wallets/ios/chain-abstraction"},{"title":"Best Practices","href":"/wallets/ios/best-practices"},{"title":"Resources","href":"/wallets/ios/resources"}]},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/ios/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/ios/cloud/relay"},{"title":"Analytics","href":"/wallets/ios/cloud/analytics"}]}]},{"dropdown":"Flutter","icon":"flutter","description":"Wallet SDK on Flutter","pages":[{"title":"Installation","href":"/wallets/flutter/installation"},{"title":"Usage","href":"/wallets/flutter/usage"},{"title":"One-click Auth","href":"/wallets/flutter/one-click-auth"},{"title":"Mobile Linking","href":"/wallets/flutter/mobile-linking"},{"title":"Link Mode","href":"/wallets/flutter/link-mode"},{"title":"Verify API","href":"/wallets/flutter/verify"},{"title":"Wallet Call API","href":"/wallets/flutter/eip5792"},{"title":"Chain Abstraction","href":"/wallets/flutter/chain-abstraction"},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/flutter/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/flutter/cloud/relay"},{"title":"Analytics","href":"/wallets/flutter/cloud/analytics"}]}]},{"dropdown":"React Native","icon":"mobile-screen-button","description":"Wallet SDK on React Native","pages":[{"group":"Core","pages":[{"title":"Installation","href":"/wallets/react-native/installation"},{"title":"Usage","href":"/wallets/react-native/usage"},{"title":"One-click Auth","href":"/wallets/react-native/one-click-auth"},{"title":"Mobile Linking","href":"/wallets/react-native/mobile-linking"},{"title":"Link Mode","href":"/wallets/react-native/link-mode"},{"title":"Verify API","href":"/wallets/react-native/verify"},{"title":"Wallet Call API","href":"/wallets/react-native/eip5792"},{"title":"Chain Abstraction","href":"/wallets/react-native/chain-abstraction"},{"title":"Best Practices","href":"/wallets/react-native/best-practices"},{"title":"Resources","href":"/wallets/react-native/resources"}]},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/react-native/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/react-native/cloud/relay"},{"title":"Analytics","href":"/wallets/react-native/cloud/analytics"}]}]},{"dropdown":".NET","icon":"code","description":"Wallet SDK on .NET","pages":[{"title":"Installation","href":"/wallets/c-sharp/installation"},{"title":"Usage","href":"/wallets/c-sharp/usage"},{"title":"Verify API","href":"/wallets/c-sharp/verify"},{"group":"Cloud","pages":[{"title":"Explorer Submission","href":"/wallets/c-sharp/cloud/explorer-submission"},{"title":"Relay","href":"/wallets/c-sharp/cloud/relay"},{"title":"Analytics","href":"/wallets/c-sharp/cloud/analytics"}]}]}]},{"tab":"Apps","icon":"layer-group","pages":[{"title":"Apps","href":"/apps/overview"}]},{"tab":"Network","icon":"globe","pages":[{"title":"Network","href":"/network"}]},{"tab":"Payments","icon":"credit-card","pages":[{"title":"Payments","href":"/payments/overview"}]},{"tab":"Wallet Verification","icon":"shield-check","pages":[{"title":"Wallet Verification","href":"/wallet-verification/overview"}]},{"tab":"API Reference","icon":"code","versions":[{"version":"2026-02-18","default":true,"tag":"Latest","groups":[{"group":"Overview","pages":[{"title":"API Reference","sidebarTitle":"Overview","href":"/payments/api-reference"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/payments/api-reference/authentication"},{"title":"API Versioning","sidebarTitle":"Versioning","href":"/payments/api-reference/versioning"}]},{"group":"Gateway","pages":[{"title":"Get a payment","openapi":"api/2026-02-18.json GET /v1/gateway/payment/{id}","href":"/payments/api-reference/2026-02-18/get-v1-gateway-payment-id"},{"title":"POST /v1/gateway/payment/{id}/cancel","openapi":"api/2026-02-18.json POST /v1/gateway/payment/{id}/cancel","href":"/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-cancel"},{"title":"Confirm a payment","openapi":"api/2026-02-18.json POST /v1/gateway/payment/{id}/confirm","href":"/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-confirm"},{"title":"Fetches an action","openapi":"api/2026-02-18.json POST /v1/gateway/payment/{id}/fetch","href":"/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-fetch"},{"title":"Get payment options","openapi":"api/2026-02-18.json POST /v1/gateway/payment/{id}/options","href":"/payments/api-reference/2026-02-18/post-v1-gateway-payment-id-options"},{"title":"Get the payment status","openapi":"api/2026-02-18.json GET /v1/gateway/payment/{id}/status","href":"/payments/api-reference/2026-02-18/get-v1-gateway-payment-id-status"}]},{"group":"Payments","pages":[{"title":"Create a new payment","openapi":"api/2026-02-18.json POST /v1/payments","href":"/payments/api-reference/2026-02-18/post-v1-payments"},{"title":"List payments","openapi":"api/2026-02-18.json GET /v1/payments","href":"/payments/api-reference/2026-02-18/get-v1-payments"},{"title":"Get payment details","openapi":"api/2026-02-18.json GET /v1/payments/{id}","href":"/payments/api-reference/2026-02-18/get-v1-payments-id"},{"title":"POST /v1/payments/{id}/cancel","openapi":"api/2026-02-18.json POST /v1/payments/{id}/cancel","href":"/payments/api-reference/2026-02-18/post-v1-payments-id-cancel"},{"title":"Get the payment status","openapi":"api/2026-02-18.json GET /v1/payments/{id}/status","href":"/payments/api-reference/2026-02-18/get-v1-payments-id-status"}]},{"group":"Refunds","pages":[{"title":"Mark a payment as refunded","openapi":"api/2026-02-18.json POST /v1/refunds","href":"/payments/api-reference/2026-02-18/post-v1-refunds"}]},{"group":"Merchants","pages":[{"title":"List payments for a merchant","openapi":"api/2026-02-18.json GET /v1/merchants/payments","description":"Retrieve paginated payments with optional filters.","href":"/payments/api-reference/2026-02-18/get-v1-merchants-payments"},{"title":"Create a merchant","openapi":"api/2026-02-18.json POST /v1/merchants","href":"/payments/api-reference/2026-02-18/post-v1-merchants"},{"title":"List merchants","openapi":"api/2026-02-18.json GET /v1/merchants","description":"List the partner's merchants. Supports filtering by `status`, free-text `search` over name and ID, and cursor-based pagination via `cursor` and `limit`.","href":"/payments/api-reference/2026-02-18/get-v1-merchants"},{"title":"Get a merchant","openapi":"api/2026-02-18.json GET /v1/merchants/{merchantId}","href":"/payments/api-reference/2026-02-18/get-v1-merchants-merchantid"},{"title":"Update a merchant","openapi":"api/2026-02-18.json PATCH /v1/merchants/{merchantId}","href":"/payments/api-reference/2026-02-18/patch-v1-merchants-merchantid"},{"title":"Delete a merchant","openapi":"api/2026-02-18.json DELETE /v1/merchants/{merchantId}","href":"/payments/api-reference/2026-02-18/delete-v1-merchants-merchantid"},{"title":"List settlements","openapi":"api/2026-02-18.json GET /v1/merchants/{merchantId}/settlements","href":"/payments/api-reference/2026-02-18/get-v1-merchants-merchantid-settlements"},{"title":"Create crypto settlements","openapi":"api/2026-02-18.json POST /v1/merchants/{merchantId}/settlements/crypto","href":"/payments/api-reference/2026-02-18/post-v1-merchants-merchantid-settlements-crypto"},{"title":"Update a crypto settlement destination","openapi":"api/2026-02-18.json PUT /v1/merchants/{merchantId}/settlements/crypto/{id}","href":"/payments/api-reference/2026-02-18/put-v1-merchants-merchantid-settlements-crypto-id"},{"title":"Delete a crypto settlement","openapi":"api/2026-02-18.json DELETE /v1/merchants/{merchantId}/settlements/crypto/{id}","href":"/payments/api-reference/2026-02-18/delete-v1-merchants-merchantid-settlements-crypto-id"},{"title":"Get payments for a merchant","openapi":"api/2026-02-18.json GET /v1/merchants/{merchant_id}/payments","href":"/payments/api-reference/2026-02-18/get-v1-merchants-merchant-id-payments"}]}]},{"version":"2026-02-19.preview","pages":[{"title":"2026-02-19.preview","href":"/payments/api-reference/2026-02-19.preview/post-v1-merchants"}]}]}]},"title":"Create a merchant - WalletConnect Pay Docs","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}