This endpoint is one part of a Risk integration. You also need to embed the Sardine SDK in your apps, and web integrations need DNS setup. See Risk Integration Overview.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Ingo Payments Developer Hub","description":"Ingo Payments Developer Hub — APIs, SDKs, and integration guides.","colors":{"primary":"#23ad4b","light":"#5dcaa5","dark":"#058237"},"logo":{"light":"https://mintcdn.com/ingopayments/iShoHhbLzbG-YOtN/logo/light.svg?fit=max\u0026auto=format\u0026n=iShoHhbLzbG-YOtN\u0026q=85\u0026s=556c65165f3a5daf3e33eaf145664046","dark":"https://mintcdn.com/ingopayments/iShoHhbLzbG-YOtN/logo/dark.svg?fit=max\u0026auto=format\u0026n=iShoHhbLzbG-YOtN\u0026q=85\u0026s=52323e8aa1687a6fbdd29a6351b84fcf"},"favicon":"https://mintcdn.com/ingopayments/V3R8LABa_ahl2WE8/favicon.svg?fit=max\u0026auto=format\u0026n=V3R8LABa_ahl2WE8\u0026q=85\u0026s=b46af7ead1c5e85e3fe5d6813b1be106","api":{"openapi":["specs/iframe-session-create.yaml","specs/ingo-banking-merchant-ledgering.yaml","specs/ingopay-check-cancel.yaml","specs/ingopay-check-stop.yaml","specs/ingopay-debit-process-ach.yaml","specs/ingopay-debit-process-card.yaml","specs/ingopay-notify-v3.yaml","specs/ingopay-notify-v4.yaml","specs/ingopay-process-ach.yaml","specs/ingopay-process-billpay.yaml","specs/ingopay-process-card.yaml","specs/ingopay-process-check.yaml","specs/ingopay-process-paypal-venmo.yaml","specs/ingopay-process-retail-card-present.yaml","specs/ingopay-risk.yaml","specs/ingopay-search-v11.yaml","specs/ingopay-verify-ach.yaml","specs/ingopay-verify-billpay.yaml","specs/ingopay-verify-card.yaml","specs/ingopay-verify-check.yaml","specs/ingopay-verify-paypal-venmo.yaml","specs/ingopay-verify-retail-card-present.yaml","specs/ingopay-open-banking-account.yaml","specs/crms-check-maker-alert.yaml","specs/crms-check-protect.yaml","specs/crms-duplicate-exchange.yaml","specs/crms-fraud-alert.yaml","specs/crms-sdk-card-add-or-update-tokenized.yaml","specs/crms-sdk-card-add-or-update.yaml","specs/crms-sdk-card-delete.yaml","specs/crms-sdk-card-get-registered-cards.yaml","specs/crms-sdk-card-update-account.yaml","specs/crms-sdk-partners-add-customer-attributes.yaml","specs/crms-sdk-partners-add-session-attributes.yaml","specs/crms-sdk-partners-authenticate-obo.yaml","specs/crms-sdk-partners-authenticate.yaml","specs/crms-sdk-partners-enroll-customer.yaml","specs/crms-sdk-partners-find-customer.yaml","specs/crms-sdk-partners-get-transaction-history.yaml","specs/crms-sdk-paypal-register-customer.yaml"],"asyncapi":["specs/asyncapi-ingopay.yaml","specs/asyncapi-notify-v3.yaml","specs/asyncapi-notify-v4.yaml","specs/asyncapi-iframe.yaml","specs/asyncapi-banking.yaml","specs/asyncapi-crms-sdk.yaml","specs/asyncapi-crms-check-protect.yaml"],"playground":{"display":"simple"}},"appearance":{"default":"dark"},"contextual":{"options":["copy","view","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ingopayments","hasAudioNarration":false,"actualSubdomain":"ingopayments","customDomains":["developers.ingopayments.com"],"gitSource":{"type":"github","owner":"ingopayments","repo":"ingo-developer-center","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ada84e0793a44c014900f96","collectionId":"78d95d12-1fbc-4af9-94cd-d9532bf64744","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ada84e0793a44c014900f96"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1f353201cdb70a522441a","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"Webhooks","count":242},{"language":"default","tag":"Banking Platform","count":81},{"language":"default","tag":"API Reference","count":74},{"language":"default","tag":"Notify — Managed Parties","count":56},{"language":"default","tag":"Notify — Classic","count":42},{"language":"default","tag":"IngoPay API","count":37},{"language":"default","tag":"Embedded Account Capture","count":22},{"language":"default","tag":"Overview","count":20},{"language":"default","tag":"Hub","count":17},{"language":"default","tag":"Business Owners \u0026 Documents","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"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":"editor-v7-file-tree","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":"editor-nav-generations","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":"editor-agent-model-picker","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":[{"filePath":"custom.css","content":"#navbar>div>div:first-child{border-bottom:3px solid #23ad4b!important;border-color:#23ad4b!important}nav a.link.rounded-full{height:40px!important;font-size:13.5px!important;padding-left:16px!important;padding-right:16px!important;transition:background .15s ease,color .15s ease,border-color .15s ease!important}nav a.link.rounded-full:not(.text-gray-600){background-color:#23ad4b!important;color:#fff!important;font-weight:700!important}nav a.link.rounded-full.text-gray-600{border:1px solid transparent!important;background-color:transparent!important}nav a.link.rounded-full.text-gray-600:hover{border-color:#23ad4b!important;color:#23ad4b!important;background-color:transparent!important}.spec-btn,.spec-btn:hover{text-decoration:none!important}.spec-btn{display:inline-block;background:0 0;border:1px solid #23ad4b;color:#23ad4b!important;font-size:12px;font-weight:600;padding:5px 14px;border-radius:20px;transition:background .15s ease,color .15s ease,border-color .15s ease}.spec-btn:hover{background:#23ad4b;color:#fff!important}.dark table th{color:#e2e8f0!important}img[src*=\"/crms/sdk/screens/\"]{border-radius:24px;max-width:280px;background:#fff;border:1px solid rgba(0,0,0,.18);box-shadow:0 6px 16px rgba(0,0,0,.12)}.dark img[src*=\"/crms/sdk/screens/\"]{border:1px solid rgba(255,255,255,.15);box-shadow:0 6px 16px rgba(0,0,0,.4)}.screen-row{display:grid;grid-template-columns:repeat(auto-fit,minmax(420px,1fr));gap:36px;margin:28px 0}.screen-card{display:grid;grid-template-columns:160px 1fr;gap:20px;align-items:start}.screen-card img{max-width:160px!important;width:100%}.screen-card .screen-text h4,.screen-card .screen-text strong:first-child{display:block;font-size:15px;font-weight:700;margin-top:0;margin-bottom:8px;line-height:1.3}.screen-card .screen-text p{margin:0 0 8px;font-size:14px;line-height:1.55}@media (max-width:540px){.screen-card{grid-template-columns:1fr;gap:12px}.screen-card img{max-width:200px!important;margin:0 auto}}.mermaid svg,div[class*=mermaid] svg,pre.mermaid svg{height:auto!important;margin:0 auto;display:block}.diagram-links{margin:8px 0 4px;font-size:.85rem;text-align:right}.diagram-links a{font-weight:500;text-decoration:none;border-bottom:1px solid currentColor}.diagram-accordion{position:relative;padding-left:14px;margin:28px 0;transition:transform .18s ease}.diagram-accordion::before{content:\"\";position:absolute;left:0;top:6px;bottom:6px;width:4px;background:#1a73e8;border-radius:2px;pointer-events:none;transition:background .18s ease,width .18s ease}.diagram-accordion:hover,.sdk-download-cta:hover{transform:translateY(-1px)}.diagram-accordion:hover::before{background:#4a90f0;width:5px}.sdk-download-cta{position:relative;margin:24px 0;padding:6px;border:2px solid #23ad4b;border-radius:14px;background:rgba(35,173,75,.06);box-shadow:0 4px 14px rgba(35,173,75,.18);transition:transform .18s ease,box-shadow .18s ease}.sdk-download-cta:hover{box-shadow:0 6px 20px rgba(35,173,75,.28)}.dark .sdk-download-cta{background:rgba(35,173,75,.12);box-shadow:0 4px 14px rgba(0,0,0,.4)}.report-downloads{display:flex;flex-wrap:wrap;gap:14px;margin:20px 0 4px}.report-downloads a.report-dl-btn{display:inline-flex;align-items:center;gap:9px;background:#23ad4b;color:#fff!important;font-size:14px;font-weight:600;padding:11px 20px;border-radius:10px;text-decoration:none!important;border:1px solid #23ad4b;box-shadow:0 2px 8px rgba(35,173,75,.2);transition:transform .15s ease,box-shadow .15s ease,background .15s ease}.report-downloads a.report-dl-btn::before{content:\"\\2193\";font-size:15px;font-weight:700;line-height:1}.report-downloads a.report-dl-btn:hover{background:#1c8f3d;transform:translateY(-1px);box-shadow:0 5px 16px rgba(35,173,75,.32);text-decoration:none!important}.dark .report-downloads a.report-dl-btn{box-shadow:0 2px 8px rgba(0,0,0,.4)}"}],"page":{"pagePath":"docs/ingopay/risk/risk-session","slug":"/docs/ingopay/risk/risk-session","pageMetadata":{"title":"Risk Session","description":"Initialize a risk evaluation session token for use with the Risk Score endpoint.","openapi":"specs/ingopay-risk.yaml POST /risk/risksession/v2","href":"/docs/ingopay/risk/risk-session"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Initialize a risk evaluation session token for use with the Risk Score endpoint.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsx(Info,{children:_jsxs(_components.p,{children:[`This endpoint is one part of a Risk integration. You also need to embed the Sardine SDK in your apps, and web integrations need DNS setup. See `,_jsx(_components.a,{href:`/docs/ingopay/risk/overview`,children:`Risk Integration Overview`}),`.`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":"Risk Session","description":"Initialize a risk evaluation session token for use with the Risk Score endpoint.","openapi":"specs/ingopay-risk.yaml POST /risk/risksession/v2","href":"/docs/ingopay/risk/risk-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ingopayments/6302b08f7c932246/scripts/convert.js","/_mintlify/custom/ingopayments/803ba8a0d7080d96/scripts/generate-from-code.js","/_mintlify/custom/ingopayments/20b0b95f387de69d/scripts/validate.js","/_mintlify/custom/ingopayments/e31e657fa2223781/scripts/export-diagrams.js"],"openApiReferenceData":{"operation":{"summary":"Initialize a risk session","description":"Initialize a risk evaluation session token for use with the Risk Score endpoint.","operationId":"riskSession","tags":["Risk"],"requestBody":"8329bf99-d601-498f-b2d0-40fe56b81345","responses":{"200":"9aeb06e4-2c77-43e5-b20e-8b903c1bf268","400":"0dd365f7-d99b-48d9-82c2-09fb42bcc016"},"method":"post","type":"path","servers":["c1f05497-00df-4f38-8619-d18783d07787","66ffb805-616a-4426-a4be-15f431eb301f"],"security":["ff5c20b2-f56c-4b33-b5e0-497d0daf44c3"],"path":"/risk/risksession/v2","baseUrlOptions":["https://payapi-sandbox.ingo.money","https://payapi.ingo.money"],"title":"Initialize a risk session","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["request"],"properties":{"request":{"type":"object","required":["participant_id","timestamp"],"description":"General information associated with the API request.","properties":{"participant_id":{"type":"string","maxLength":5,"description":"Unique participant identifier assigned by Ingo.","example":"12345","isRequired":true,"uniqueKey":"request.participant_id","typeLabel":"string"},"timestamp":{"type":"string","maxLength":32,"description":"Unix timestamp of the request.","example":"1721337425","isRequired":true,"uniqueKey":"request.timestamp","typeLabel":"string"}},"isRequired":true,"uniqueKey":"request","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"request":{"participant_id":"12345","timestamp":"1721337425"}},"examples":{"Example":{"title":"Example","value":{"request":{"participant_id":"12345","timestamp":"1721337425"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9aeb06e4-2c77-43e5-b20e-8b903c1bf268":{"description":"Risk session initialized successfully","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"participant_id":{"type":"string","example":"12345","uniqueKey":"request.participant_id","typeLabel":"string"},"timestamp":{"type":"string","example":"1721413825","uniqueKey":"request.timestamp","typeLabel":"string"}},"uniqueKey":"request","typeLabel":"object"},"response":{"type":"object","properties":{"status":{"type":"string","description":"Numeric code describing the status of the API request. 100 = Success.\n","example":"100","uniqueKey":"response.status","typeLabel":"string"},"message":{"type":"string","description":"Text description associated with the status code.","example":"Success","uniqueKey":"response.message","typeLabel":"string"},"duration":{"type":"string","description":"Time in seconds to complete the request.","example":"0.30398297309875","uniqueKey":"response.duration","typeLabel":"string"}},"uniqueKey":"response","typeLabel":"object"},"session":{"type":"object","description":"Identifiers to be embedded in client-side web/mobile code in support of device fingerprinting and behavioral data collection.\n","properties":{"risk_session_token":{"type":"string","description":"Ingo-assigned session ID (UUID). Pass this value to the Sardine device fingerprinting SDK and subsequently to the `transaction.risk_session_token` field of the RiskScore request. Default session expiry is 30 minutes.\n","example":"1e97dde1-f10f-4caf-8726-da6fc207ecb8","uniqueKey":"session.risk_session_token","typeLabel":"string"}},"uniqueKey":"session","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"request":{"participant_id":"12345","timestamp":"1721413825"},"response":{"status":"100","message":"Success","duration":"0.30398297309875"},"session":{"risk_session_token":"1e97dde1-f10f-4caf-8726-da6fc207ecb8"}},"examples":{"Example":{"title":"Example","value":{"request":{"participant_id":"12345","timestamp":"1721413825"},"response":{"status":"100","message":"Success","duration":"0.30398297309875"},"session":{"risk_session_token":"1e97dde1-f10f-4caf-8726-da6fc207ecb8"}}}},"exampleType":"examples"}},"exampleType":"examples"},"0dd365f7-d99b-48d9-82c2-09fb42bcc016":{"description":"Validation error or unrecognized participant","content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"object","properties":{"participant_id":{"type":"string","example":"12345","uniqueKey":"request.participant_id","typeLabel":"string"},"timestamp":{"type":"string","example":"1721337427","uniqueKey":"request.timestamp","typeLabel":"string"}},"uniqueKey":"request","typeLabel":"object"},"response":{"type":"object","properties":{"status":{"type":"string","example":"400","uniqueKey":"response.status","typeLabel":"string"},"message":{"type":"string","example":"Validation Error","uniqueKey":"response.message","typeLabel":"string"}},"uniqueKey":"response","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"request":{"participant_id":"12345","timestamp":"1721413825"},"response":{"status":"800","message":"Unknown Client"}},"examples":{"Example":{"title":"Example","value":{"request":{"participant_id":"12345","timestamp":"1721413825"},"response":{"status":"800","message":"Unknown Client"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"ff5c20b2-f56c-4b33-b5e0-497d0daf44c3":{"HmacAuth":{"type":"http","scheme":"hmac-sha512","description":"HMAC-SHA512 signed Authorization header. See the Authentication page for the complete signing guide.","scopes":[]}}},"servers":{"c1f05497-00df-4f38-8619-d18783d07787":{"url":"https://payapi-sandbox.ingo.money","description":"Sandbox"},"66ffb805-616a-4426-a4be-15f431eb301f":{"url":"https://payapi.ingo.money","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"hmac-sha512","description":"HMAC-SHA512 signed Authorization header. See the Authentication page for the complete signing guide.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"HMAC-SHA512 signed Authorization header. See the Authentication page for the complete signing guide.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HmacAuth","name":"Authorization"}],"title":"HmacAuth"}]},"originalFileLocation":"specs/ingopay-risk.yaml"},"subdomain":"ingopayments","siteName":"Ingo Payments Developer Hub","title":"Risk Session - Ingo Payments Developer Hub","contextualStarterQuestions":[{"_id":"6ac5741410bba46c35b346e2","deploymentId":"69de7f66155c3ba96bc71012","questionText":"What is the Risk Score endpoint?","status":"active","generatedBy":"contextual","path":"docs/ingopay/risk/risk-session","createdAt":"2026-10-06T22:20:04.016Z","updatedAt":"2026-10-06T22:20:04.016Z","__v":0},{"_id":"6ac5741410bba46c35b346e3","deploymentId":"69de7f66155c3ba96bc71012","questionText":"Do I need to embed the SDK?","status":"active","generatedBy":"contextual","path":"docs/ingopay/risk/risk-session","createdAt":"2026-10-06T22:20:04.016Z","updatedAt":"2026-10-06T22:20:04.016Z","__v":0},{"_id":"6ac5741410bba46c35b346e1","deploymentId":"69de7f66155c3ba96bc71012","questionText":"How do I initialize a risk session?","status":"active","generatedBy":"contextual","path":"docs/ingopay/risk/risk-session","createdAt":"2026-10-06T22:20:04.016Z","updatedAt":"2026-10-06T22:20:04.016Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-06T22:19:56.206Z","originalFileLocation":"docs/ingopay/risk/risk-session.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=\"dark\"}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=\"Initialize a risk evaluation session token for use with the Risk Score endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ingo Payments Developer Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_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/ingopayments/iHiCiEx6lpf9Tbeq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Risk Session - Ingo Payments Developer Hub\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initialize a risk evaluation session token for use with the Risk Score endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ingo Payments Developer Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ingopayments.mintlify.app/_mintlify/api/og/v2?division=Risk+%26+Compliance\u0026amp;title=Risk+Session\u0026amp;description=Initialize+a+risk+evaluation+session+token+for+use+with+the+Risk+Score+endpoint.\u0026amp;theme=ffb6732ea583e2d7404edaa7\u0026amp;signature=7db8ed5fce8b9ac0a231089b466f8c3d0126f05431e1af64dc3bec6f09e7692d\">\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=\"Risk Session - Ingo Payments Developer Hub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initialize a risk evaluation session token for use with the Risk Score endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ingopayments.mintlify.app/_mintlify/api/og/v2?division=Risk+%26+Compliance\u0026amp;title=Risk+Session\u0026amp;description=Initialize+a+risk+evaluation+session+token+for+use+with+the+Risk+Score+endpoint.\u0026amp;theme=ffb6732ea583e2d7404edaa7\u0026amp;signature=7db8ed5fce8b9ac0a231089b466f8c3d0126f05431e1af64dc3bec6f09e7692d\">\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/ingopayments/iHiCiEx6lpf9Tbeq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ingo Payments Developer Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#23ad4b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/ingopay/risk/risk-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.ingopayments.com/#organization\",\"name\":\"Ingo Payments Developer Hub\",\"url\":\"https://developers.ingopayments.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ingopayments/iShoHhbLzbG-YOtN/logo/light.svg?fit=max\u0026auto=format\u0026n=iShoHhbLzbG-YOtN\u0026q=85\u0026s=556c65165f3a5daf3e33eaf145664046\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.ingopayments.com#website\",\"name\":\"Ingo Payments Developer Hub\",\"url\":\"https://developers.ingopayments.com\",\"publisher\":{\"@id\":\"https://developers.ingopayments.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session#webpage\",\"url\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session\",\"name\":\"Risk Session\",\"description\":\"Initialize a risk evaluation session token for use with the Risk Score endpoint.\",\"dateModified\":\"2026-10-06T22:19:56.206Z\",\"isPartOf\":{\"@id\":\"https://developers.ingopayments.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://developers.ingopayments.com/docs/ingopay/verify/card\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Risk \u0026 Compliance\",\"item\":\"https://developers.ingopayments.com/docs/ingopay/risk/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Risk Session\",\"item\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session#apireference\",\"headline\":\"Risk Session\",\"name\":\"Risk Session\",\"description\":\"Initialize a risk evaluation session token for use with the Risk Score endpoint.\",\"url\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session\",\"mainEntityOfPage\":{\"@id\":\"https://developers.ingopayments.com/docs/ingopay/risk/risk-session#webpage\"},\"dateModified\":\"2026-10-06T22:19:56.206Z\",\"publisher\":{\"@id\":\"https://developers.ingopayments.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.ingopayments.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ingo Payments Developer Hub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ingo Payments Developer Hub","nav":{"global":{},"tabs":[{"tab":"Hub","pages":[{"title":"Hub","href":"/docs/hub/overview"}]},{"tab":"IngoPay API","groups":[{"group":"Overview","pages":[{"title":"IngoPay API","mode":"wide","href":"/docs/ingopay/overview"},{"title":"Quick Start","href":"/docs/ingopay/quick-start"},{"title":"Payment Methods","href":"/docs/ingopay/payment-methods"},{"title":"Testing","href":"/docs/ingopay/testing"}]},{"group":"API Reference","pages":[{"group":"Account Tokenization","expanded":false,"pages":[{"title":"Verify — Card","sidebarTitle":"Debit \u0026 Prepaid Card","openapi":"specs/ingopay-verify-card.yaml POST /gateway/verify--card","href":"/docs/ingopay/verify/card"},{"title":"Verify — ACH","sidebarTitle":"Bank Account · All Speeds","openapi":"specs/ingopay-verify-ach.yaml POST /gateway/verify--ach","href":"/docs/ingopay/verify/ach"},{"title":"Verify — BillPay","sidebarTitle":"BillPay","openapi":"specs/ingopay-verify-billpay.yaml POST /gateway/verify--billpay","href":"/docs/ingopay/verify/billpay"},{"title":"Verify — Check by Mail","sidebarTitle":"Check by Mail","openapi":"specs/ingopay-verify-check.yaml POST /gateway/verify--check","href":"/docs/ingopay/verify/check"},{"title":"Verify — PayPal / Venmo","sidebarTitle":"PayPal \u0026 Venmo","openapi":"specs/ingopay-verify-paypal-venmo.yaml POST /gateway/verify--paypal-venmo","href":"/docs/ingopay/verify/paypal-venmo"},{"title":"Verify — Retail Card Present","sidebarTitle":"Card · In-Person","openapi":"specs/ingopay-verify-retail-card-present.yaml POST /gateway/verify--retail","href":"/docs/ingopay/verify/retail-card-present"}]},{"group":"Push Payments","expanded":false,"pages":[{"title":"Process — Card","sidebarTitle":"To Card","openapi":"specs/ingopay-process-card.yaml POST /gateway/process--card","href":"/docs/ingopay/process/card"},{"title":"Process — ACH","sidebarTitle":"To Bank Account · All Speeds","openapi":"specs/ingopay-process-ach.yaml POST /gateway/process--ach","href":"/docs/ingopay/process/ach"},{"title":"Process — BillPay","sidebarTitle":"Bill Payment","openapi":"specs/ingopay-process-billpay.yaml POST /gateway/process--billpay","href":"/docs/ingopay/process/billpay"},{"title":"Process — Check by Mail","sidebarTitle":"Check by Mail","openapi":"specs/ingopay-process-check.yaml POST /gateway/process--check","href":"/docs/ingopay/process/check"},{"title":"Process — PayPal / Venmo","sidebarTitle":"To PayPal \u0026 Venmo","openapi":"specs/ingopay-process-paypal-venmo.yaml POST /gateway/process--paypal-venmo","href":"/docs/ingopay/process/paypal-venmo"},{"title":"Process — Retail Card Present","sidebarTitle":"Card — In-Person","openapi":"specs/ingopay-process-retail-card-present.yaml POST /gateway/process--retail","href":"/docs/ingopay/process/retail-card-present"}]},{"group":"Pull Payments","expanded":false,"pages":[{"title":"Debit Process — Card","sidebarTitle":"From Card","openapi":"specs/ingopay-debit-process-card.yaml POST /gateway/v12/debit/process--card","href":"/docs/ingopay/debit/process-card"},{"title":"Debit Process — ACH","sidebarTitle":"From Bank Account","openapi":"specs/ingopay-debit-process-ach.yaml POST /gateway/v12/debit/process--ach","href":"/docs/ingopay/debit/process-ach"}]},{"group":"Risk \u0026 Compliance","expanded":false,"pages":[{"title":"Risk Integration Overview","description":"What a Risk integration involves beyond the Risk API: the Sardine SDK on your web and mobile apps, and DNS setup for web.","href":"/docs/ingopay/risk/overview"},{"title":"Risk Session","openapi":"specs/ingopay-risk.yaml POST /risk/risksession/v2","href":"/docs/ingopay/risk/risk-session"},{"title":"Risk Score","description":"Evaluate the risk of a transaction and obtain a risk assessment token for use in subsequent process calls.","openapi":"specs/ingopay-risk.yaml POST /risk/riskscore/v2","href":"/docs/ingopay/risk/risk-score"}]},{"group":"Ancillary Services","expanded":false,"pages":[{"title":"Search","sidebarTitle":"Biller Search","openapi":"specs/ingopay-search-v11.yaml POST /gateway/search","href":"/docs/ingopay/ancillary/search"},{"title":"Check Stop","sidebarTitle":"Stop a Check","openapi":"specs/ingopay-check-stop.yaml POST /gateway/checkstop","href":"/docs/ingopay/ancillary/check-stop"},{"title":"Check Cancel","sidebarTitle":"Cancel a Check","openapi":"specs/ingopay-check-cancel.yaml POST /gateway/checkcancel","href":"/docs/ingopay/ancillary/check-cancel"},{"title":"Retrieve Account Data via Open Banking","sidebarTitle":"Open Banking Account Data","openapi":"specs/ingopay-open-banking-account.yaml POST /gateway/v1/open-banking-account","href":"/docs/ingopay/ancillary/open-banking-account"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Overview","href":"/docs/ingopay/webhooks/overview"},{"group":"Webhooks","pages":[{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentNoticeSettlementAdjustment","href":"/ingopay-webhooks/webhooks/settlement-adjustment","title":"Settlement Adjustment","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentNoticeAchNocV1","href":"/ingopay-webhooks/webhooks/ach-notice-of-change","title":"ACH Notice of Change","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentStatusCheckIssued","href":"/ingopay-webhooks/webhooks/check-issued","title":"Check Issued","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentStatusCheckPaid","href":"/ingopay-webhooks/webhooks/check-paid","title":"Check Paid","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentStatusCheckCanceled","href":"/ingopay-webhooks/webhooks/check-canceled","title":"Check Canceled","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentStatusCheckStopped","href":"/ingopay-webhooks/webhooks/check-stopped","title":"Check Stopped","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientStatusPaymentCheckReturned","href":"/ingopay-webhooks/webhooks/check-returned","title":"Check Returned","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientPaymentStatusReturned","href":"/ingopay-webhooks/webhooks/payment-returned","title":"Payment Returned","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientVerificationOfacStatusSuspended","href":"/ingopay-webhooks/webhooks/ofac-suspended","title":"OFAC Suspended","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientVerificationOfacStatusCleared","href":"/ingopay-webhooks/webhooks/ofac-cleared","title":"OFAC Cleared","version":null},{"asyncapi":"specs/asyncapi-ingopay.yaml GatewayTransactionRecipientVerificationOfacStatusFailure","href":"/ingopay-webhooks/webhooks/ofac-failure","title":"OFAC Failure","version":null}]}]}]},{"tab":"Embedded Account Capture","pages":[{"title":"Embedded Account Capture","href":"/docs/iframe/overview"}]},{"tab":"Notify — Classic","pages":[{"title":"Notify — Classic","href":"/docs/notify-classic/overview"}]},{"tab":"Notify — Managed Parties","pages":[{"title":"Notify — Managed Parties","href":"/docs/notify-managed/overview"}]},{"tab":"Banking Platform","pages":[{"title":"Banking Platform","href":"/docs/banking/overview"}]},{"tab":"Check Risk Management Services","hidden":true,"pages":[{"title":"Check Risk Management Services","href":"/docs/crms/overview"}]}]},"title":"Risk Session - Ingo Payments Developer Hub","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CBCH2P7b.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}