As part of the integration process, you need to set up an HTTPS webhook endpoint where CryptoProcessing can send callbacks. After you create the endpoint, register it in CryptoProcessing.
Keep a Master API key active to receive callbacks. CryptoProcessing does not send or queue callbacks while no Master key is active.
In your portal, go to Settings and switch to the Callbacks tab.
2
Click Set up URL.
3
Specify the URL of your webhook endpoint.
Your webhook URL must use HTTPS, use a domain name, and be considered safe by VirusTotal and similar scanners.
4
Enter your 2FA code and click Set up URL.
For additional security, you can whitelist the CryptoProcessing IP addresses used for callback delivery. Contact Support for the current list of IP addresses.
No. You can only add one callback URL per merchant account. Setting up a new URL replaces the existing one.
Last modified on October 23, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"CryptoProcessing","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/cr-can/JNU-a1yf24zsoHlI/logo/secondary%20logo%20black.svg?fit=max\u0026auto=format\u0026n=JNU-a1yf24zsoHlI\u0026q=85\u0026s=aaf2df80dcbc41f74d023d60472028af","dark":"https://mintcdn.com/cr-can/JNU-a1yf24zsoHlI/logo/secondary%20logo%20white.svg?fit=max\u0026auto=format\u0026n=JNU-a1yf24zsoHlI\u0026q=85\u0026s=2f077577f55cb906b8bc5e7cf8ca9010"},"favicon":"https://mintcdn.com/cr-can/9usOsZeCL5WSJbpa/favicon.png?fit=max\u0026auto=format\u0026n=9usOsZeCL5WSJbpa\u0026q=85\u0026s=c981a5eb98d14c844fbcbe41072bef83","api":{"params":{"expanded":"all"},"playground":{"display":"simple"}},"navbar":{"links":[{"href":"/contact-support","label":"Support"}],"primary":{"type":"button","label":"Portal","href":"https://app.ca.cryptoprocessing.com/"}},"footer":{"socials":{"x":"https://x.com/processing_com","linkedin":"https://www.linkedin.com/company/cryptoprocessing","instagram":"https://www.instagram.com/cryptoprocessing","youtube":"https://www.youtube.com/@CryptoProcessing_by_CoinsPaid"}},"seo":{"metatags":{"google-site-verification":"yu4O7y66I-adhApJGRh2Cf0rw23afXp43M-V_C7o9WE"}},"fonts":{"family":"Funnel Sans"},"errors":{"404":{"redirect":false,"title":"This page has a new home","description":"The page you’re looking for may have moved. Try one of the suggested pages below."}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"variables":{"PRODUCT":"CryptoProcessing","PRODUCT_FULL":"CryptoProcessing by Coinspaid","SUPPORT":"support.ca@cryptoprocessing.com","SALES":"sales.ca@cryptoprocessing.com","ACCOUNT_MANAGER":"accounts.ca@cryptoprocessing.com","HOST":"app.ca.cryptoprocessing.com","HOST_PAYMENTS":"payments.ca.cryptoprocessing.com","KYC":"true","FIAT":"CAD","FIAT_OR":"CAD, USD or EUR","API_FIAT":"USD","CURRENCIES_THAT_SUPPORT_INSTANT_CONFIRMATIONS":"BTC and BCH","CURRENCIES_THAT_SUPPORT_INSTANT_WITHDRAWALS":"Bitcoin, Bitcoin Cash, and Litecoin","REGULATIONS":"local regulations","COUNTRY_OF_REGISTRATION":"CAN"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cr-can","hasAudioNarration":false,"actualSubdomain":"cr-can","customDomains":["docs.ca.cryptoprocessing.com"],"gitSource":{"type":"github","owner":"c-docs","repo":"docs","deployBranch":"main","contentDirectory":"C22","isPrivate":true,"mountPath":"","label":"","_id":"6adb634dc631569183d6ac6c"},"chroma":{"liveDeploymentHistoryId":"6aeb2a1fc8520f7b8ee2569c","collectionId":"434aa791-b4c3-42b1-ac85-aa5cf0308803","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb2a1fc8520f7b8ee2569c"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeda0c4644e5d1cbd4c3705","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Docs","count":67},{"language":"default","tag":"API reference","count":23},{"language":"default","tag":"Payment requests","count":16},{"language":"default","tag":"Withdrawals","count":14},{"language":"default","tag":"Deposits","count":13},{"language":"default","tag":"Merchant account setup","count":13},{"language":"default","tag":"Integration","count":12},{"language":"default","tag":"Exchanges","count":7},{"language":"default","tag":"Reference","count":6},{"language":"default","tag":"Fees, statuses, and other details","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support.ca@cryptoprocessing.com","showHelpButton":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":"rbac-expansion","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":"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":"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":"turbopuffer-dual-write","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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"css/asterisks.css","content":"#content[data-page-href*=\"/confirmations-and-limits\"]>div:has(table)+ul>li::before{--icon-size: 0.9ex;position:absolute;top:0.5ex;text-align:right;vertical-align:bottom;width:calc(var(--asterisks) * var(--icon-size));left:calc(2ex - var(--asterisks) * var(--icon-size));font-size:1.3em;background:url('/images/icons/asterisk.svg') 1ex repeat;border-radius:0;padding:0;margin:0;height:var(--icon-size)}#content[data-page-href*=\"/confirmations-and-limits\"]>div:has(table)+ul>li:nth-child(1)::before{--asterisks: 1}#content[data-page-href*=\"/confirmations-and-limits\"]>div:has(table)+ul>li:nth-child(2)::before{--asterisks: 2}#content[data-page-href*=\"/confirmations-and-limits\"]>div:has(table)+ul>li:nth-child(3)::before{--asterisks: 3}"},{"filePath":"css/ai-disclaimer.css","content":".chat-assistant-disclaimer-text{visibility:hidden;position:relative}.chat-assistant-disclaimer-text::after{content:\"This is an AI assistant, not a live support agent. Answers are generated from our documentation and may contain mistakes — if you have further questions, contact support.\";visibility:visible;position:absolute;top:0;left:0;width:100%}"},{"filePath":"css/navigation.css","content":".sidebar-group-header .sidebar-title{text-transform:uppercase}"},{"filePath":"css/tabs.css","content":"ul[role=\"tablist\"]{flex-wrap:wrap}"},{"filePath":"css/cards.css","content":"div.card div:has(>svg:only-child):not([data-component-part=\"card-icon\"]){display:none}"},{"filePath":"css/main-page.css","content":"#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"]{border:none;column-gap:.5em;flex-wrap:nowrap;overflow-x:auto;-webkit-overflow-scrolling:touch;scroll-snap-type:x proximity}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li{margin:0;padding:0;flex:none;scroll-snap-align:start}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li div{height:2.6em;border-radius:1.3em;padding:0 1em;background:#8888881a;border:1px solid #88888840}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li div svg{background:rgb(var(--primary))}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li div:hover{background:#88888833}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li div[data-active=\"true\"]{background-color:rgb(var(--primary));color:white}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs ul[role=\"tablist\"] li div[data-active=\"true\"] svg{background-color:white}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden){display:flex;flex-direction:row;column-gap:2em}@media (max-width: 50em){#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden){flex-direction:column;row-gap:3em}}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden)>div:nth-child(1){flex:2}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden)>div:nth-child(1) .steps{margin:0}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden)>div:nth-child(1) .steps .step p{margin-bottom:0}#content:is([data-page-href=\"/index\"],[data-page-href=\"/src/_props/index\"]) .tabs div[role=\"tabpanel\"]:not(.hidden)>div:nth-child(2){flex:3}"},{"filePath":"css/currency-icons.css","content":"#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table thead{border-bottom:1px solid color-mix(in srgb, currentColor 14%, transparent)}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table tbody tr{border-bottom:1px solid color-mix(in srgb, currentColor 8%, transparent)}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table :is(th,td){padding:0.5rem 0.5rem 0.5rem 0;vertical-align:baseline}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table th{padding-top:0;text-align:left}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td{min-width:0;line-height:1.5em}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table img{display:inline-block;width:1.3em;height:1.3em;margin:0 0.3em 0 0;border-radius:50%;pointer-events:none;background:color-mix(in srgb, currentColor 10%, transparent)}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td:first-child{font-weight:bold}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td:first-child img{width:1.7em;height:1.7em;margin-right:0.7em}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td:first-child strong{margin-left:0.5em}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td:not(:first-child)>span,#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table td:not(:first-child)>div>span{display:inline-block;white-space:nowrap;margin-right:1em}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table :is(b,strong){padding:.1em .4em;margin:.2em .2em .2em 0;font-weight:normal;border-radius:.3em;white-space:nowrap;display:inline-block;background:#F5F5F4;color:#57534E}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table span+:is(b,strong){margin-left:-0.5em}.dark #content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table :is(b,strong){background:#44403C;color:#A8A29E}#content:is([data-page-href$=\"/supported-currencies\"],[data-page-href$=\"/confirmations-and-limits\"],[data-page-href$=\"/supported-trading-pairs\"]) table strong{margin-block:0.15em;margin-right:-0.05em}#content[data-page-href$=\"/supported-currencies\"] table th:not(:last-child){width:10rem}#content[data-page-href$=\"/confirmations-and-limits\"] table th:first-child{width:16rem}#content[data-page-href$=\"/supported-trading-pairs\"] table th:not(:first-child){width:50%}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(1) b{display:block;width:fit-content;margin-left:2.3em}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(2){line-height:2em}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(2) b{line-height:1.5em;margin-block:0}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(2) div{padding-inline-start:1.6em;text-indent:-1.6em}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(2) div :is(span,b){text-indent:initial}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(3){display:grid;grid-template-columns:repeat(auto-fill, minmax(5em, 1fr));row-gap:0.4em}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(3) span{margin-inline-end:0}@media (max-width: 640px){#content[data-page-href$=\"/supported-trading-pairs\"] table thead{display:none}#content[data-page-href$=\"/supported-trading-pairs\"] table :is(tbody,tr,td){display:block}#content[data-page-href$=\"/supported-trading-pairs\"] table tr{padding-block:0.5rem}#content[data-page-href$=\"/supported-trading-pairs\"] table td{padding-inline:0}#content[data-page-href$=\"/supported-trading-pairs\"] table td:first-child{font-size:1rem;padding-top:1.25rem}#content[data-page-href$=\"/supported-trading-pairs\"] table td:first-child b{display:inline-block;margin-left:0.5em}#content[data-page-href$=\"/supported-trading-pairs\"] table td:not(:first-child)::before{display:block;grid-column:1 / -1;margin-block:0.25rem;font-size:0.75rem;color:color-mix(in srgb, currentColor 55%, transparent);text-transform:uppercase}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(2)::before{content:'Convert to crypto'}#content[data-page-href$=\"/supported-trading-pairs\"] table td:nth-child(3)::before{content:'Convert to fiat'}}"},{"filePath":"css/migrating.css","content":"#content[data-page-href$=\"/payment-requests/migration-guide\"] table{display:table;table-layout:fixed;width:100%}#content[data-page-href$=\"/payment-requests/migration-guide\"] table :is(th,td):nth-child(2){width:2rem;text-align:center}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns{gap:.5rem}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns .code-block{display:grid;grid-template-rows:auto 1fr;margin:0;--code-padding-right: 0}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns .code-block [data-component-part=\"scroll-area-viewport\"]{padding-right:0}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns .code-block code{white-space:pre-wrap;width:auto}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns .code-block:first-child{opacity:.7}#content[data-page-href$=\"/payment-requests/migration-guide\"] .columns .code-block:first-child [data-component-part=\"code-block-header\"] button{visibility:hidden}"},{"filePath":"css/method-pills.css","content":"a[href*=\"/api-reference/callbacks/\"] .method-nav-pill>span{background-color:rgb(250 204 21 / 0.2);color:#a16207}.dark a[href*=\"/api-reference/callbacks/\"] .method-nav-pill>span{background-color:rgb(250 204 21 / 0.2);color:#facc15}a[href*=\"/api-reference/callbacks/\"][aria-current=\"page\"] .method-nav-pill>span,.dark a[href*=\"/api-reference/callbacks/\"][aria-current=\"page\"] .method-nav-pill>span{background-color:#c28c30;color:#ffffff}"}],"page":{"pagePath":"merchant-administration/set-up-callback-url","slug":"/merchant-administration/set-up-callback-url","pageMetadata":{"title":"Set up callback URL","description":null,"href":"/merchant-administration/set-up-callback-url"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function Available({to,except}){const{Badge,Tooltip}=_provideComponents()||{};if(!Badge)_missingMdxReference(`Badge`,true);if(!Tooltip)_missingMdxReference(`Tooltip`,true);const roles=_jsx(Tooltip,{tip:`Roles determine what each user can see and do in the portal.`,cta:`See role descriptions`,href:`/merchant-administration/add-a-user#determine-which-role-to-use`,children:`roles`});if(to){return _jsxs(_Fragment,{children:[_jsxs(`strong`,{children:[`Available to `,roles,`:`]}),` `,to.map(role=>_jsxs(_Fragment,{children:[` `,_jsx(Badge,{color:`blue`,children:role})]}))]})}else{return _jsxs(_Fragment,{children:[_jsxs(`strong`,{children:[`Available to all `,roles,` except`]}),` `,except.map(role=>_jsxs(_Fragment,{children:[` `,_jsx(Badge,{color:`blue`,children:role})]}))]})}}function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Heading,Step,Steps,Tip,Warning,_MdxComponentBoundary}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_MdxComponentBoundary,{name:`Available`,children:_jsx(Available,{to:[`Owner`]})}),`\n`,_jsxs(_components.p,{children:[`As part of the integration process, you need to set up an HTTPS webhook endpoint where CryptoProcessing can send `,_jsx(_components.a,{href:`/api-reference/callbacks/callbacks-overview`,children:`callbacks`}),`. After you create the endpoint, register it in CryptoProcessing.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Keep a Master API key active to receive callbacks. CryptoProcessing does not send or queue callbacks while no Master key is active.`})}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-callback-url`,children:`Set up callback URL`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`In your portal, go to Settings and switch to the Callbacks tab.`}),_jsx(Step,{title:`Click Set up URL.`}),_jsx(Step,{title:`Specify the URL of your webhook endpoint.`,children:_jsx(_components.p,{children:`Your webhook URL must use HTTPS, use a domain name, and be considered safe by VirusTotal and similar scanners.`})}),_jsx(Step,{title:`Enter your 2FA code and click Set up URL.`})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`For additional security, you can whitelist the CryptoProcessing IP addresses used for callback delivery. Contact Support for the current list of IP addresses.`})}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Heading,{level:`3`,id:`can-i-add-more-than-one-callback-url`,children:`Can I add more than one callback URL?`}),`\n`,_jsx(_components.p,{children:`No. You can only add one callback URL per merchant account. Setting up a new URL replaces the existing one.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{Available,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Set up callback URL","description":null,"href":"/merchant-administration/set-up-callback-url"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[128,923,"const Available=()=>null;function _creat"]]},"mdxExtracts":{"tableOfContents":[{"title":"Set up callback URL","slug":"set-up-callback-url","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[{"title":"Can I add more than one callback URL?","slug":"can-i-add-more-than-one-callback-url","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cr-can/2fc5915a2ee56d94/js/currency-pair-lookup.js"],"subdomain":"cr-can","siteName":"CryptoProcessing","title":"Set up callback URL - CryptoProcessing","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T09:41:49.232Z","gitLastModified":"2026-10-23T13:19:13.000Z","originalFileLocation":"merchant-administration/set-up-callback-url.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=\"application-name\" content=\"CryptoProcessing\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_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/cr-can/Ha5yJbWhh_CHQifW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up callback URL - CryptoProcessing\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CryptoProcessing\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cr-can.mintlify.site/_mintlify/api/og/v2?division=API+setup\u0026amp;title=Set+up+callback+URL\u0026amp;theme=d075ef76d4cb9d221b219fc8\u0026amp;signature=e13aae04a6b35a8455e913319ef479f508224eb4c13cc6f907383e6d56c0fce9\">\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=\"Set up callback URL - CryptoProcessing\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cr-can.mintlify.site/_mintlify/api/og/v2?division=API+setup\u0026amp;title=Set+up+callback+URL\u0026amp;theme=d075ef76d4cb9d221b219fc8\u0026amp;signature=e13aae04a6b35a8455e913319ef479f508224eb4c13cc6f907383e6d56c0fce9\">\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/cr-can/Ha5yJbWhh_CHQifW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CryptoProcessing\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"yu4O7y66I-adhApJGRh2Cf0rw23afXp43M-V_C7o9WE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/merchant-administration/set-up-callback-url.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ca.cryptoprocessing.com/#organization\",\"name\":\"CryptoProcessing\",\"url\":\"https://docs.ca.cryptoprocessing.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cr-can/JNU-a1yf24zsoHlI/logo/secondary%20logo%20black.svg?fit=max\u0026auto=format\u0026n=JNU-a1yf24zsoHlI\u0026q=85\u0026s=aaf2df80dcbc41f74d023d60472028af\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ca.cryptoprocessing.com#website\",\"name\":\"CryptoProcessing\",\"url\":\"https://docs.ca.cryptoprocessing.com\",\"publisher\":{\"@id\":\"https://docs.ca.cryptoprocessing.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url#webpage\",\"url\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url\",\"name\":\"Set up callback URL\",\"dateModified\":\"2026-10-23T13:19:13.000Z\",\"isPartOf\":{\"@id\":\"https://docs.ca.cryptoprocessing.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Merchant account setup\",\"item\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/log-in-and-configure-2-fa\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API setup\",\"item\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/api-configuration\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Set up callback URL\",\"item\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url#article\",\"headline\":\"Set up callback URL\",\"name\":\"Set up callback URL\",\"url\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ca.cryptoprocessing.com/merchant-administration/set-up-callback-url#webpage\"},\"dateModified\":\"2026-10-23T13:19:13.000Z\",\"publisher\":{\"@id\":\"https://docs.ca.cryptoprocessing.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ca.cryptoprocessing.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CryptoProcessing\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CryptoProcessing","nav":{"global":null,"tabs":[{"tab":"Docs","icon":"book","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"CryptoProcessing Documentation","sidebarTitle":"Overview","mode":"wide","href":""},{"title":"Initial setup","mode":"wide","href":"/initial-setup"},{"title":"Portal","sidebarTitle":"Navigating the web interface","href":"/portal"},{"title":"Contact support","sidebarTitle":"Contact support","hidden":true,"href":"/contact-support"}]},{"group":"Merchant account setup","icon":"gear","pages":[{"group":"Users \u0026 roles","root":{"title":"User management","href":"/merchant-administration/user-management"},"directory":"accordion","pages":[{"title":"Log in and configure 2FA","href":"/merchant-administration/log-in-and-configure-2-fa"},{"title":"Add a user","href":"/merchant-administration/add-a-user"},{"title":"Remove a user","href":"/merchant-administration/remove-a-user"},{"title":"Change a user role","href":"/merchant-administration/change-a-user-role"}]},{"group":"Security settings","root":{"title":"Merchant security","href":"/merchant-administration/merchant-security"},"directory":"accordion","pages":[{"title":"Configure withdrawal limits","href":"/merchant-administration/configure-withdrawal-limits"},{"title":"Configure balance amount notifications","href":"/merchant-administration/configure-balance-amount-notifications"},{"title":"Configure automatic withdrawals to cold addresses","href":"/merchant-administration/configure-automatic-withdrawals-to-cold-addresses"},{"title":"Disable withdrawals","href":"/merchant-administration/disable-withdrawals"}]},{"group":"API setup","root":{"title":"API configuration","href":"/merchant-administration/api-configuration"},"directory":"accordion","pages":[{"title":"Generate and activate API keys","href":"/merchant-administration/generate-and-activate-api-keys"},{"title":"Manage API keys","description":null,"href":"/merchant-administration/manage-api-keys"},{"title":"Set up callback URL","href":"/merchant-administration/set-up-callback-url"},{"title":"Configure callbacks","description":null,"href":"/merchant-administration/configure-callbacks"},{"title":"Repeat and export callbacks","href":"/merchant-administration/repeat-and-export-callbacks"}]}]},{"group":"Reporting","icon":"file-lines","pages":[{"title":"Balance statements","href":"/reporting/balance-statements"},{"title":"Transactions report","href":"/reporting/transactions-report"}]},{"group":"Deposits","icon":"wallet","pages":[{"title":"Crypto deposits","sidebarTitle":"Overview","href":"/deposits/index"},{"title":"Create a deposit address","href":"/deposits/create-a-deposit-address"},{"title":"How deposits are confirmed","href":"/deposits/how-deposits-are-confirmed"},{"group":"Integration","pages":[{"title":"Crypto deposits integration guide","sidebarTitle":"Integration guide","href":"/deposits/integration-guide"},{"title":"Design a crypto payment form","sidebarTitle":"Design a payment form","href":"/deposits/design-payment-form"},{"title":"Crypto deposits integration test cases","sidebarTitle":"Integration test cases","mode":"wide","href":"/deposits/test-cases"}]},{"title":"Recover lost deposits","href":"/deposits/recovery"},{"group":"Fees, statuses, and other details","pages":[{"title":"Crypto deposit fees","sidebarTitle":"Fees","href":"/deposits/fees"},{"title":"Deposit statuses","sidebarTitle":"Statuses","mode":"wide","href":"/deposits/statuses"},{"title":"Tag field","href":"/deposits/tags"},{"title":"Risk scoring","href":"/deposits/risk-scoring"}]}]},{"group":"Payment requests","icon":"file-invoice-dollar","pages":[{"title":"Payment requests","sidebarTitle":"Overview","href":"/payment-requests/index"},{"title":"Create a payment request","href":"/payment-requests/create-a-payment-request"},{"group":"Configure payment requests","pages":[{"title":"Configure payment currencies","sidebarTitle":"Payment currencies","href":"/payment-requests/currencies"},{"title":"Configure underpayment handling","sidebarTitle":"Underpayment handling","href":"/payment-requests/underpayments"}]},{"group":"Refunds","pages":[{"title":"Payment request refunds","sidebarTitle":"How refunds work","href":"/payment-requests/refunds"},{"title":"Create a manual refund","href":"/payment-requests/create-a-manual-refund"},{"title":"Resend a refund email","href":"/payment-requests/resend-a-refund-email"}]},{"group":"Integration","pages":[{"title":"Payment requests integration guide","sidebarTitle":"Integration guide","href":"/payment-requests/integration-guide"},{"title":"Fixed payment requests","href":"/payment-requests/fixed-payment-requests"},{"title":"Payment request backlinks","sidebarTitle":"Backlinks","href":"/payment-requests/backlinks"},{"title":"Migrating from invoices to payment requests","sidebarTitle":"Migrating from invoices","href":"/payment-requests/migration-guide"},{"title":"Payment requests integration test cases","sidebarTitle":"Integration test cases","mode":"wide","href":"/payment-requests/test-cases"}]},{"group":"Fees, statuses, and other details","pages":[{"title":"Payment request fees","sidebarTitle":"Fees","href":"/payment-requests/fees"},{"title":"Payment request and refund statuses","sidebarTitle":"Statuses","mode":"wide","href":"/payment-requests/statuses"}]}]},{"group":"Withdrawals","icon":"money-from-bracket","pages":[{"title":"Crypto withdrawals","sidebarTitle":"Overview","href":"/withdrawals/index"},{"title":"Create a withdrawal","href":"/withdrawals/create-a-withdrawal"},{"title":"Approve a withdrawal","href":"/withdrawals/approve-a-withdrawal"},{"title":"Contacts for crypto withdrawals","sidebarTitle":"Contacts","href":"/withdrawals/contacts"},{"group":"Integration","pages":[{"title":"Crypto withdrawals integration guide","sidebarTitle":"Integration guide","href":"/withdrawals/integration-guide"},{"title":"Design a crypto withdrawal form","sidebarTitle":"Design a withdrawal form","href":"/withdrawals/design-withdrawal-form"},{"title":"Send crypto instantly","sidebarTitle":"Send instantly","href":"/withdrawals/instant-withdrawals"},{"title":"Crypto withdrawals integration test cases","sidebarTitle":"Integration test cases","mode":"wide","href":"/withdrawals/test-cases"}]},{"group":"Fees and statuses","pages":[{"title":"Crypto withdrawal fees","sidebarTitle":"Fees","href":"/withdrawals/fees"},{"title":"Withdrawal statuses","sidebarTitle":"Statuses","mode":"wide","href":"/withdrawals/statuses"}]}]},{"group":"Mass payouts","icon":"layer-group","pages":[{"title":"Mass payouts","sidebarTitle":"Overview","href":"/mass-payouts/index"},{"title":"Create a mass payout","href":"/mass-payouts/create-a-mass-payout"},{"title":"Mass payouts file format","sidebarTitle":"File format","href":"/mass-payouts/file-format"},{"title":"Retrying failed mass payouts","href":"/mass-payouts/retrying"},{"title":"Mass payout statuses","sidebarTitle":"Statuses","mode":"wide","href":"/mass-payouts/statuses"}]},{"group":"Exchanges","icon":"arrow-right-arrow-left","pages":[{"title":"Exchanges","sidebarTitle":"Overview","href":"/exchanges/index"},{"title":"Create an exchange","href":"/exchanges/create-an-exchange"},{"title":"Exchange fees","sidebarTitle":"Fees","href":"/exchanges/fees"}]},{"group":"Fiat","icon":"building-columns","pages":[{"title":"Add a bank account","href":"/fiat/add-a-bank-account"},{"title":"Withdraw from your fiat balance","href":"/fiat/withdraw-fiat"},{"title":"Top up your fiat balance","href":"/fiat/top-up-fiat"},{"title":"Fiat operation fees","sidebarTitle":"Fees","href":"/fiat/fees"}]},{"group":"Compliance","icon":"shield-halved","pages":[{"title":"User data collection","href":"/user-data-collection"},{"title":"Reference letter","href":"/reference-letter"}]}]},{"tab":"Supported currencies","icon":"bitcoin","pages":[{"title":"Supported currencies","href":"/supported-currencies"}]},{"tab":"API reference","icon":"code","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Set up callback URL - CryptoProcessing","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":[],"chunks":[]}