{ "status": "failed", "status_code": 404, "message": "Request failed.", "data": { "error": "Customer not found or does not belong to you." }}
Mint a short-lived session bound to one customer you own. Use data.url to open the hosted KYC or KYB page. Use data.token as X-Kyc-Session when your own UI calls the KYC platform.A URL that is only https://kyc.yativo.com/{customer_type}/{customer_id} is rejected with 401. Always mint a session at the moment you send the customer to verification.
POST /customer/kyc-session
Call this from your server with your API key. Never put X-Api-Key / X-Api-Secret in a browser or app. Production keys still need an IP whitelist; the customer’s browser does not.
{ "status": "failed", "status_code": 404, "message": "Request failed.", "data": { "error": "Customer not found or does not belong to you." }}
Field
Description
token
Signed session JWT. Send it as X-Kyc-Session (or ?session=) on KYC platform APIs. Bound to this customer and type. KYC-only — it cannot call the Yativo API
expires_at
ISO 8601 expiry. Default lifetime is 30 minutes (1800 seconds). Submitting KYC or closing the hosted tab revokes it immediately
expires_in
Lifetime in seconds
url
Hosted KYC/KYB page with the session already on the query string. Redirect or iframe this. Don’t build the URL yourself
portal_url
Alternate portal link when one is configured for your account; otherwise null
Each call mints a new token. An older unused token stays valid until it expires, is used to submit KYC, or the customer closes the hosted verification tab. Mint again every time you email, redirect, or show a “Continue verification” button.See KYC / KYB verification for hosted vs API flows, and Bans, blocks and access errors for 401/404 causes.
Authorizations
X-Api-Key
string
header
required
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
X-Api-Secret
string
header
required
Your API secret (yativo_sk_...), shown once when the key is created.
Body
application/json
customer_id
string<uuid>
required
A customer you created with POST /customer. Must belong to the calling account.
Example:
"11111111-2222-4333-8444-555555555555"
customer_type
enum<string>
required
Must match the customer's type.
Available options:
individual,
business
Example:
"individual"
Response
Session minted
status
string
Example:
"success"
status_code
integer
Example:
200
message
string
Example:
"Request successful"
data
object
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Yativo","description":"Yativo developer docs: APIs and guides for cross-border fiat payments, payouts and virtual accounts.","colors":{"primary":"#813AE3","light":"#A855F7","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/yativo/_4AojVs77vZSnaI6/logo/yativo-light.png?fit=max\u0026auto=format\u0026n=_4AojVs77vZSnaI6\u0026q=85\u0026s=925bc977f579b795be5138bca21d9aca","dark":"https://mintcdn.com/yativo/_4AojVs77vZSnaI6/logo/yativo-dark.png?fit=max\u0026auto=format\u0026n=_4AojVs77vZSnaI6\u0026q=85\u0026s=4a7277d59a65fc0b185ee3ef73f89555"},"favicon":"https://mintcdn.com/yativo/_4AojVs77vZSnaI6/favicon.svg?fit=max\u0026auto=format\u0026n=_4AojVs77vZSnaI6\u0026q=85\u0026s=853b46d93c6f173e4fa3bdf617b4065a","api":{"playground":{}},"navbar":{"links":[{"href":"https://yativo.com","label":"Yativo Website"},{"href":"https://yativo.com/support","label":"Support"}],"primary":{"type":"button","label":"Get Started — Fiat","href":"https://app.yativo.com"}},"footer":{"socials":{"x":"https://x.com/yativo","linkedin":"https://linkedin.com/company/yativo","website":"https://yativo.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Fiat Dashboard","icon":"building-columns","href":"https://app.yativo.com"},{"anchor":"Status","icon":"signal","href":"https://status.yativo.com"},{"anchor":"Support","icon":"headset","href":"https://yativo.com/support"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"yativo","hasAudioNarration":false,"actualSubdomain":"yativo","customDomains":["docs.yativo.com"],"gitSource":{"type":"github","owner":"sotonye-m","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afb823943273ad577d8b27a","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Fiat API References","count":161},{"language":"default","tag":"Yativo Fiat","count":73},{"language":"default","tag":"Platform guides","count":32},{"language":"default","tag":"Card Checkout","count":20},{"language":"default","tag":"Corporate Cards","count":20},{"language":"default","tag":"KYC Lookups","count":13},{"language":"default","tag":"Business","count":13},{"language":"default","tag":"Corporate Card Links","count":11},{"language":"default","tag":"KYC / KYB","count":11},{"language":"default","tag":"Shared","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"custom-rbac-roles","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":"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":"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":"editor-metadata","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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"fiat-api-reference/customers/kyc-session","slug":"/fiat-api-reference/customers/kyc-session","pageMetadata":{"title":"Mint KYC session","description":"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs","openapi":"openapi-fiat.yaml POST /customer/kyc-session","href":"/fiat-api-reference/customers/kyc-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: \"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Mint a short-lived session bound to one customer you own. Use `,_jsx(_components.code,{children:`data.url`}),` to open the hosted KYC or KYB page. Use `,_jsx(_components.code,{children:`data.token`}),` as `,_jsx(_components.code,{children:`X-Kyc-Session`}),` when your own UI calls the KYC platform.`]}),`\n`,_jsxs(_components.p,{children:[`A URL that is only `,_jsx(_components.code,{children:`https://kyc.yativo.com/{customer_type}/{customer_id}`}),` is rejected with `,_jsx(_components.code,{children:`401`}),`. Always mint a session at the moment you send the customer to verification.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /customer/kyc-session`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Call this from your `,_jsx(_components.strong,{children:`server`}),` with your API key. Never put `,_jsx(_components.code,{children:`X-Api-Key`}),` / `,_jsx(_components.code,{children:`X-Api-Secret`}),` in a browser or app. Production keys still need an `,_jsx(_components.a,{href:`/yativo-fiat/ip-allowlist`,children:`IP whitelist`}),`; the customer’s browser does not.`]})}),`\n`,`\n`,`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`token`})}),_jsxs(_components.td,{children:[`Signed session JWT. Send it as `,_jsx(_components.code,{children:`X-Kyc-Session`}),` (or `,_jsx(_components.code,{children:`?session=`}),`) on KYC platform APIs. Bound to this customer and type. KYC-only — it cannot call the Yativo API`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_at`})}),_jsxs(_components.td,{children:[`ISO 8601 expiry. Default lifetime is `,_jsx(_components.strong,{children:`30 minutes`}),` (`,_jsx(_components.code,{children:`1800`}),` seconds). Submitting KYC or closing the hosted tab revokes it immediately`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_in`})}),_jsx(_components.td,{children:`Lifetime in seconds`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsx(_components.td,{children:`Hosted KYC/KYB page with the session already on the query string. Redirect or iframe this. Don’t build the URL yourself`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`portal_url`})}),_jsxs(_components.td,{children:[`Alternate portal link when one is configured for your account; otherwise `,_jsx(_components.code,{children:`null`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Each call mints a `,_jsx(_components.strong,{children:`new`}),` token. An older unused token stays valid until it expires, is used to submit KYC, or the customer closes the hosted verification tab. Mint again every time you email, redirect, or show a “Continue verification” button.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/yativo-fiat/kyc#mint-a-session`,children:`KYC / KYB verification`}),` for hosted vs API flows, and `,_jsx(_components.a,{href:`/yativo-fiat/restrictions#kyc-sessions-and-hosted-pages`,children:`Bans, blocks and access errors`}),` for `,_jsx(_components.code,{children:`401`}),`/`,_jsx(_components.code,{children:`404`}),` causes.`]})]})}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":"Mint KYC session","description":"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs","openapi":"openapi-fiat.yaml POST /customer/kyc-session","href":"/fiat-api-reference/customers/kyc-session"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Note,RequestExample,ResponseExample,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Note)_missingMdxReference(`Note`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Mint a short-lived session bound to one customer you own. Use `,_jsx(_components.code,{children:`data.url`}),` to open the hosted KYC or KYB page. Use `,_jsx(_components.code,{children:`data.token`}),` as `,_jsx(_components.code,{children:`X-Kyc-Session`}),` when your own UI calls the KYC platform.`]}),`\n`,_jsxs(_components.p,{children:[`A URL that is only `,_jsx(_components.code,{children:`https://kyc.yativo.com/{customer_type}/{customer_id}`}),` is rejected with `,_jsx(_components.code,{children:`401`}),`. Always mint a session at the moment you send the customer to verification.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST /customer/kyc-session`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Call this from your `,_jsx(_components.strong,{children:`server`}),` with your API key. Never put `,_jsx(_components.code,{children:`X-Api-Key`}),` / `,_jsx(_components.code,{children:`X-Api-Secret`}),` in a browser or app. Production keys still need an `,_jsx(_components.a,{href:`/yativo-fiat/ip-allowlist`,children:`IP whitelist`}),`; the customer’s browser does not.`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.yativo.com/api/v1/customer/kyc-session'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-Api-Key: YOUR_API_KEY'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-Api-Secret: YOUR_API_SECRET'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Accept: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customer_id\": \"11111111-2222-4333-8444-555555555555\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"customer_type\": \"individual\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`Success`,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Request successful\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"YOUR_KYC_SESSION_TOKEN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expires_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-16T23:33:00+00:00\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expires_in\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1800`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://kyc.yativo.com/individual/11111111-2222-4333-8444-555555555555?session=YOUR_KYC_SESSION_TOKEN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"portal_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Customer not found`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status_code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`404`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Request failed.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Customer not found or does not belong to you.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`token`})}),_jsxs(_components.td,{children:[`Signed session JWT. Send it as `,_jsx(_components.code,{children:`X-Kyc-Session`}),` (or `,_jsx(_components.code,{children:`?session=`}),`) on KYC platform APIs. Bound to this customer and type. KYC-only — it cannot call the Yativo API`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_at`})}),_jsxs(_components.td,{children:[`ISO 8601 expiry. Default lifetime is `,_jsx(_components.strong,{children:`30 minutes`}),` (`,_jsx(_components.code,{children:`1800`}),` seconds). Submitting KYC or closing the hosted tab revokes it immediately`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`expires_in`})}),_jsx(_components.td,{children:`Lifetime in seconds`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`url`})}),_jsx(_components.td,{children:`Hosted KYC/KYB page with the session already on the query string. Redirect or iframe this. Don’t build the URL yourself`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`portal_url`})}),_jsxs(_components.td,{children:[`Alternate portal link when one is configured for your account; otherwise `,_jsx(_components.code,{children:`null`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Each call mints a `,_jsx(_components.strong,{children:`new`}),` token. An older unused token stays valid until it expires, is used to submit KYC, or the customer closes the hosted verification tab. Mint again every time you email, redirect, or show a “Continue verification” button.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/yativo-fiat/kyc#mint-a-session`,children:`KYC / KYB verification`}),` for hosted vs API flows, and `,_jsx(_components.a,{href:`/yativo-fiat/restrictions#kyc-sessions-and-hosted-pages`,children:`Bans, blocks and access errors`}),` for `,_jsx(_components.code,{children:`401`}),`/`,_jsx(_components.code,{children:`404`}),` causes.`]})]})}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":"Mint KYC session","description":"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs","openapi":"openapi-fiat.yaml POST /customer/kyc-session","href":"/fiat-api-reference/customers/kyc-session"}}}},"mdxExtracts":{"tableOfContents":[],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'https://api.yativo.com/api/v1/customer/kyc-session'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'X-Api-Key: YOUR_API_KEY'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'X-Api-Secret: YOUR_API_SECRET'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Accept: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type: application/json'\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"customer_id\": \"11111111-2222-4333-8444-555555555555\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"customer_type\": \"individual\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"Success","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status_code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">200\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Request successful\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"token\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"YOUR_KYC_SESSION_TOKEN\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expires_at\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-11-16T23:33:00+00:00\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expires_in\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1800\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://kyc.yativo.com/individual/11111111-2222-4333-8444-555555555555?session=YOUR_KYC_SESSION_TOKEN\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"portal_url\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Customer not found","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"failed\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status_code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">404\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Request failed.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Customer not found or does not belong to you.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Customers"],"summary":"Mint KYC session","description":"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs","requestBody":"3512be74-240d-4a81-90a2-c47012b3f125","responses":{"200":"372c3cbf-5500-494a-aef9-be4230e23e38","404":"767045bc-cb65-4789-8f94-036978645a6b","422":"750db666-df57-4582-ac3c-c835fa6b82ed"},"method":"post","type":"path","servers":["20278df4-5766-4964-ad00-f8701cb54ff1","a7a60aa5-12ee-4ed9-af12-44a68e8a6ca6"],"security":["5ae5ef56-3009-429f-83ca-119a707a48fe"],"path":"/customer/kyc-session","baseUrlOptions":["https://api.yativo.com/api/v1","https://smtp.yativo.com/api/v1"],"title":"Mint KYC session","codeSamples":[],"requiredOnlyExamples":false,"requestExamples":[{"dropdown":false,"language":"shellscript","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"shellscript","children":{"type":"code","key":null,"ref":null,"props":{"language":"shellscript","numberOfLines":"9","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#953800","--shiki-dark":"#DCDCAA"},"children":"curl"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -X"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" POST"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'https://api.yativo.com/api/v1/customer/kyc-session'"}},{"type":"span","key":"4","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'X-Api-Key: YOUR_API_KEY'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'X-Api-Secret: YOUR_API_SECRET'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'Accept: application/json'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -H"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" 'Content-Type: application/json'"}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#CF222E","--shiki-dark":"#D7BA7D"},"children":" \\"}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":" -d"}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" '{"}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"customer_id\": \"11111111-2222-4333-8444-555555555555\","}}}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" \"customer_type\": \"individual\""}}}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":" }'"}}}},"\n"]}}}},"filename":"cURL"}],"requestExampleType":"mdx","responseExamples":[{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"12","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"success\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status_code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"200"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Request successful\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"data\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"token\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"YOUR_KYC_SESSION_TOKEN\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"expires_at\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"2026-11-16T23:33:00+00:00\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"expires_in\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"1800"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"16","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"url\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"https://kyc.yativo.com/individual/11111111-2222-4333-8444-555555555555?session=YOUR_KYC_SESSION_TOKEN\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"18","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"portal_url\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#569CD6"},"children":"null"}}]}},"\n",{"type":"span","key":"20","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"22","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Success"},{"dropdown":false,"language":"json","code":{"type":"pre","key":null,"ref":null,"props":{"className":"shiki shiki-themes github-light-default dark-plus","style":{"backgroundColor":"#ffffff","--shiki-dark-bg":"#0B0C0E","color":"#1f2328","--shiki-dark":"#D4D4D4"},"language":"json","children":{"type":"code","key":null,"ref":null,"props":{"language":"json","numberOfLines":"8","children":[{"type":"span","key":"0","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"{"}}}},"\n",{"type":"span","key":"2","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"failed\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"4","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"status_code\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0550AE","--shiki-dark":"#B5CEA8"},"children":"404"}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"6","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"message\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Request failed.\""}},{"type":"span","key":"3","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":","}}]}},"\n",{"type":"span","key":"8","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"data\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": {"}}]}},"\n",{"type":"span","key":"10","ref":null,"props":{"className":"line","children":[{"type":"span","key":"0","ref":null,"props":{"style":{"color":"#116329","--shiki-dark":"#9CDCFE"},"children":" \"error\""}},{"type":"span","key":"1","ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":": "}},{"type":"span","key":"2","ref":null,"props":{"style":{"color":"#0A3069","--shiki-dark":"#CE9178"},"children":"\"Customer not found or does not belong to you.\""}}]}},"\n",{"type":"span","key":"12","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":" }"}}}},"\n",{"type":"span","key":"14","ref":null,"props":{"className":"line","children":{"type":"span","key":null,"ref":null,"props":{"style":{"color":"#1F2328","--shiki-dark":"#D4D4D4"},"children":"}"}}}},"\n"]}}}},"filename":"Customer not found"}],"responseExampleType":"mdx"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["customer_id","customer_type"],"properties":{"customer_id":{"type":"string","format":"uuid","description":"A customer you created with `POST /customer`. Must belong to the calling account.","example":"11111111-2222-4333-8444-555555555555","isRequired":true,"uniqueKey":"customer_id","typeLabel":"string\u003cuuid>"},"customer_type":{"type":"string","enum":["individual","business"],"description":"Must match the customer's type.","example":"individual","isRequired":true,"uniqueKey":"customer_type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"customer_id":"11111111-2222-4333-8444-555555555555","customer_type":"individual"},"examples":{"Example":{"title":"Example","value":{"customer_id":"11111111-2222-4333-8444-555555555555","customer_type":"individual"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"372c3cbf-5500-494a-aef9-be4230e23e38":{"description":"Session minted","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"success","uniqueKey":"status","typeLabel":"string"},"status_code":{"type":"integer","example":200,"uniqueKey":"status_code","typeLabel":"integer"},"message":{"type":"string","example":"Request successful","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","properties":{"token":{"type":"string","description":"Signed KYC-only session JWT. Send as `X-Kyc-Session` on KYC platform APIs. Cannot call the Yativo API.","example":"YOUR_KYC_SESSION_TOKEN","uniqueKey":"data.token","typeLabel":"string"},"expires_at":{"type":"string","format":"date-time","example":"2026-11-16T23:33:00+00:00","uniqueKey":"data.expires_at","typeLabel":"string\u003cdate-time>"},"expires_in":{"type":"integer","description":"Lifetime in seconds. Default 1800 (30 minutes). Revoked on submit or when the hosted tab is closed.","example":1800,"uniqueKey":"data.expires_in","typeLabel":"integer"},"url":{"type":"string","format":"uri","description":"Hosted KYC/KYB page with `?session=` already set. Redirect or iframe this.","example":"https://kyc.yativo.com/individual/11111111-2222-4333-8444-555555555555?session=YOUR_KYC_SESSION_TOKEN","uniqueKey":"data.url","typeLabel":"string\u003curi>"},"portal_url":{"oneOf":[{"type":"string","description":"Alternate portal link when one is configured for your account; otherwise `null`.","example":null,"uniqueKey":"data.portal_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Alternate portal link when one is configured for your account; otherwise `null`.","example":null,"uniqueKey":"data.portal_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.portal_url","typeLabel":"string | null"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"success","status_code":200,"message":"Request successful","data":{"token":"YOUR_KYC_SESSION_TOKEN","expires_at":"2026-11-16T23:33:00+00:00","expires_in":1800,"url":"https://kyc.yativo.com/individual/11111111-2222-4333-8444-555555555555?session=YOUR_KYC_SESSION_TOKEN","portal_url":null}}}},"exampleType":"generated"}},"exampleType":"generated"},"767045bc-cb65-4789-8f94-036978645a6b":{"description":"Customer not found or does not belong to you","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"failed","uniqueKey":"status","typeLabel":"string"},"status_code":{"type":"integer","uniqueKey":"status_code","typeLabel":"integer"},"message":{"type":"string","description":"The error message, the same as `data.error`.","example":"Insufficient wallet balance","uniqueKey":"message","typeLabel":"string"},"data":{"oneOf":[{"type":"object","properties":{"error":{"type":"string","example":"Insufficient wallet balance","uniqueKey":"data.oneOf.0.error","typeLabel":"string"}},"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"error":{"type":"string","example":"Insufficient wallet balance"}},"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"},"error":{"type":"object","description":"Short error summary included in every failed response.","properties":{"code":{"type":"string","enum":["invalid_argument","unauthenticated","permission_denied","not_found","method_not_allowed","rate_limited","internal_error"],"description":"Short code from the HTTP status.","example":"invalid_argument","uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Same as the top-level `message`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Your `X-Request-Id` header if you sent one, otherwise an ID starting `req_`. Quote it when you contact support.","example":"req_5f2c9a1e7b3d4c8a6e0f1b2d","uniqueKey":"error.request_id","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"},"error_details":{"type":"object","description":"Included on every failed response, with the same shape for every endpoint.","properties":{"code":{"type":"string","enum":["bad_request","unauthenticated","payment_required","forbidden","not_found","method_not_allowed","conflict","validation_error","rate_limited","server_error","not_implemented","upstream_error","service_unavailable","upstream_timeout"],"example":"validation_error","uniqueKey":"error_details.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"The amount field is required.","uniqueKey":"error_details.message","typeLabel":"string"},"http_status":{"type":"integer","example":422,"uniqueKey":"error_details.http_status","typeLabel":"integer"},"fields":{"type":"object","description":"Messages per field. When the error isn't about a field, the message is under `error`.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error_details.fields.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error_details.fields.additionalProperties","typeLabel":"string[]"},"uniqueKey":"error_details.fields","typeLabel":"object"},"retryable":{"type":"boolean","description":"`true` for 409, 429, 500, 502, 503 and 504.","example":false,"uniqueKey":"error_details.retryable","typeLabel":"boolean"},"retry_after":{"oneOf":[{"type":"integer","description":"Seconds to wait before retrying, from the `Retry-After` header.","uniqueKey":"error_details.retry_after.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Seconds to wait before retrying, from the `Retry-After` header.","uniqueKey":"error_details.retry_after.oneOf.1","typeLabel":"null"}],"uniqueKey":"error_details.retry_after","typeLabel":"integer | null"}},"uniqueKey":"error_details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"failed","status_code":123,"message":"Insufficient wallet balance","data":{"error":"Insufficient wallet balance"},"error":{"code":"invalid_argument","message":"\u003cstring>","request_id":"req_5f2c9a1e7b3d4c8a6e0f1b2d"},"error_details":{"code":"validation_error","message":"The amount field is required.","http_status":422,"fields":{},"retryable":false,"retry_after":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"750db666-df57-4582-ac3c-c835fa6b82ed":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"failed","uniqueKey":"status","typeLabel":"string"},"status_code":{"type":"integer","example":422,"uniqueKey":"status_code","typeLabel":"integer"},"message":{"type":"string","example":"Request failed.","uniqueKey":"message","typeLabel":"string"},"data":{"type":"object","description":"The failing fields and their messages.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"data.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.additionalProperties","typeLabel":"string[]"},"uniqueKey":"data","typeLabel":"object"},"error":{"type":"object","description":"Short error summary included in every failed response.","properties":{"code":{"type":"string","enum":["invalid_argument","unauthenticated","permission_denied","not_found","method_not_allowed","rate_limited","internal_error"],"description":"Short code from the HTTP status.","example":"invalid_argument","uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Same as the top-level `message`.","uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Your `X-Request-Id` header if you sent one, otherwise an ID starting `req_`. Quote it when you contact support.","example":"req_5f2c9a1e7b3d4c8a6e0f1b2d","uniqueKey":"error.request_id","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"},"error_details":{"type":"object","description":"Included on every failed response, with the same shape for every endpoint.","properties":{"code":{"type":"string","enum":["bad_request","unauthenticated","payment_required","forbidden","not_found","method_not_allowed","conflict","validation_error","rate_limited","server_error","not_implemented","upstream_error","service_unavailable","upstream_timeout"],"example":"validation_error","uniqueKey":"error_details.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","example":"The amount field is required.","uniqueKey":"error_details.message","typeLabel":"string"},"http_status":{"type":"integer","example":422,"uniqueKey":"error_details.http_status","typeLabel":"integer"},"fields":{"type":"object","description":"Messages per field. When the error isn't about a field, the message is under `error`.","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"error_details.fields.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"error_details.fields.additionalProperties","typeLabel":"string[]"},"uniqueKey":"error_details.fields","typeLabel":"object"},"retryable":{"type":"boolean","description":"`true` for 409, 429, 500, 502, 503 and 504.","example":false,"uniqueKey":"error_details.retryable","typeLabel":"boolean"},"retry_after":{"oneOf":[{"type":"integer","description":"Seconds to wait before retrying, from the `Retry-After` header.","uniqueKey":"error_details.retry_after.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Seconds to wait before retrying, from the `Retry-After` header.","uniqueKey":"error_details.retry_after.oneOf.1","typeLabel":"null"}],"uniqueKey":"error_details.retry_after","typeLabel":"integer | null"}},"uniqueKey":"error_details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"failed","status_code":422,"message":"Request failed.","data":{},"error":{"code":"invalid_argument","message":"\u003cstring>","request_id":"req_5f2c9a1e7b3d4c8a6e0f1b2d"},"error_details":{"code":"validation_error","message":"The amount field is required.","http_status":422,"fields":{},"retryable":false,"retry_after":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5ae5ef56-3009-429f-83ca-119a707a48fe":{"apiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Your API key (`yativo_pk_...`) from Developers → API Keys. Send together with X-Api-Secret.","scopes":[],"schemeName":"apiKey"},"apiSecret":{"type":"apiKey","in":"header","name":"X-Api-Secret","description":"Your API secret (`yativo_sk_...`), shown once when the key is created.","scopes":[],"schemeName":"apiSecret"}}},"servers":{"20278df4-5766-4964-ad00-f8701cb54ff1":{"url":"https://api.yativo.com/api/v1","description":"Production"},"a7a60aa5-12ee-4ed9-af12-44a68e8a6ca6":{"url":"https://smtp.yativo.com/api/v1","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Your API key (`yativo_pk_...`) from Developers → API Keys. Send together with X-Api-Secret.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-Api-Key","type":"string","description":"Your API key (`yativo_pk_...`) from Developers → API Keys. Send together with X-Api-Secret.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-Api-Key"},{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Secret","description":"Your API secret (`yativo_sk_...`), shown once when the key is created.","scopes":[],"schemeName":"apiSecret"},"schema":{"title":"X-Api-Secret","type":"string","description":"Your API secret (`yativo_sk_...`), shown once when the key is created.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiSecret","name":"X-Api-Secret"}],"title":"apiKey \u0026 apiSecret"}]},"originalFileLocation":"openapi-fiat.yaml"},"subdomain":"yativo","siteName":"Yativo","title":"Mint KYC session - Yativo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T22:22:58.078Z","originalFileLocation":"fiat-api-reference/customers/kyc-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=\"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 signed session for the hosted KYC/KYB page or the KYC platform APIs\">\u003cmeta data-mint-head name=\"application-name\" content=\"Yativo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_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/yativo/exEDFeWoXCL_KYHd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Mint KYC session - Yativo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Yativo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://yativo.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Mint+KYC+session\u0026amp;description=Create+a+signed+session+for+the+hosted+KYC%2FKYB+page+or+the+KYC+platform+APIs\u0026amp;theme=0b6afb53a624c14c2ecc113d\u0026amp;signature=406c92bebcd9ee7f9df7e7d8d47f627bc533f7a9007a2b18ed7191b7a8956e54\">\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=\"Mint KYC session - Yativo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://yativo.mintlify.site/_mintlify/api/og/v2?division=Customers\u0026amp;title=Mint+KYC+session\u0026amp;description=Create+a+signed+session+for+the+hosted+KYC%2FKYB+page+or+the+KYC+platform+APIs\u0026amp;theme=0b6afb53a624c14c2ecc113d\u0026amp;signature=406c92bebcd9ee7f9df7e7d8d47f627bc533f7a9007a2b18ed7191b7a8956e54\">\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/yativo/exEDFeWoXCL_KYHd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Yativo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#813AE3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fiat-api-reference/customers/kyc-session.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.yativo.com/#organization\",\"name\":\"Yativo\",\"url\":\"https://docs.yativo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/yativo/_4AojVs77vZSnaI6/logo/yativo-light.png?fit=max\u0026auto=format\u0026n=_4AojVs77vZSnaI6\u0026q=85\u0026s=925bc977f579b795be5138bca21d9aca\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.yativo.com#website\",\"name\":\"Yativo\",\"url\":\"https://docs.yativo.com\",\"publisher\":{\"@id\":\"https://docs.yativo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session#webpage\",\"url\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session\",\"name\":\"Mint KYC session\",\"description\":\"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs\",\"dateModified\":\"2026-11-16T22:22:58.078Z\",\"isPartOf\":{\"@id\":\"https://docs.yativo.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Customers\",\"item\":\"https://docs.yativo.com/fiat-api-reference/customers/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mint KYC session\",\"item\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session#apireference\",\"headline\":\"Mint KYC session\",\"name\":\"Mint KYC session\",\"description\":\"Create a signed session for the hosted KYC/KYB page or the KYC platform APIs\",\"url\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.yativo.com/fiat-api-reference/customers/kyc-session#webpage\"},\"dateModified\":\"2026-11-16T22:22:58.078Z\",\"publisher\":{\"@id\":\"https://docs.yativo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.yativo.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Yativo\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Yativo\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/fiat-api-reference/customers/kyc-session.md","siteName":"Yativo","nav":{"global":{"anchors":[{"anchor":"Fiat Dashboard","icon":"building-columns","href":"https://app.yativo.com"},{"anchor":"Status","icon":"signal","href":"https://status.yativo.com"},{"anchor":"Support","icon":"headset","href":"https://yativo.com/support"}]},"tabs":[{"tab":"Yativo","pages":[{"title":"Yativo","href":"/yativo/introduction"}]},{"tab":"Yativo Fiat","pages":[{"title":"Yativo Fiat","href":"/yativo-fiat/introduction"}]},{"tab":"Fiat API References","groups":[{"group":"Overview","pages":[{"title":"Fiat API References","href":"/fiat-api-reference/introduction"}]},{"group":"Customers","pages":[{"title":"Create Customer","description":"Create a new customer profile for an individual or business","openapi":"openapi-fiat.yaml POST /customer","href":"/fiat-api-reference/customers/create"},{"title":"Mint KYC session","openapi":"openapi-fiat.yaml POST /customer/kyc-session","href":"/fiat-api-reference/customers/kyc-session"},{"title":"List Customers","description":"Retrieve a paginated list of all customers in your account","openapi":"openapi-fiat.yaml GET /customer","href":"/fiat-api-reference/customers/list"},{"title":"Get Customer","openapi":"openapi-fiat.yaml GET /customer/{customer_id}","href":"/fiat-api-reference/customers/get"},{"title":"Update Customer","openapi":"openapi-fiat.yaml PUT /customer/{customer_id}","href":"/fiat-api-reference/customers/update"},{"title":"Delete Customer","openapi":"openapi-fiat.yaml DELETE /customer/{customer_id}","href":"/fiat-api-reference/customers/delete"}]},{"group":"Compliance RFIs","pages":[{"title":"List RFIs","openapi":"openapi-fiat.yaml GET /business/rfis","href":"/fiat-api-reference/rfis/list"},{"title":"Get RFI","openapi":"openapi-fiat.yaml GET /business/rfis/{id}","href":"/fiat-api-reference/rfis/get"},{"title":"Reply to RFI","openapi":"openapi-fiat.yaml PUT /business/rfis/{id}/draft-responses","href":"/fiat-api-reference/rfis/reply-to-rfi"}]},{"group":"KYC / KYB","pages":[{"group":"Individual","pages":[{"title":"Submit Individual KYC","openapi":"openapi-fiat.yaml POST /individual-kyc/submit","href":"/fiat-api-reference/kyc/submit-individual"},{"title":"Update Individual KYC (Partial)","openapi":"openapi-fiat.yaml PATCH /individual-kyc/{customerId}","href":"/fiat-api-reference/kyc/update-individual"},{"title":"Get Occupation Codes","openapi":"openapi-fiat.yaml GET /auth/occupation-codes","href":"/fiat-api-reference/kyc/occupation-codes"}]},{"group":"Business","pages":[{"title":"Submit Business KYB","openapi":"openapi-fiat.yaml POST /business-kyc/submit","href":"/fiat-api-reference/kyc/submit-business"},{"title":"Update Business KYB (Partial)","openapi":"openapi-fiat.yaml PATCH /business-kyc/{customerId}","href":"/fiat-api-reference/kyc/update-business"}]},{"group":"Shared","pages":[{"title":"Upload File","openapi":"openapi-fiat.yaml POST /storage/upload","href":"/fiat-api-reference/kyc/upload"},{"title":"Update KYC Submission","openapi":"openapi-fiat.yaml PUT /customer/kyc/update","href":"/fiat-api-reference/kyc/update"},{"title":"Resubmit Endorsement","openapi":"openapi-fiat.yaml POST /customer/kyc/resubmit/{customerId}/{endorsement}","href":"/fiat-api-reference/kyc/resubmit-endorsement"},{"title":"Resubmit Endorsement (KYC Platform)","openapi":"openapi-fiat.yaml POST /kyc/endorsements/{customerId}/{service}/resubmit","href":"/fiat-api-reference/kyc/resubmit-endorsement-platform"},{"title":"Regenerate Endorsement Link","openapi":"openapi-fiat.yaml GET /kyc/regenerate/{customerId}/{service}","href":"/fiat-api-reference/kyc/endorsement-regenerate"},{"title":"Get Verification Locations","openapi":"openapi-fiat.yaml GET /auth/verification-locations","href":"/fiat-api-reference/kyc/verification-locations"}]}]},{"group":"KYC Lookups","pages":[{"group":"Individual","pages":[{"title":"List Occupations","openapi":"openapi-fiat.yaml GET /occupations","href":"/fiat-api-reference/kyc-lookups/occupations"},{"title":"List Account Purposes (Individual)","openapi":"openapi-fiat.yaml GET /individual-kyc/account-purposes","href":"/fiat-api-reference/kyc-lookups/individual-account-purposes"},{"title":"List Sources of Funds (Individual)","openapi":"openapi-fiat.yaml GET /individual-kyc/source-of-funds","href":"/fiat-api-reference/kyc-lookups/individual-source-of-funds"},{"title":"List Expected Monthly Payment Ranges","openapi":"openapi-fiat.yaml GET /individual-kyc/expected-monthly-payments-usd","href":"/fiat-api-reference/kyc-lookups/expected-monthly-payments"}]},{"group":"Business","pages":[{"title":"List Business Industries","openapi":"openapi-fiat.yaml GET /business-industries","href":"/fiat-api-reference/kyc-lookups/business-industries"},{"title":"List Account Purposes (Business)","openapi":"openapi-fiat.yaml GET /business-kyc/account-purposes","href":"/fiat-api-reference/kyc-lookups/business-account-purposes"},{"title":"List Sources of Funds (Business)","openapi":"openapi-fiat.yaml GET /business-kyc/source-of-funds","href":"/fiat-api-reference/kyc-lookups/business-source-of-funds"},{"title":"List Transaction Currencies","openapi":"openapi-fiat.yaml GET /transaction-currencies","href":"/fiat-api-reference/kyc-lookups/transaction-currencies"},{"title":"List Transaction Countries","openapi":"openapi-fiat.yaml GET /transaction-countries","href":"/fiat-api-reference/kyc-lookups/transaction-countries"}]},{"group":"Shared","pages":[{"title":"List Countries","openapi":"openapi-fiat.yaml GET /countries","href":"/fiat-api-reference/kyc-lookups/countries"},{"title":"List Subdivisions","openapi":"openapi-fiat.yaml GET /subdivisions/{countryCode}","href":"/fiat-api-reference/kyc-lookups/subdivisions"},{"title":"Get Postal Code Format","openapi":"openapi-fiat.yaml GET /postal-codes/{countryCode}","href":"/fiat-api-reference/kyc-lookups/postal-codes"},{"title":"List ID Types","openapi":"openapi-fiat.yaml GET /identification-types/{countryCode}","href":"/fiat-api-reference/kyc-lookups/identification-types"}]}]},{"group":"Payments \u0026 Transfers","pages":[{"title":"Get Exchange Rate / Quote","openapi":"openapi-fiat.yaml POST /exchange-rate","href":"/fiat-api-reference/payments/exchange-rate"},{"title":"Get Market Rates","openapi":"openapi-fiat.yaml GET /exchange-rates","href":"/fiat-api-reference/payments/market-rates"},{"title":"Get Fee Schedule","openapi":"openapi-fiat.yaml GET /fees","href":"/fiat-api-reference/payments/fees"},{"title":"Get Payout Methods","openapi":"openapi-fiat.yaml GET /payment-methods/payout","href":"/fiat-api-reference/payments/methods"},{"title":"Get Payin Methods","openapi":"openapi-fiat.yaml GET /payment-methods/payin","href":"/fiat-api-reference/payments/payin-methods"},{"title":"Get Payout Form Fields","openapi":"openapi-fiat.yaml GET /beneficiary/form/show/{payment_method_id}","href":"/fiat-api-reference/payments/methods-form"},{"title":"Get Supported Countries","openapi":"openapi-fiat.yaml GET /payment-methods/payout/countries","href":"/fiat-api-reference/payments/countries"},{"title":"List Currencies","openapi":"openapi-fiat.yaml GET /currencies/all","href":"/fiat-api-reference/payments/currencies"},{"title":"Initiate Payout","openapi":"openapi-fiat.yaml POST /payout/simple","href":"/fiat-api-reference/payments/payout"}]},{"group":"Card Checkout","pages":[{"group":"Account","pages":[{"title":"Request access","openapi":"openapi-fiat.yaml POST /card-checkout/account/request-access","href":"/fiat-api-reference/card-checkout/request-access"},{"title":"Get account","openapi":"openapi-fiat.yaml GET /card-checkout/account","href":"/fiat-api-reference/card-checkout/account"}]},{"group":"Selling customers","pages":[{"title":"Submit endorsement","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/endorsement","href":"/fiat-api-reference/card-checkout/customers-endorsement"},{"title":"Get selling customer","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}","href":"/fiat-api-reference/card-checkout/customers-get"},{"title":"Create onboarding link","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/onboarding","href":"/fiat-api-reference/card-checkout/customers-onboarding"}]},{"group":"Withdrawals","pages":[{"title":"List supported payout methods","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}/supported-payout-methods","href":"/fiat-api-reference/card-checkout/supported-payout-methods"},{"title":"Create payout method","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/payout-methods","href":"/fiat-api-reference/card-checkout/payout-methods-create"},{"title":"List payout methods","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}/payout-methods","href":"/fiat-api-reference/card-checkout/payout-methods-list"},{"title":"Update payout method","openapi":"openapi-fiat.yaml PATCH /card-checkout/customers/{customer_id}/payout-methods/{method_id}","href":"/fiat-api-reference/card-checkout/payout-methods-update"},{"title":"Delete payout method","openapi":"openapi-fiat.yaml DELETE /card-checkout/customers/{customer_id}/payout-methods/{method_id}","href":"/fiat-api-reference/card-checkout/payout-methods-delete"},{"title":"Create withdrawal","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/payouts","href":"/fiat-api-reference/card-checkout/payouts-create"},{"title":"List withdrawals","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}/payouts","href":"/fiat-api-reference/card-checkout/payouts-list"},{"title":"Get withdrawal","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}/payouts/{payout_id}","href":"/fiat-api-reference/card-checkout/payouts-get"},{"title":"Cancel withdrawal","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/payouts/{payout_id}/cancel","href":"/fiat-api-reference/card-checkout/payouts-cancel"}]},{"group":"Verification","pages":[{"title":"Get verification form","openapi":"openapi-fiat.yaml GET /card-checkout/customers/{customer_id}/verification","href":"/fiat-api-reference/card-checkout/verification-get"},{"title":"Submit business verification","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/verification","href":"/fiat-api-reference/card-checkout/verification-submit"},{"title":"Answer verification items","openapi":"openapi-fiat.yaml POST /card-checkout/customers/{customer_id}/verification/information","href":"/fiat-api-reference/card-checkout/verification-information"}]},{"group":"Orders","pages":[{"title":"Create order","openapi":"openapi-fiat.yaml POST /card-checkout/orders","href":"/fiat-api-reference/card-checkout/orders-create"},{"title":"List orders","openapi":"openapi-fiat.yaml GET /card-checkout/orders","href":"/fiat-api-reference/card-checkout/orders-list"},{"title":"Get order","openapi":"openapi-fiat.yaml GET /card-checkout/orders/{id}","href":"/fiat-api-reference/card-checkout/orders-get"}]}]},{"group":"Deposits","pages":[{"title":"Create Deposit (Payin)","openapi":"openapi-fiat.yaml POST /wallet/deposits/new","href":"/fiat-api-reference/deposits/create"},{"title":"List Deposits","openapi":"openapi-fiat.yaml GET /wallet/deposits","href":"/fiat-api-reference/deposits/list"},{"title":"Get Deposit","openapi":"openapi-fiat.yaml GET /wallet/deposits/{depositId}","href":"/fiat-api-reference/deposits/get"},{"title":"List Pay-in Countries","openapi":"openapi-fiat.yaml GET /payment-methods/payin/countries","href":"/fiat-api-reference/deposits/payin-countries"},{"title":"List Pay-in Currencies","openapi":"openapi-fiat.yaml GET /payment-methods/payin/currency","href":"/fiat-api-reference/deposits/payin-currencies"},{"title":"Create Deposit Wallet","openapi":"openapi-fiat.yaml POST /crypto/create-wallet","href":"/fiat-api-reference/deposits/crypto-create-wallet"},{"title":"List Deposit Wallets","openapi":"openapi-fiat.yaml GET /crypto/get-wallets","href":"/fiat-api-reference/deposits/crypto-wallets"},{"title":"List Stablecoin Deposits","openapi":"openapi-fiat.yaml GET /crypto/deposit-histories","href":"/fiat-api-reference/deposits/crypto-deposit-history"},{"title":"List Deposits to an Address","openapi":"openapi-fiat.yaml GET /crypto/wallet/deposit/histories/{wallet_address}","href":"/fiat-api-reference/deposits/crypto-wallet-history"}]},{"group":"Virtual Accounts","pages":[{"title":"Create Virtual Account","openapi":"openapi-fiat.yaml POST /business/virtual-account/create","href":"/fiat-api-reference/virtual-accounts/create"},{"title":"List Currencies and Endorsements","openapi":"openapi-fiat.yaml GET /business/virtual-account/currencies-and-endorsements","href":"/fiat-api-reference/virtual-accounts/currencies"},{"title":"List Virtual Accounts","openapi":"openapi-fiat.yaml GET /business/virtual-account","href":"/fiat-api-reference/virtual-accounts/list"},{"title":"Get Virtual Account","openapi":"openapi-fiat.yaml GET /business/virtual-account/show/{externalId}","href":"/fiat-api-reference/virtual-accounts/get"},{"title":"Delete Virtual Account","openapi":"openapi-fiat.yaml DELETE /business/virtual-account/delete-virtual-account/{account_id}","href":"/fiat-api-reference/virtual-accounts/delete"},{"title":"Virtual Account Transaction History","openapi":"openapi-fiat.yaml GET /business/virtual-account/history/{accountNumber}","href":"/fiat-api-reference/virtual-accounts/history"},{"title":"All Virtual Account Histories","openapi":"openapi-fiat.yaml GET /business/virtual-account/histories","href":"/fiat-api-reference/virtual-accounts/all-histories"},{"title":"Customer Virtual Accounts","openapi":"openapi-fiat.yaml GET /business/virtual-account/customer/accounts/{customerId}","href":"/fiat-api-reference/virtual-accounts/customer-accounts"}]},{"group":"Wallets","pages":[{"title":"Get Wallet Balance","openapi":"openapi-fiat.yaml GET /wallet/balance","href":"/fiat-api-reference/wallets/balance"},{"title":"Get Total Balance","openapi":"openapi-fiat.yaml GET /wallet/balance/total","href":"/fiat-api-reference/wallets/balance-total"},{"title":"List Wallet Payouts","openapi":"openapi-fiat.yaml GET /wallet/payouts","href":"/fiat-api-reference/wallets/payouts"}]},{"group":"Sandbox","pages":[{"title":"Top up wallet (sandbox only)","openapi":"openapi-fiat.yaml POST /wallet/sandbox/topup","href":"/fiat-api-reference/sandbox/wallet-topup"},{"title":"Mark transaction successful (sandbox only)","openapi":"openapi-fiat.yaml POST /sandbox/transactions/{id}/succeed","href":"/fiat-api-reference/sandbox/transactions-succeed"},{"title":"Mark transaction failed (sandbox only)","openapi":"openapi-fiat.yaml POST /sandbox/transactions/{id}/fail","href":"/fiat-api-reference/sandbox/transactions-fail"},{"title":"Simulate a virtual account deposit (sandbox only)","openapi":"openapi-fiat.yaml POST /sandbox/virtual-accounts/{accountId}/simulate-deposit","href":"/fiat-api-reference/sandbox/virtual-account-deposit"},{"title":"Simulate a virtual card event (sandbox only)","openapi":"openapi-fiat.yaml POST /sandbox/virtual-cards/{cardId}/simulate","href":"/fiat-api-reference/sandbox/virtual-card"},{"title":"Simulate a spend card event (sandbox only)","openapi":"openapi-fiat.yaml POST /sandbox/spend-cards/{cardId}/simulate","href":"/fiat-api-reference/sandbox/spend-card"},{"title":"Simulate webhook (sandbox only)","openapi":"openapi-fiat.yaml POST /demo/webhook/{type}","href":"/fiat-api-reference/sandbox/simulate-webhook"}]},{"group":"Beneficiaries","pages":[{"title":"Add Beneficiary","openapi":"openapi-fiat.yaml POST /beneficiaries/payment-methods","href":"/fiat-api-reference/beneficiaries/payment-methods-create"},{"title":"List Beneficiaries","openapi":"openapi-fiat.yaml GET /beneficiaries/payment-methods/all","href":"/fiat-api-reference/beneficiaries/payment-methods-list"},{"title":"Get Beneficiary","openapi":"openapi-fiat.yaml POST /beneficiaries/payment-methods/{id}","href":"/fiat-api-reference/beneficiaries/payment-methods-get"},{"title":"Update Beneficiary","openapi":"openapi-fiat.yaml PUT /beneficiaries/payment-methods/update/{id}","href":"/fiat-api-reference/beneficiaries/payment-methods-update"},{"title":"Delete Beneficiary","openapi":"openapi-fiat.yaml DELETE /beneficiaries/payment-methods/delete/{id}","href":"/fiat-api-reference/beneficiaries/payment-methods-delete"}]},{"group":"Transactions","pages":[{"title":"List Transactions","openapi":"openapi-fiat.yaml GET /business/transactions/index","href":"/fiat-api-reference/transactions/list"},{"title":"List Transactions by Currency","openapi":"openapi-fiat.yaml GET /business/transaction/by-currency","href":"/fiat-api-reference/transactions/by-currency"},{"title":"Get Transaction","openapi":"openapi-fiat.yaml GET /business/transaction/show/{id}","href":"/fiat-api-reference/transactions/get"},{"title":"Track Transaction","openapi":"openapi-fiat.yaml GET /transaction/tracking/{quote_id}","href":"/fiat-api-reference/transactions/track"},{"title":"Track Transaction by ID","openapi":"openapi-fiat.yaml GET /transaction/track","href":"/fiat-api-reference/transactions/track-by-id"},{"title":"Download Receipt","openapi":"openapi-fiat.yaml GET /business/transaction/{transactionId}/{type}/receipt","href":"/fiat-api-reference/transactions/receipt"}]},{"group":"Virtual Cards","pages":[{"title":"Create Virtual Card","openapi":"openapi-fiat.yaml POST /customer/virtual/cards/create","href":"/fiat-api-reference/virtual-cards/create"},{"title":"List Virtual Cards","openapi":"openapi-fiat.yaml GET /customer/virtual/cards/list","href":"/fiat-api-reference/virtual-cards/list"},{"title":"Get Virtual Card","openapi":"openapi-fiat.yaml GET /customer/virtual/cards/get/{card_id}","href":"/fiat-api-reference/virtual-cards/get"},{"title":"Top Up Card","openapi":"openapi-fiat.yaml POST /customer/virtual/cards/topup","href":"/fiat-api-reference/virtual-cards/topup"},{"title":"Freeze / Unfreeze Card","openapi":"openapi-fiat.yaml PUT /customer/virtual/cards/update/{card_id}","href":"/fiat-api-reference/virtual-cards/update"},{"title":"Card Transactions","openapi":"openapi-fiat.yaml GET /customer/virtual/cards/transactions/{card_id}","href":"/fiat-api-reference/virtual-cards/transactions"},{"title":"Withdraw from Card","openapi":"openapi-fiat.yaml POST /customer/virtual/cards/withdraw","href":"/fiat-api-reference/virtual-cards/withdraw"},{"title":"Terminate Card","openapi":"openapi-fiat.yaml POST /customer/virtual/cards/terminate","href":"/fiat-api-reference/virtual-cards/terminate"}]},{"group":"Payouts","pages":[{"title":"Single Payout","openapi":"openapi-fiat.yaml POST /payout/simple","href":"/fiat-api-reference/payouts/simple"},{"title":"List Payouts","openapi":"openapi-fiat.yaml GET /payout/get","href":"/fiat-api-reference/payouts/list"},{"title":"Get Payout","openapi":"openapi-fiat.yaml GET /payout/fetch/{payout_id}","href":"/fiat-api-reference/payouts/get"}]},{"group":"Currency Swap","pages":[{"title":"List Swap Pairs","openapi":"openapi-fiat.yaml GET /wallet/swap/pairs","href":"/fiat-api-reference/swap/pairs"},{"title":"Quote Swap","openapi":"openapi-fiat.yaml POST /wallet/swap/quote","href":"/fiat-api-reference/swap/quote"},{"title":"Run Swap","openapi":"openapi-fiat.yaml POST /wallet/swap","href":"/fiat-api-reference/swap/create"},{"title":"List Swaps","openapi":"openapi-fiat.yaml GET /wallet/swap","href":"/fiat-api-reference/swap/list"},{"title":"Get Swap","openapi":"openapi-fiat.yaml GET /wallet/swap/{reference}","href":"/fiat-api-reference/swap/get"}]},{"group":"IP Whitelist","pages":[{"title":"Check IP Whitelist","openapi":"openapi-fiat.yaml GET /ip-whitelist/check","href":"/fiat-api-reference/ip/check"}]},{"group":"Corporate Cards","pages":[{"group":"Funding","pages":[{"title":"Get Funding Address and Balance","openapi":"openapi-fiat.yaml GET /corporate-card/wallet","href":"/fiat-api-reference/corporate-cards/wallet-get"}]},{"group":"Employees","pages":[{"title":"Create Employee","openapi":"openapi-fiat.yaml POST /corporate-card/employees","href":"/fiat-api-reference/corporate-cards/employees-create"},{"title":"List Employees","openapi":"openapi-fiat.yaml GET /corporate-card/employees","href":"/fiat-api-reference/corporate-cards/employees-list"},{"title":"Get Employee","openapi":"openapi-fiat.yaml GET /corporate-card/employees/{employee_id}","href":"/fiat-api-reference/corporate-cards/employees-get"},{"title":"Update Employee","openapi":"openapi-fiat.yaml PUT /corporate-card/employees/{employee_id}","href":"/fiat-api-reference/corporate-cards/employees-update"},{"title":"Terminate Employee","openapi":"openapi-fiat.yaml DELETE /corporate-card/employees/{employee_id}","href":"/fiat-api-reference/corporate-cards/employees-terminate"},{"title":"Submit Employee KYC","openapi":"openapi-fiat.yaml POST /corporate-card/employees/kyc","href":"/fiat-api-reference/corporate-cards/kyc-submit"}]},{"group":"Employee Balance","pages":[{"title":"Fund Employee","openapi":"openapi-fiat.yaml POST /corporate-card/employees/balance","href":"/fiat-api-reference/corporate-cards/employees-fund"},{"title":"Get Employee Balance","openapi":"openapi-fiat.yaml GET /corporate-card/employees/{employee_id}/balance","href":"/fiat-api-reference/corporate-cards/employees-balance"}]},{"group":"Cards","pages":[{"title":"Issue Card","openapi":"openapi-fiat.yaml POST /corporate-card/employees/cards","href":"/fiat-api-reference/corporate-cards/cards-create"},{"title":"List Cards","openapi":"openapi-fiat.yaml GET /corporate-card/employees/cards","href":"/fiat-api-reference/corporate-cards/cards-list"},{"title":"Get Card","openapi":"openapi-fiat.yaml GET /corporate-card/employees/cards/{card_id}","href":"/fiat-api-reference/corporate-cards/cards-get"},{"title":"Change Card Status","openapi":"openapi-fiat.yaml POST /corporate-card/employees/cards/status","href":"/fiat-api-reference/corporate-cards/cards-status"},{"title":"Set Card Limits","openapi":"openapi-fiat.yaml PUT /corporate-card/employees/cards/limits","href":"/fiat-api-reference/corporate-cards/cards-limits"}]},{"group":"Memos","pages":[{"title":"Create Memo","openapi":"openapi-fiat.yaml POST /corporate-card/employees/memos","href":"/fiat-api-reference/corporate-cards/memos-create"},{"title":"List Memos","openapi":"openapi-fiat.yaml GET /corporate-card/employees/{employee_id}/memos","href":"/fiat-api-reference/corporate-cards/memos-list"},{"title":"Approve Memo","openapi":"openapi-fiat.yaml POST /corporate-card/employees/memos/{memo_id}/approve","href":"/fiat-api-reference/corporate-cards/memos-approve"},{"title":"Reject Memo","openapi":"openapi-fiat.yaml POST /corporate-card/employees/memos/{memo_id}/reject","href":"/fiat-api-reference/corporate-cards/memos-reject"}]},{"group":"Locations","pages":[{"title":"List Location Countries","openapi":"openapi-fiat.yaml GET /locations/countries","href":"/fiat-api-reference/corporate-cards/locations-countries"},{"title":"List States","openapi":"openapi-fiat.yaml GET /locations/states/{country_id}","href":"/fiat-api-reference/corporate-cards/locations-states"}]}]},{"group":"Corporate Card Transactions","pages":[{"title":"List Card Transactions","openapi":"openapi-fiat.yaml GET /business/spend-card/transactions","href":"/fiat-api-reference/corporate-card-transactions/list"},{"title":"Get Card Transaction","openapi":"openapi-fiat.yaml GET /business/spend-card/transactions/{id}","href":"/fiat-api-reference/corporate-card-transactions/get"},{"title":"Dispute Card Transaction","openapi":"openapi-fiat.yaml POST /business/spend-card/transactions/{id}/dispute","href":"/fiat-api-reference/corporate-card-transactions/dispute"},{"title":"Add Transaction Note","openapi":"openapi-fiat.yaml POST /business/spend-card/transactions/{id}/notes","href":"/fiat-api-reference/corporate-card-transactions/notes"},{"title":"Upload Transaction Invoice","openapi":"openapi-fiat.yaml POST /business/spend-card/transactions/{id}/invoices","href":"/fiat-api-reference/corporate-card-transactions/invoices"}]},{"group":"Corporate Card Links","pages":[{"title":"Get Card Link","openapi":"openapi-fiat.yaml GET /corporate-card/employees/cards/{card_id}/link","href":"/fiat-api-reference/corporate-card-links/get-link"},{"title":"Replace Card Link","openapi":"openapi-fiat.yaml POST /corporate-card/employees/cards/{card_id}/link/rotate","href":"/fiat-api-reference/corporate-card-links/rotate-link"},{"title":"Get Employee Card Sign-in","openapi":"openapi-fiat.yaml GET /corporate-card/employees/{employee_id}/card-access","href":"/fiat-api-reference/corporate-card-links/get-card-access"},{"title":"Reset Employee Card Sign-in","openapi":"openapi-fiat.yaml POST /corporate-card/employees/{employee_id}/card-access/reset","href":"/fiat-api-reference/corporate-card-links/reset-card-access"},{"title":"Cancel Employee Email Change","openapi":"openapi-fiat.yaml DELETE /corporate-card/employees/{employee_id}/email/pending","href":"/fiat-api-reference/corporate-card-links/cancel-email-change"},{"title":"List Card Link Themes","openapi":"openapi-fiat.yaml GET /corporate-card/card-link/themes","href":"/fiat-api-reference/corporate-card-links/list-themes"},{"title":"Create Card Link Theme","openapi":"openapi-fiat.yaml POST /corporate-card/card-link/themes","href":"/fiat-api-reference/corporate-card-links/create-theme"},{"title":"Get Card Link Theme","openapi":"openapi-fiat.yaml GET /corporate-card/card-link/themes/{theme_id}","href":"/fiat-api-reference/corporate-card-links/get-theme"},{"title":"Update Card Link Theme","openapi":"openapi-fiat.yaml PUT /corporate-card/card-link/themes/{theme_id}","href":"/fiat-api-reference/corporate-card-links/update-theme"},{"title":"Delete Card Link Theme","openapi":"openapi-fiat.yaml DELETE /corporate-card/card-link/themes/{theme_id}","href":"/fiat-api-reference/corporate-card-links/delete-theme"},{"title":"Send Theme Test Email","openapi":"openapi-fiat.yaml POST /corporate-card/card-link/themes/{theme_id}/test-email","href":"/fiat-api-reference/corporate-card-links/test-theme-email"}]},{"group":"Webhooks","pages":[{"title":"Create / Update Webhook","openapi":"openapi-fiat.yaml POST /business/webhook","href":"/fiat-api-reference/webhooks/create"},{"title":"List Webhooks","openapi":"openapi-fiat.yaml GET /business/webhook","href":"/fiat-api-reference/webhooks/list"},{"title":"Update Webhook","openapi":"openapi-fiat.yaml PUT /business/webhook/{webhook_id}","href":"/fiat-api-reference/webhooks/update"},{"title":"Delete Webhook","openapi":"openapi-fiat.yaml DELETE /business/webhook/{webhook_id}","href":"/fiat-api-reference/webhooks/delete"},{"title":"Regenerate Webhook Secret","openapi":"openapi-fiat.yaml POST /business/webhook/{webhook_id}/regenerate-secret","href":"/fiat-api-reference/webhooks/regenerate-secret"}]},{"group":"Developer","pages":[{"title":"Events","openapi":"openapi-fiat.yaml GET /business/events/all","href":"/fiat-api-reference/developer/events"},{"title":"Get Event","openapi":"openapi-fiat.yaml GET /business/events/show/{id}","href":"/fiat-api-reference/developer/event-get"}]}]}]},"basePath":"","title":"Mint KYC session - Yativo","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","Page-CWFqNdGh.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}