Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider’s widget for document uploads and liveness checks. Webhook events will notify about the validation process.
Production only: The provider URL for document uploads and liveness checks only works in production.
Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio’s as a sharing partner — see Reusable KYC prerequisites before you integrate it.
This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both.
The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.
kycProviderShareToken belongs to Reusable KYC (Sumsub share token). It is separate from Ripio KYC reuse via OTP, which uses Start KYC and Validate KYC OTP. If your account is configured for OTP reuse, this endpoint always requires kycSubmission — it cannot open that flow on its own. Calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException).For the Partner-submitted (API) model, send kycProviderShareToken in Start KYC instead — that’s the call that opens the verification, and where the token is redeemed. Sending it here has no effect for that model. This endpoint only accepts the token directly for the Ripio-hosted (redirect) model, where it has no separate Start KYC call. See Reusable KYC (Sumsub share token) for the full behavior per model.
Reusable KYC via Sumsub share token is an account-level opt-in. A share token by itself does not enable this flow: if the feature is not enabled for your account, sending kycProviderShareToken returns 403 with KycProviderTokenSharingNotEnabledException and no KYC is created.
Authorizations
Authorization
string
header
required
Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.
Headers
X-Ripio-User-Ip
string
Optional. The public IP address of the end user's device (IPv4 or IPv6), captured on your frontend and forwarded by your backend — never your server's own address. Used for traceability and fraud prevention. An address that is not a valid IPv4 or IPv6 discards the end-user context of the request, without failing it. See Forwarding end-user context.
Maximum string length: 45
X-Ripio-User-Agent
string
Optional. The User-Agent of the end user's browser or app, not your backend's HTTP client. Longer values are truncated to 500 characters. See Forwarding end-user context.
Maximum string length: 500
X-Ripio-User-Device-Id
string
Optional. A stable identifier of the end user's device, as your app or frontend defines it. Longer values are truncated to 200 characters. See Forwarding end-user context.
Maximum string length: 200
Path Parameters
customerId
string<uuid>
required
Unique identifier for the customer.
Body
application/json
KYC data for the customer. Structure should align with fields from /kycRequirements/.
Request body for KYC submission. Use kycSubmission + redirectUrl for the standard API flow, or only redirectUrl for the Ripio KYC delegated flow. If your account is enabled for Reusable KYC (Sumsub share token), you can add kycProviderShareToken to reuse a verification the customer already completed in your own Sumsub account. This is separate from Ripio KYC reuse via OTP: if your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException).
kycSubmission
object
Customer KYC data. Which fields are accepted, and which are required, depends on country — the four countries have four different schemas, so the required list below is only their intersection. Each field's description states its per-country requiredness.
See KYC fields by country for the full matrix and the cross-field rules, and call /kycRequirements/ for the live catalogs of the CHOICE fields. Not required when using the Ripio KYC delegated flow.
Show child attributes
redirectUrl
string<uri>
URL to redirect the user after completing the KYC flow. Required for the Ripio KYC delegated flow; optional for the API flow.
Example:
"https://www.example.com/"
kycProviderShareToken
string
Optional. Sumsub share token for a customer already verified in your own Sumsub account (reusable KYC). Ripio redeems it so that, when both verifications are compatible, the customer does not have to upload documents or repeat the liveness check. On this endpoint, it only takes effect for the Ripio KYC delegated flow (no kycSubmission, only redirectUrl). For the API flow, send it on Start KYC instead — that is the call that opens the verification for that flow, and sending it here has no effect.
Two prerequisites must be met before this field does anything. First, reusable KYC is an opt-in feature that must be enabled for your account by the Ripio team: while it is disabled, sending this field returns 403 with the error code 20065 (KycProviderTokenSharingNotEnabledException) and no KYC is created. Second, your Sumsub account must be paired with Ripio's as a sharing partner — you add the partner token Ripio gives you under Reusable identity → Partners → Recipients → Add recipient in your Sumsub dashboard; without that pairing, the tokens you generate are rejected when Ripio tries to redeem them. See Reusable KYC prerequisites and Sumsub's Add recipient.
Generate the token with Sumsub's Generate share token endpoint, using the customer's applicantId and forClientId set to Ripio's Sumsub client ID.
Reuse is subject to Sumsub's compatibility rules: only the verification steps that overlap between your level and Ripio's are transferred, and the shared documents are re-checked against Ripio's requirements. When the levels have no matching steps, or a re-check fails, the customer is asked to complete the missing steps — see Sumsub's Reusable KYC share documentation.
Share tokens are short-lived and single-use: generate a fresh token right before each call to this endpoint. The token is only used when a new verification process is opened — if a verification is already in progress for the customer, the response is idempotent and the token is ignored.
Maximum string length: 2000
Response
KYC submission received successfully. Includes providerUrl for document upload and liveness check.
submissionId
string<uuid>
required
Unique identifier for the submitted KYC data.
createdAt
string<date-time>
required
Date and time the KYC submission was created (UTC format).
providerUrl
string<url>
required
Points to a third-party KYC provider's widget to handle file uploads and liveness checks. Only available in production.
otpRequired
boolean
Whether the OTP sent to the customer's email still needs to be validated with Validate KYC OTP before continuing. Only present for accounts configured for Ripio KYC reuse via OTP.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ripio B2B API","description":"Ripio B2B APIs for crypto infrastructure and local stablecoins (wFiat) in Latin America: Crypto as a Service and the on/off-ramp Ramps API.","colors":{"primary":"#7908FF","light":"#7908FF","dark":"#7908FF"},"logo":{"light":"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_black.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=bdf337e5acb2526c20ade218091c4203","dark":"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_white.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=a68156b523e110deae3eaeb2feac1493"},"favicon":"https://mintcdn.com/ripio-9dfd4837/Z0ROxzVvVQCC2WDt/favicon.png?fit=max\u0026auto=format\u0026n=Z0ROxzVvVQCC2WDt\u0026q=85\u0026s=3763d7144291f35d0088536ef1aae78a","appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Register","href":"https://platform.ripio.com/register"}},"footer":{"socials":{"x":"https://x.com/ripiohq","instagram":"https://www.instagram.com/ripioapp","youtube":"https://www.youtube.com/Ripiotv","telegram":"https://t.me/+J7H4QmPlNIc2NDAx","linkedin":"https://ar.linkedin.com/company/ripio"}},"seo":{"organization":{"name":"Ripio","url":"https://www.ripio.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ripio-9dfd4837","hasAudioNarration":false,"actualSubdomain":"ripio-9dfd4837","customDomains":["docs.ripio.com"],"gitSource":{"type":"github","owner":"ripio","repo":"b2b-docs-mintlify","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff50467fb6886116681108","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Integration","count":167},{"language":"default","tag":"API Reference","count":151},{"language":"default","tag":"Ramps","count":111},{"language":"default","tag":"Crypto as a Service","count":95},{"language":"default","tag":"Overview","count":28},{"language":"default","tag":"Widget integration","count":16},{"language":"default","tag":"Crypto Widget","count":14},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"User flows","count":12},{"language":"default","tag":"Onchain Deposits \u0026 Withdrawals","count":11}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"site-roles","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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"ramps-api/kyc/submit-kyc-information","slug":"/ramps-api/kyc/submit-kyc-information","pageMetadata":{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/","title":"Submit KYC Information","description":"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider's widget for document uploads and liveness checks. Webhook events will notify about the validation process.\n\n**Production only:** The provider URL for document uploads and liveness checks only works in production.\n\n**Reusable KYC (Sumsub share token).** If the customer is already verified in your own Sumsub account, send their share token in `kycProviderShareToken` so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an **opt-in feature that must be enabled for your account by the Ripio team**; while it is disabled, sending the field returns `403` with the error code `20065` and no KYC is created. It also requires your Sumsub account to be paired with Ripio's as a sharing partner — see [Reusable KYC prerequisites](/ramps-api/kyc/reusable-kyc#prerequisites) before you integrate it.\n\nThis is separate from **Ripio KYC reuse via OTP**. If your account is configured for it, open the verification with [Start KYC](/ramps-api/kyc/start-kyc) first and confirm the OTP with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns `400` with the error code `20094` (`KycEmailOtpNotConfirmedException`). Accounts should be configured for one reuse mechanism or the other, not both.\n\n**The payload is validated before anything is created.** Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns `400` with error code `20000` and **no verification process is opened and no KYC is consumed** — correct the field and repeat the same call. The fields accepted and required differ per country: see [KYC fields by country](/ramps-api/kyc/kyc-fields-by-country).","href":"/ramps-api/kyc/submit-kyc-information"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider’s widget for document uploads and liveness checks. Webhook events will notify about the validation process.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Production only:\"\n }), \" The provider URL for document uploads and liveness checks only works in production.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Reusable KYC (Sumsub share token).\"\n }), \" If the customer is already verified in your own Sumsub account, send their share token in \", _jsx(_components.code, {\n children: \"kycProviderShareToken\"\n }), \" so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an \", _jsx(_components.strong, {\n children: \"opt-in feature that must be enabled for your account by the Ripio team\"\n }), \"; while it is disabled, sending the field returns \", _jsx(_components.code, {\n children: \"403\"\n }), \" with the error code \", _jsx(_components.code, {\n children: \"20065\"\n }), \" and no KYC is created. It also requires your Sumsub account to be paired with Ripio’s as a sharing partner — see \", _jsx(_components.a, {\n href: \"/ramps-api/kyc/reusable-kyc#prerequisites\",\n children: \"Reusable KYC prerequisites\"\n }), \" before you integrate it.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This is separate from \", _jsx(_components.strong, {\n children: \"Ripio KYC reuse via OTP\"\n }), \". If your account is configured for it, open the verification with \", _jsx(_components.a, {\n href: \"/ramps-api/kyc/start-kyc\",\n children: \"Start KYC\"\n }), \" first and confirm the OTP with \", _jsx(_components.a, {\n href: \"/ramps-api/kyc/validate-kyc-otp\",\n children: \"Validate KYC OTP\"\n }), \" — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns \", _jsx(_components.code, {\n children: \"400\"\n }), \" with the error code \", _jsx(_components.code, {\n children: \"20094\"\n }), \" (\", _jsx(_components.code, {\n children: \"KycEmailOtpNotConfirmedException\"\n }), \"). Accounts should be configured for one reuse mechanism or the other, not both.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"The payload is validated before anything is created.\"\n }), \" Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns \", _jsx(_components.code, {\n children: \"400\"\n }), \" with error code \", _jsx(_components.code, {\n children: \"20000\"\n }), \" and \", _jsx(_components.strong, {\n children: \"no verification process is opened and no KYC is consumed\"\n }), \" — correct the field and repeat the same call. The fields accepted and required differ per country: see \", _jsx(_components.a, {\n href: \"/ramps-api/kyc/kyc-fields-by-country\",\n children: \"KYC fields by country\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Note,Warning}=_components;if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`kycProviderShareToken`}),` belongs to `,_jsx(_components.strong,{children:`Reusable KYC (Sumsub share token)`}),`. It is separate from `,_jsx(_components.strong,{children:`Ripio KYC reuse via OTP`}),`, which uses `,_jsx(_components.a,{href:`/ramps-api/kyc/start-kyc`,children:`Start KYC`}),` and `,_jsx(_components.a,{href:`/ramps-api/kyc/validate-kyc-otp`,children:`Validate KYC OTP`}),`. If your account is configured for OTP reuse, this endpoint always requires `,_jsx(_components.code,{children:`kycSubmission`}),` — it cannot open that flow on its own. Calling it before the OTP is confirmed returns `,_jsx(_components.code,{children:`400`}),` with the error code `,_jsx(_components.code,{children:`20094`}),` (`,_jsx(_components.code,{children:`KycEmailOtpNotConfirmedException`}),`).`]}),_jsxs(_components.p,{children:[`For the `,_jsx(_components.strong,{children:`Partner-submitted (API)`}),` model, send `,_jsx(_components.code,{children:`kycProviderShareToken`}),` in `,_jsx(_components.a,{href:`/ramps-api/kyc/start-kyc`,children:`Start KYC`}),` instead — that’s the call that opens the verification, and where the token is redeemed. Sending it here has no effect for that model. This endpoint only accepts the token directly for the `,_jsx(_components.strong,{children:`Ripio-hosted (redirect)`}),` model, where it has no separate Start KYC call. See `,_jsx(_components.a,{href:`/ramps-api/kyc/reusable-kyc`,children:`Reusable KYC (Sumsub share token)`}),` for the full behavior per model.`]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Reusable KYC via Sumsub share token is an account-level opt-in. A share token by itself does not enable this flow: if the feature is not enabled for your account, sending `,_jsx(_components.code,{children:`kycProviderShareToken`}),` returns `,_jsx(_components.code,{children:`403`}),` with `,_jsx(_components.code,{children:`KycProviderTokenSharingNotEnabledException`}),` and no KYC is created.`]})})]})}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":{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/","title":"Submit KYC Information","description":"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider's widget for document uploads and liveness checks. Webhook events will notify about the validation process.\n\n**Production only:** The provider URL for document uploads and liveness checks only works in production.\n\n**Reusable KYC (Sumsub share token).** If the customer is already verified in your own Sumsub account, send their share token in `kycProviderShareToken` so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an **opt-in feature that must be enabled for your account by the Ripio team**; while it is disabled, sending the field returns `403` with the error code `20065` and no KYC is created. It also requires your Sumsub account to be paired with Ripio's as a sharing partner — see [Reusable KYC prerequisites](/ramps-api/kyc/reusable-kyc#prerequisites) before you integrate it.\n\nThis is separate from **Ripio KYC reuse via OTP**. If your account is configured for it, open the verification with [Start KYC](/ramps-api/kyc/start-kyc) first and confirm the OTP with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns `400` with the error code `20094` (`KycEmailOtpNotConfirmedException`). Accounts should be configured for one reuse mechanism or the other, not both.\n\n**The payload is validated before anything is created.** Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns `400` with error code `20000` and **no verification process is opened and no KYC is consumed** — correct the field and repeat the same call. The fields accepted and required differ per country: see [KYC fields by country](/ramps-api/kyc/kyc-fields-by-country).","href":"/ramps-api/kyc/submit-kyc-information"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ripio-9dfd4837/e90081465672ce62/seo-jsonld.js"],"openApiReferenceData":{"operation":{"summary":"Submit KYC Information","description":"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider's widget for document uploads and liveness checks. Webhook events will notify about the validation process.\n\n**Production only:** The provider URL for document uploads and liveness checks only works in production.\n\n**Reusable KYC (Sumsub share token).** If the customer is already verified in your own Sumsub account, send their share token in `kycProviderShareToken` so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an **opt-in feature that must be enabled for your account by the Ripio team**; while it is disabled, sending the field returns `403` with the error code `20065` and no KYC is created. It also requires your Sumsub account to be paired with Ripio's as a sharing partner — see [Reusable KYC prerequisites](/ramps-api/kyc/reusable-kyc#prerequisites) before you integrate it.\n\nThis is separate from **Ripio KYC reuse via OTP**. If your account is configured for it, open the verification with [Start KYC](/ramps-api/kyc/start-kyc) first and confirm the OTP with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns `400` with the error code `20094` (`KycEmailOtpNotConfirmedException`). Accounts should be configured for one reuse mechanism or the other, not both.\n\n**The payload is validated before anything is created.** Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns `400` with error code `20000` and **no verification process is opened and no KYC is consumed** — correct the field and repeat the same call. The fields accepted and required differ per country: see [KYC fields by country](/ramps-api/kyc/kyc-fields-by-country).","operationId":"submitKycInformation","tags":["KYC"],"parameters":["48ced1b7-7562-4df9-b95a-e1cb8d1606d3","a729a26d-72e4-42e2-80d6-4c804c31e786","d7dab078-1b96-40fb-9f24-d6fa8b10a031","f73f7a9c-cc45-465b-8d87-e9004f618773"],"requestBody":"9c2cb73f-ceae-4ce4-82d8-4d8eb002b104","responses":{"200":"3a097b11-de28-439f-8b0a-9777bc04c82c","201":"cdac8e58-a948-4ca3-8ced-d629263b64bb","400":"f0ecb2f4-fd0e-49aa-96b1-5f5a2d9c4895","401":"9701fd0d-01df-40d5-8002-6f6a13bf2351","403":"edec3a50-1863-42ed-bc10-8ccd58116ce7","404":"6ca874be-ec27-4c29-b59d-134fcc87f839"},"method":"post","type":"path","servers":["6447d3c6-dd4a-4999-adb1-97ae285a6408","8ee58e10-8bb3-4dca-9fb7-4363a852ef91"],"security":["686a544d-e6b8-4128-865f-d9f41f789091"],"path":"/api/v1/customers/{customerId}/kyc/","baseUrlOptions":["https://skala-sandbox.ripio.com","https://skala.ripio.com"],"title":"Submit KYC Information","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"48ced1b7-7562-4df9-b95a-e1cb8d1606d3":{"name":"customerId","in":"path","required":true,"description":"Unique identifier for the customer.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Unique identifier for the customer.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"example":"8142b065-79c4-4f48-9e33-11b17bc658d4"},"a729a26d-72e4-42e2-80d6-4c804c31e786":{"name":"X-Ripio-User-Ip","in":"header","required":false,"description":"Optional. The public IP address of the **end user's device** (IPv4 or IPv6), captured on your frontend and forwarded by your backend — never your server's own address. Used for traceability and fraud prevention. An address that is not a valid IPv4 or IPv6 discards the end-user context of the request, without failing it. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","schema":{"type":"string","maxLength":45,"isRequired":false,"description":"Optional. The public IP address of the **end user's device** (IPv4 or IPv6), captured on your frontend and forwarded by your backend — never your server's own address. Used for traceability and fraud prevention. An address that is not a valid IPv4 or IPv6 discards the end-user context of the request, without failing it. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","uniqueKey":"","typeLabel":"string"},"example":"203.0.113.24"},"d7dab078-1b96-40fb-9f24-d6fa8b10a031":{"name":"X-Ripio-User-Agent","in":"header","required":false,"description":"Optional. The `User-Agent` of the **end user's browser or app**, not your backend's HTTP client. Longer values are truncated to 500 characters. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","schema":{"type":"string","maxLength":500,"isRequired":false,"description":"Optional. The `User-Agent` of the **end user's browser or app**, not your backend's HTTP client. Longer values are truncated to 500 characters. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","uniqueKey":"","typeLabel":"string"},"example":"Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"},"f73f7a9c-cc45-465b-8d87-e9004f618773":{"name":"X-Ripio-User-Device-Id","in":"header","required":false,"description":"Optional. A stable identifier of the **end user's device**, as your app or frontend defines it. Longer values are truncated to 200 characters. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","schema":{"type":"string","maxLength":200,"isRequired":false,"description":"Optional. A stable identifier of the **end user's device**, as your app or frontend defines it. Longer values are truncated to 200 characters. See [Forwarding end-user context](/ramps-api/guides/end-user-context).","uniqueKey":"","typeLabel":"string"},"example":"8d3f2c1a-6b7e-4f9a-a1d2-3c4b5e6f7a8b"}},"requestBody":{"required":true,"description":"KYC data for the customer. Structure should align with fields from /kycRequirements/.","content":{"application/json":{"schema":{"type":"object","description":"Request body for KYC submission. Use `kycSubmission` + `redirectUrl` for the standard API flow, or only `redirectUrl` for the Ripio KYC delegated flow. If your account is enabled for Reusable KYC (Sumsub share token), you can add `kycProviderShareToken` to reuse a verification the customer already completed in your own Sumsub account. This is separate from Ripio KYC reuse via OTP: if your account is configured for it, open the verification with [Start KYC](/ramps-api/kyc/start-kyc) first and confirm the OTP with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns `400` with the error code `20094` (`KycEmailOtpNotConfirmedException`).","properties":{"kycSubmission":{"type":"object","description":"Customer KYC data. **Which fields are accepted, and which are required, depends on `country`** — the four countries have four different schemas, so the `required` list below is only their intersection. Each field's description states its per-country requiredness.\n\nSee [KYC fields by country](/ramps-api/kyc/kyc-fields-by-country) for the full matrix and the cross-field rules, and call [`/kycRequirements/`](/ramps-api/kyc/retrieve-kyc-requirements) for the live catalogs of the `CHOICE` fields. Not required when using the Ripio KYC delegated flow.","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code: `AR`, `BR`, `MX` or `CO`. **Required for every country** — it selects the schema the rest of the payload is validated against.","example":"AR","isRequired":true,"uniqueKey":"kycSubmission.country","typeLabel":"string"},"first_name":{"type":"string","maxLength":64,"description":"Required for every country. The approved name associates operations with the customer's verified identity.","example":"Mateo","isRequired":true,"uniqueKey":"kycSubmission.first_name","typeLabel":"string"},"last_name":{"type":"string","maxLength":64,"description":"Required for every country. The approved name associates operations with the customer's verified identity.","example":"Romero","isRequired":true,"uniqueKey":"kycSubmission.last_name","typeLabel":"string"},"id_number":{"type":"string","description":"Document number — the format depends on the country. **AR** (required): 7 or 8 digits, no dots or spaces. **BR** (required): a CPF (11 digits) or CNPJ (14 digits); the check digits are verified and separators are accepted and stripped, so `123.456.789-09` is valid. The approved document binds PIX operations to the verified customer and is used to verify destination account ownership. **MX** (required): a CURP. **CO** (required): digits, with a length that depends on `id_number_type` — `CC` 7 to 10, `CE` 6 or 7, `PPT` 6 to 15; punctuation is ignored.","example":"11122233","isRequired":true,"uniqueKey":"kycSubmission.id_number","typeLabel":"string"},"address":{"type":"string","maxLength":255,"description":"Street name. **Required for AR, MX and CO**; optional for BR.","example":"Libertad","isRequired":true,"uniqueKey":"kycSubmission.address","typeLabel":"string"},"city":{"type":"string","maxLength":64,"description":"**AR, BR, MX**: free text (required). **CO**: the city's **DANE code**, not its name — `11001`, not `Bogotá` — and it must belong to the department declared in `state`. The CO codes are listed under `city` in `/kycRequirements/`.","example":"Trelew","isRequired":true,"uniqueKey":"kycSubmission.city","typeLabel":"string"},"state":{"type":"string","description":"State / province / department, as the country-prefixed code from `/kycRequirements/` (`AR.CH`, `BR.SP`, `MX.JA`, `CO.DC`). The bare code is also accepted and prefixed for you (`SP` → `BR.SP`). **Labels are rejected**: send `AR.BA`, not `Buenos Aires`. Required in every country.","example":"AR.CH","isRequired":true,"uniqueKey":"kycSubmission.state","typeLabel":"string"},"phone":{"type":"string","description":"Phone number in E.164 format: the `+` and the country code are required. Separators (spaces, dashes, parentheses) are accepted and stripped, so `+54 (11) 2345-6789` is valid. A national-format number such as `1123456789` is rejected — the country code is never inferred. Required in every country.","example":"+542211228855","isRequired":true,"uniqueKey":"kycSubmission.phone","typeLabel":"string"},"gender":{"type":"string","description":"`F` or `M`, case-insensitive. **Required for AR**, optional for BR and MX, **not accepted for CO**.","example":"M","uniqueKey":"kycSubmission.gender","typeLabel":"string"},"birthday":{"type":"string","format":"date","description":"Date of birth, as `YYYY-MM-DD` or `DD/MM/YYYY`. The customer must be at least 18 and at most 120 years old, and the date cannot be in the future. **Required for AR, MX and CO**; optional for BR.","example":"1990-01-25","uniqueKey":"kycSubmission.birthday","typeLabel":"string\u003cdate>"},"nationality":{"type":"string","description":"ISO 3166-1 alpha-2 code, case-insensitive — `AR`, not `ARG` nor `Argentina`. Not restricted to the four operating countries, but **not every ISO code is accepted**: sixteen current codes are refused (`AX`, `BL`, `BQ`, `CD`, `CW`, `GG`, `IM`, `JE`, `ME`, `MF`, `MK`, `PS`, `RS`, `SS`, `SX`, `TL`) because the identity provider's own list predates the 2006 ISO revision. **Required for AR, MX and CO**; optional for BR.","example":"AR","uniqueKey":"kycSubmission.nationality","typeLabel":"string"},"id_number_type":{"type":"string","description":"Document type, case-insensitive. The catalog differs by country: **AR** `DNI`, `R_P`, `OTHER` (optional, defaults to `DNI`); **BR** `CPF`, `CNPJ` (**required**); **CO** `CC`, `CE`, `PPT` (**required**). Not accepted for MX. Omit the field rather than sending `\"\"` or `null` where it is optional — both are rejected.","example":"DNI","uniqueKey":"kycSubmission.id_number_type","typeLabel":"string"},"cuit":{"type":"string","description":"Argentine tax ID. **AR only, required.** 11 digits with a valid modulus-11 check digit; separators are accepted and stripped, so `20-38804362-9` is valid. Pass the customer's CUIL when `registered_tax_payer` is `false` (individual), or their CUIT when it is `true` (registered taxpayer).","example":"20388043629","uniqueKey":"kycSubmission.cuit","typeLabel":"string"},"registered_tax_payer":{"type":"boolean","description":"Whether the customer is a registered taxpayer (*responsable inscripto*). **AR only, required.**","example":false,"uniqueKey":"kycSubmission.registered_tax_payer","typeLabel":"boolean"},"rfc":{"type":"string","description":"Mexican tax ID. **MX only, required.** Normalized (upper-cased, separators stripped), then checked: 3 or 4 letters, 6 digits and an optional homoclave of up to 5 characters, so both `HZDT240502GRA` and `HZDT240502` are valid.","example":"LOJO951119Q18","uniqueKey":"kycSubmission.rfc","typeLabel":"string"},"address_number":{"type":"string","maxLength":32,"description":"Street number. **Required for AR, MX and CO**; optional for BR.","example":"333","uniqueKey":"kycSubmission.address_number","typeLabel":"string"},"address_flat":{"type":"string","maxLength":255,"description":"Apartment / unit. Optional in every country.","example":"4B","uniqueKey":"kycSubmission.address_flat","typeLabel":"string"},"address_type":{"type":"string","description":"Type of dwelling: `SUIT` (apartment), `HOME` (house) or `UNIT`. Case-insensitive. **CO only, required.**","example":"HOME","uniqueKey":"kycSubmission.address_type","typeLabel":"string"},"postal_code":{"type":"string","maxLength":32,"description":"**AR** (required): a CP (`1012`) or a CPA (`B1665DQJ`); case and separators are forgiven, so `B1665 DQJ` is valid; the short form `B1665` is refused. **BR** (required): a CEP of 8 digits; `01310-100` is accepted and stored as `01310100`. **MX** (required): free text, not format-checked. Not accepted for CO.","example":"1012","uniqueKey":"kycSubmission.postal_code","typeLabel":"string"},"district":{"type":"string","maxLength":40,"description":"Neighbourhood or district. **Required for MX and CO**, optional for BR, **not accepted for AR**.","example":"Chapinero","uniqueKey":"kycSubmission.district","typeLabel":"string"},"personal_activity":{"type":"string","description":"Occupation code from `/kycRequirements/`. **Required for MX**; for **AR** it is published as required and validated when present, but a payload that omits it is still accepted today. Not accepted for BR or CO. AR and MX use different catalogs (`AR.1`…`AR.6` and `MX.1`, `MX.1000000`, …). The bare code is prefixed for you.","example":"AR.1","uniqueKey":"kycSubmission.personal_activity","typeLabel":"string"},"personal_activity_other":{"type":"string","description":"The detailed activity, as a code from the `personal_activity_other` catalog in `/kycRequirements/` (`AR.1`…`AR.64`) — **not free text**. **AR only**, and **required when `personal_activity` is `AR.3` (Monotributista) or `AR.4` (Autónomo)**; optional otherwise.\n\nNote this is a *different* catalog from `personal_activity`, and their values overlap: `AR.3` means \"Monotributista\" in one and something unrelated in the other. Read each list from its own entry in `/kycRequirements/`.","example":"AR.64","uniqueKey":"kycSubmission.personal_activity_other","typeLabel":"string"},"net_income":{"type":"string","description":"Annual net income **as a bracket code, not an amount**. **AR**: `AR.A`…`AR.F` — published as required and validated when present, but a payload that omits it is still accepted today. **BR** (required): `BR.A`, `BR.B` or `BR.C`. Not accepted for MX or CO. The labels for each bracket come from `/kycRequirements/`; the bare code (`A`) is prefixed for you.","example":"AR.A","uniqueKey":"kycSubmission.net_income","typeLabel":"string"},"birthday_place":{"type":"string","description":"Country of birth, as an **ISO 3166-1 alpha-2 code** — the same vocabulary as `nationality`. **MX only, required.** A city name such as `Guadalajara` is rejected.","example":"MX","uniqueKey":"kycSubmission.birthday_place","typeLabel":"string"},"date_of_issue":{"type":"string","format":"date","description":"ID issue date, as `YYYY-MM-DD` or `DD/MM/YYYY`. Cannot be in the future. **MX only, required.**","example":"2020-01-01","uniqueKey":"kycSubmission.date_of_issue","typeLabel":"string\u003cdate>"},"date_of_expiration":{"type":"string","format":"date","description":"ID expiration date, as `YYYY-MM-DD` or `DD/MM/YYYY`. Must be **strictly later** than `date_of_issue`. An already-expired document is accepted — whether it disqualifies the customer is decided by the KYC provider. **MX only, required.**","example":"2030-01-01","uniqueKey":"kycSubmission.date_of_expiration","typeLabel":"string\u003cdate>"},"terms_conditions":{"type":"boolean","description":"Acceptance of terms and conditions. **MX only, required.**","example":true,"uniqueKey":"kycSubmission.terms_conditions","typeLabel":"boolean"},"address_photo":{"type":"string","format":"byte","description":"Proof of address as a base64-encoded image (JPEG or PNG, max 5 MB). **MX only.** Required only for accounts configured for the Ripio-provider widget flow; optional otherwise.","example":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...","uniqueKey":"kycSubmission.address_photo","typeLabel":"string\u003cbyte>"}},"required":["country","first_name","last_name","id_number","address","city","state","phone"],"uniqueKey":"kycSubmission","typeLabel":"object"},"redirectUrl":{"type":"string","format":"uri","description":"URL to redirect the user after completing the KYC flow. Required for the Ripio KYC delegated flow; optional for the API flow.","example":"https://www.example.com/","uniqueKey":"redirectUrl","typeLabel":"string\u003curi>"},"kycProviderShareToken":{"type":"string","maxLength":2000,"description":"Optional. Sumsub share token for a customer already verified in your own Sumsub account (reusable KYC). Ripio redeems it so that, when both verifications are compatible, the customer does not have to upload documents or repeat the liveness check. On this endpoint, it only takes effect for the Ripio KYC delegated flow (no `kycSubmission`, only `redirectUrl`). For the API flow, send it on [Start KYC](/ramps-api/kyc/start-kyc) instead — that is the call that opens the verification for that flow, and sending it here has no effect.\n\n**Two prerequisites must be met before this field does anything.** First, reusable KYC is an opt-in feature that must be enabled for your account by the Ripio team: while it is disabled, sending this field returns `403` with the error code `20065` (`KycProviderTokenSharingNotEnabledException`) and no KYC is created. Second, your Sumsub account must be paired with Ripio's as a sharing partner — you add the partner token Ripio gives you under *Reusable identity → Partners → Recipients → Add recipient* in your Sumsub dashboard; without that pairing, the tokens you generate are rejected when Ripio tries to redeem them. See [Reusable KYC prerequisites](/ramps-api/kyc/reusable-kyc#prerequisites) and Sumsub's [Add recipient](https://docs.sumsub.com/docs/manage-sharing-partners#add-recipient).\n\nGenerate the token with Sumsub's [Generate share token](https://docs.sumsub.com/reference/generate-share-token) endpoint, using the customer's `applicantId` and `forClientId` set to Ripio's Sumsub client ID.\n\nReuse is subject to Sumsub's compatibility rules: only the verification steps that overlap between your level and Ripio's are transferred, and the shared documents are re-checked against Ripio's requirements. When the levels have no matching steps, or a re-check fails, the customer is asked to complete the missing steps — see Sumsub's [Reusable KYC share](https://docs.sumsub.com/docs/reusable-kyc-share) documentation.\n\nShare tokens are short-lived and single-use: generate a fresh token right before each call to this endpoint. The token is only used when a new verification process is opened — if a verification is already in progress for the customer, the response is idempotent and the token is ignored.","uniqueKey":"kycProviderShareToken","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Argentina":{"title":"Argentina","summary":"Argentina","description":"Every field Argentina requires. `personal_activity_other` is omitted because `AR.1` (Empleado del Sector Privado) does not require it — see the Argentina (monotributista) example for the case that does.","value":{"kycSubmission":{"country":"AR","first_name":"Mateo","last_name":"Romero","gender":"M","birthday":"1990-01-25","nationality":"AR","id_number":"11122233","id_number_type":"DNI","address":"Libertad","address_number":"333","address_flat":"4B","postal_code":"B1665DQJ","city":"San Miguel","state":"AR.BA","phone":"+542211228855","registered_tax_payer":false,"cuit":"20388043629","net_income":"AR.A","personal_activity":"AR.1"},"redirectUrl":"https://www.example.com/"}},"ArgentinaMonotributista":{"title":"ArgentinaMonotributista","summary":"Argentina (monotributista / autónomo)","description":"When `personal_activity` is `AR.3` or `AR.4`, `personal_activity_other` becomes required and must be a code from its own catalog.","value":{"kycSubmission":{"country":"AR","first_name":"Mateo","last_name":"Romero","gender":"M","birthday":"1990-01-25","nationality":"AR","id_number":"11122233","id_number_type":"DNI","address":"Libertad","address_number":"333","address_flat":"4B","postal_code":"B1665DQJ","city":"San Miguel","state":"AR.BA","phone":"+542211228855","registered_tax_payer":false,"cuit":"20388043629","net_income":"AR.A","personal_activity":"AR.3","personal_activity_other":"AR.64"},"redirectUrl":"https://www.example.com/"}},"Brazil":{"title":"Brazil","summary":"Brazil","description":"Brazil requires `first_name`, `last_name`, `id_number`, `id_number_type`, `country`, `address`, `city`, `state`, `postal_code`, `phone` and `net_income`. The approved identity binds PIX operations to the verified customer and is used for destination account ownership checks.","value":{"kycSubmission":{"country":"BR","first_name":"João","last_name":"Silva","birthday":"1990-06-15","nationality":"BR","gender":"M","id_number":"12345678909","id_number_type":"CPF","address":"Rua das Flores","address_number":"100","address_flat":"Apto 42","district":"Bela Vista","postal_code":"01310100","city":"São Paulo","state":"BR.SP","phone":"+5511999990000","net_income":"BR.A"},"redirectUrl":"https://www.example.com/"}},"Mexico":{"title":"Mexico","summary":"Mexico","value":{"kycSubmission":{"country":"MX","first_name":"Erick Eduardo","last_name":"Cuellar Garcia","birthday":"1998-12-11","nationality":"MX","birthday_place":"MX","id_number":"CUGE981211HJCLRR06","rfc":"HZDT240502GRA","date_of_issue":"2020-01-01","date_of_expiration":"2030-01-01","address":"Isla Cartagena","address_number":"123","address_flat":"4","district":"Jalisco","postal_code":"44950","city":"Guadalajara","state":"MX.JA","phone":"+523325606411","personal_activity":"MX.1000000","terms_conditions":true},"redirectUrl":"https://www.example.com/"}},"Colombia":{"title":"Colombia","summary":"Colombia","description":"Note `city` is the DANE code (`11001` = Bogotá D.C.), not the city name, and it must belong to the department in `state`.","value":{"kycSubmission":{"country":"CO","first_name":"Santiago","last_name":"García","birthday":"1992-05-15","nationality":"CO","id_number":"1234567890","id_number_type":"CC","address":"Carrera 7","address_number":"45","address_type":"HOME","district":"Chapinero","city":"11001","state":"CO.DC","phone":"+573001234567"},"redirectUrl":"https://www.example.com/"}},"RipioKyc":{"title":"RipioKyc","summary":"Ripio KYC delegated flow","description":"Used when the account is configured for the Ripio KYC delegated flow. KYC data is not collected directly — the user is redirected to Ripio's KYC platform to complete the process.","value":{"redirectUrl":"https://www.example.com/"}},"ReusableKyc":{"title":"ReusableKyc","summary":"Reusable KYC (Sumsub share token)","description":"Used when the customer is already verified in your own Sumsub account. Ripio redeems the share token so the customer skips document upload and liveness check. Requires the reusable KYC feature to be enabled for your account by the Ripio team; otherwise the request returns 403 with code 20065. The token can also be sent alongside a full `kycSubmission` body.","value":{"redirectUrl":"https://www.example.com/","kycProviderShareToken":"_act-jwt-eyJhbGciOiJub25lIn0..."}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"3a097b11-de28-439f-8b0a-9777bc04c82c":{"description":"KYC submission received successfully. Includes providerUrl for document upload and liveness check.","content":{"application/json":{"schema":{"type":"object","properties":{"submissionId":{"type":"string","format":"uuid","description":"Unique identifier for the submitted KYC data.","isRequired":true,"uniqueKey":"submissionId","typeLabel":"string\u003cuuid>"},"createdAt":{"type":"string","format":"date-time","description":"Date and time the KYC submission was created (UTC format).","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"providerUrl":{"type":"string","format":"url","description":"Points to a third-party KYC provider's widget to handle file uploads and liveness checks. Only available in production.","isRequired":true,"uniqueKey":"providerUrl","typeLabel":"string\u003curl>"},"otpRequired":{"type":"boolean","description":"Whether the OTP sent to the customer's email still needs to be validated with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) before continuing. Only present for accounts configured for Ripio KYC reuse via OTP.","uniqueKey":"otpRequired","typeLabel":"boolean"}},"required":["submissionId","createdAt","providerUrl"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"submissionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","createdAt":"2023-11-07T05:31:56Z","providerUrl":"\u003cstring>","otpRequired":true}}},"exampleType":"generated"}},"exampleType":"generated"},"cdac8e58-a948-4ca3-8ced-d629263b64bb":{"description":"KYC submission received successfully (alternative success code, as per PDF example for other POSTs). Includes providerUrl for document upload and liveness check.","content":{"application/json":{"schema":{"type":"object","properties":{"submissionId":{"type":"string","format":"uuid","description":"Unique identifier for the submitted KYC data.","isRequired":true,"uniqueKey":"submissionId","typeLabel":"string\u003cuuid>"},"createdAt":{"type":"string","format":"date-time","description":"Date and time the KYC submission was created (UTC format).","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"providerUrl":{"type":"string","format":"url","description":"Points to a third-party KYC provider's widget to handle file uploads and liveness checks. Only available in production.","isRequired":true,"uniqueKey":"providerUrl","typeLabel":"string\u003curl>"},"otpRequired":{"type":"boolean","description":"Whether the OTP sent to the customer's email still needs to be validated with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) before continuing. Only present for accounts configured for Ripio KYC reuse via OTP.","uniqueKey":"otpRequired","typeLabel":"boolean"}},"required":["submissionId","createdAt","providerUrl"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"submissionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","createdAt":"2023-11-07T05:31:56Z","providerUrl":"\u003cstring>","otpRequired":true}}},"exampleType":"generated"}},"exampleType":"generated"},"f0ecb2f4-fd0e-49aa-96b1-5f5a2d9c4895":{"description":"Bad Request — the payload failed validation (`20000`), or the customer is not in a state that allows a new submission. A `20000` means nothing was created. A `20039` means the customer has not accepted the active Terms and Conditions — the submission is refused before any KYC work starts.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Application-specific error code.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Type of error or exception.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message.","uniqueKey":"detail.oneOf.0.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"object"},{"type":"array","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message."}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"array"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"object | array"},"status":{"type":"integer","description":"HTTP status code.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["code","type","detail","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"validationError":{"title":"validationError","summary":"A field failed validation (nothing was created)","description":"The offending fields are nested under `kycSubmission`, keyed by field name. Each entry carries a human-readable `message` and a stable `code` you can branch on.","value":{"code":20000,"type":"ValidationError","detail":{"kycSubmission":{"phone":[{"message":"Enter the phone in E.164 format, including the country code (e.g. +5491123456789).","code":"invalid_phone"}]}},"status":400}},"missingRequiredField":{"title":"missingRequiredField","summary":"A field required for this country is missing","value":{"code":20000,"type":"ValidationError","detail":{"kycSubmission":{"net_income":[{"message":"This field is required.","code":"required"}]}},"status":400}},"invalidChoice":{"title":"invalidChoice","summary":"A catalog field received a label instead of its code","description":"`state`, `net_income`, `personal_activity`, `id_number_type` and `address_type` accept only the `value` from `/kycRequirements/`, never the `label`.","value":{"code":20000,"type":"ValidationError","detail":{"kycSubmission":{"state":[{"message":"\"Buenos Aires\" is not a valid choice.","code":"invalid_choice"}]}},"status":400}},"mutuallyExclusiveReuseModes":{"title":"mutuallyExclusiveReuseModes","summary":"Ripio KYC reuse and Sumsub share-token reuse cannot be combined","description":"Use either Ripio KYC reuse via OTP or Reusable KYC via Sumsub share token, according to your account configuration.","value":{"code":20000,"type":"ValidationError","detail":{"non_field_errors":[{"message":"reuseRipioKyc and kycProviderShareToken are mutually exclusive.","code":"invalid"}]},"status":400}},"termsNotAccepted":{"title":"termsNotAccepted","summary":"The active Terms and Conditions have not been accepted (20039)","description":"Terms and Conditions are versioned per country and only the active version counts: a customer who accepted an earlier version is refused here until they accept the current one. Send them back through the acceptance flow — see [Terms and Conditions](/ramps-api/terms-and-conditions/introduction).","value":{"code":20039,"type":"TermsAndConditionsNotAcceptedException","detail":{"message":"Customer '3fa85f64-5717-4562-b3fc-2c963f66afa6' has not accepted the current Terms and Conditions."},"status":400}},"otpNotConfirmed":{"title":"otpNotConfirmed","summary":"The email OTP must be confirmed before sending KYC data (20094)","description":"Applies to accounts configured for Ripio KYC reuse via OTP. Confirm the OTP with Validate KYC OTP before calling this endpoint.","value":{"code":20094,"type":"KycEmailOtpNotConfirmedException","detail":{"message":"The email OTP must be validated before submitting KYC data."},"status":400}}},"exampleType":"examples"}},"exampleType":"examples"},"9701fd0d-01df-40d5-8002-6f6a13bf2351":{"description":"Unauthorized - Invalid or missing access token.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Application-specific error code.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Type of error or exception.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message.","uniqueKey":"detail.oneOf.0.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"object"},{"type":"array","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message."}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"array"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"object | array"},"status":{"type":"integer","description":"HTTP status code.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["code","type","detail","status"],"uniqueKey":"","typeLabel":"object"},"example":{"code":40001,"type":"NotAuthenticated","detail":{"message":"Authentication credentials were not provided.","code":"not_authenticated"},"status":401},"examples":{"Example":{"title":"Example","value":{"code":40001,"type":"NotAuthenticated","detail":{"message":"Authentication credentials were not provided.","code":"not_authenticated"},"status":401}}},"exampleType":"examples"}},"exampleType":"examples"},"edec3a50-1863-42ed-bc10-8ccd58116ce7":{"description":"Forbidden - a `kycProviderShareToken` was sent but reusable KYC is not enabled for your account. No KYC is created. Contact the Ripio team to enable this feature, or retry without the field to run a standard KYC.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Application-specific error code.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Type of error or exception.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message.","uniqueKey":"detail.oneOf.0.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"object"},{"type":"array","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message."}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"array"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"object | array"},"status":{"type":"integer","description":"HTTP status code.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["code","type","detail","status"],"uniqueKey":"","typeLabel":"object"},"example":{"code":20065,"type":"KycProviderTokenSharingNotEnabledException","detail":{"message":"KYC provider token sharing is not enabled for this account."},"status":403},"examples":{"Example":{"title":"Example","value":{"code":20065,"type":"KycProviderTokenSharingNotEnabledException","detail":{"message":"KYC provider token sharing is not enabled for this account."},"status":403}}},"exampleType":"examples"}},"exampleType":"examples"},"6ca874be-ec27-4c29-b59d-134fcc87f839":{"description":"Not Found - Customer not found or inactive.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"Application-specific error code.","isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Type of error or exception.","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message.","uniqueKey":"detail.oneOf.0.message","typeLabel":"string"}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"object"},{"type":"array","description":"Error details. The shape depends on the error:\n\n- Most business errors return an object with a `message` key.\n- Field validation errors return an object keyed by field name, each holding an array of `{ message, code }`.\n- Request-level validation errors (e.g. a missing query parameter) return a bare array of `{ message, code }`.","properties":{"message":{"type":"string","description":"Detailed error message."}},"additionalProperties":true,"isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"array"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"object | array"},"status":{"type":"integer","description":"HTTP status code.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"}},"required":["code","type","detail","status"],"uniqueKey":"","typeLabel":"object"},"example":{"code":40004,"type":"NotFound","detail":{"message":"Not found.","code":"not_found"},"status":404},"examples":{"Example":{"title":"Example","value":{"code":40004,"type":"NotFound","detail":{"message":"Not found.","code":"not_found"},"status":404}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"686a544d-e6b8-4128-865f-d9f41f789091":{"BearerToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token obtained via [/oauth2/token/](/ramps-api/authentication/acquire-access-token). Use as `Authorization: Bearer \u003caccess_token>`.","scopes":[],"schemeName":"BearerToken"}}},"servers":{"6447d3c6-dd4a-4999-adb1-97ae285a6408":{"url":"https://skala-sandbox.ripio.com","description":"Sandbox environment"},"8ee58e10-8bb3-4dca-9fb7-4363a852ef91":{"url":"https://skala.ripio.com","description":"Production environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Access token obtained via [/oauth2/token/](/ramps-api/authentication/acquire-access-token). Use as `Authorization: Bearer \u003caccess_token>`.","scopes":[],"schemeName":"BearerToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Access token obtained via [/oauth2/token/](/ramps-api/authentication/acquire-access-token). Use as `Authorization: Bearer \u003caccess_token>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerToken","name":"Authorization"}],"title":"BearerToken"}]},"originalFileLocation":"ramps-api/openapi.json"},"subdomain":"ripio-9dfd4837","siteName":"Ripio B2B API","title":"Submit KYC Information - Ripio B2B API","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T18:11:31.419Z","originalFileLocation":"ramps-api/kyc/submit-kyc-information.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider\u0026#x27;s widget for document uploads and liveness checks. Webhook events will notify about the validation process. Production only: The provider URL for document uploads and liveness checks only works in production. Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio\u0026#x27;s as a sharing partner — see Reusable KYC prerequisites before you integrate it. This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both. The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ripio B2B API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit KYC Information - Ripio B2B API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider\u0026#x27;s widget for document uploads and liveness checks. Webhook events will notify about the validation process. Production only: The provider URL for document uploads and liveness checks only works in production. Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio\u0026#x27;s as a sharing partner — see Reusable KYC prerequisites before you integrate it. This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both. The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ripio B2B API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ripio-9dfd4837.mintlify.site/_mintlify/api/og/v2?division=KYC\u0026amp;title=Submit+KYC+Information\u0026amp;description=Submits+KYC+data+for+a+specific+customer.+The+response+will+include+a+URL+to+a+third-party+KYC+provider%27s+widget+for+document+uploads+and+liveness+checks.+Webho\u0026amp;theme=78128f9583fb0593c455d352\u0026amp;signature=55b6541b202cef5a54f05f10055ec491072287219b67b73f067710ebb31fd2e7\">\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=\"Submit KYC Information - Ripio B2B API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider\u0026#x27;s widget for document uploads and liveness checks. Webhook events will notify about the validation process. Production only: The provider URL for document uploads and liveness checks only works in production. Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio\u0026#x27;s as a sharing partner — see Reusable KYC prerequisites before you integrate it. This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both. The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ripio-9dfd4837.mintlify.site/_mintlify/api/og/v2?division=KYC\u0026amp;title=Submit+KYC+Information\u0026amp;description=Submits+KYC+data+for+a+specific+customer.+The+response+will+include+a+URL+to+a+third-party+KYC+provider%27s+widget+for+document+uploads+and+liveness+checks.+Webho\u0026amp;theme=78128f9583fb0593c455d352\u0026amp;signature=55b6541b202cef5a54f05f10055ec491072287219b67b73f067710ebb31fd2e7\">\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/ripio-9dfd4837/LamC5PTKz6kdbzZa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ripio B2B API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7908FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ramps-api/kyc/submit-kyc-information.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.ripio.com/#organization\",\"name\":\"Ripio\",\"url\":\"https://www.ripio.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ripio-9dfd4837/wCKCU-escYLNlxWQ/logo/logo_black.svg?fit=max\u0026auto=format\u0026n=wCKCU-escYLNlxWQ\u0026q=85\u0026s=bdf337e5acb2526c20ade218091c4203\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ripio.com#website\",\"name\":\"Ripio B2B API\",\"url\":\"https://docs.ripio.com\",\"publisher\":{\"@id\":\"https://www.ripio.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information#webpage\",\"url\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information\",\"name\":\"Submit KYC Information\",\"description\":\"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider's widget for document uploads and liveness checks. Webhook events will notify about the validation process. Production only: The provider URL for document uploads and liveness checks only works in production. Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio's as a sharing partner — see Reusable KYC prerequisites before you integrate it. This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both. The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.\",\"dateModified\":\"2026-09-30T18:11:31.419Z\",\"isPartOf\":{\"@id\":\"https://docs.ripio.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Integration\",\"item\":\"https://docs.ripio.com/ramps-api/kyc/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.ripio.com/ramps-api/authentication/acquire-access-token\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"KYC\",\"item\":\"https://docs.ripio.com/ramps-api/kyc/retrieve-kyc-requirements\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Submit KYC Information\",\"item\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information#apireference\",\"headline\":\"Submit KYC Information\",\"name\":\"Submit KYC Information\",\"description\":\"Submits KYC data for a specific customer. The response will include a URL to a third-party KYC provider's widget for document uploads and liveness checks. Webhook events will notify about the validation process. Production only: The provider URL for document uploads and liveness checks only works in production. Reusable KYC (Sumsub share token). If the customer is already verified in your own Sumsub account, send their share token in kycProviderShareToken so Ripio redeems the existing verification instead of asking the customer to upload documents again. This is an opt-in feature that must be enabled for your account by the Ripio team; while it is disabled, sending the field returns 403 with the error code 20065 and no KYC is created. It also requires your Sumsub account to be paired with Ripio's as a sharing partner — see Reusable KYC prerequisites before you integrate it. This is separate from Ripio KYC reuse via OTP. If your account is configured for it, open the verification with Start KYC first and confirm the OTP with Validate KYC OTP — this endpoint cannot open that flow on its own, and calling it before the OTP is confirmed returns 400 with the error code 20094 (KycEmailOtpNotConfirmedException). Accounts should be configured for one reuse mechanism or the other, not both. The payload is validated before anything is created. Formats, catalog values and cross-field rules are checked at the boundary, so a malformed field returns 400 with error code 20000 and no verification process is opened and no KYC is consumed — correct the field and repeat the same call. The fields accepted and required differ per country: see KYC fields by country.\",\"url\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ripio.com/ramps-api/kyc/submit-kyc-information#webpage\"},\"dateModified\":\"2026-09-30T18:11:31.419Z\",\"publisher\":{\"@id\":\"https://www.ripio.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ripio.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ripio B2B API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ripio\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ramps-api/kyc/submit-kyc-information.md","siteName":"Ripio B2B API","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":""}]},{"tab":"Crypto as a Service","pages":[{"title":"Crypto as a Service","href":"/crypto-as-a-service/overview/introduction"}]},{"tab":"Ramps","groups":[{"group":"Overview","pages":[{"title":"Ripio Ramps API: On-Ramp \u0026 Off-Ramp Integration for Partners","sidebarTitle":"Introduction","href":"/ramps-api/overview/introduction"},{"title":"Choose your integration","href":"/ramps-api/overview/choose-your-integration"},{"group":"Countries \u0026 payment methods","pages":[{"title":"Countries \u0026 payment methods","sidebarTitle":"Overview","href":"/ramps-api/overview/countries/overview"},{"title":"Argentina","href":"/ramps-api/overview/countries/argentina"},{"title":"Mexico","href":"/ramps-api/overview/countries/mexico"},{"title":"Colombia","href":"/ramps-api/overview/countries/colombia"},{"title":"Brazil","href":"/ramps-api/overview/countries/brazil"}]}]},{"group":"Widget integration","pages":[{"title":"Widget integration","sidebarTitle":"Overview","href":"/ramps-api/widget/overview"},{"group":"Get started","pages":[{"title":"Authentication","href":"/ramps-api/widget/get-started/authentication"},{"title":"Launch the widget","href":"/ramps-api/widget/get-started/launch"},{"title":"Returning to your app","href":"/ramps-api/widget/get-started/returning-to-your-app"}]},{"group":"User flows","pages":[{"title":"Sign-in and terms","href":"/ramps-api/widget/flows/identity-and-terms"},{"title":"Identity verification in the widget","href":"/ramps-api/widget/flows/kyc"},{"title":"Investor profile (Brazil)","href":"/ramps-api/widget/flows/investor-profile"},{"title":"Travel Rule (Mexico)","href":"/ramps-api/widget/flows/travel-rule"},{"title":"Buying crypto (on-ramp)","href":"/ramps-api/widget/flows/on-ramp"},{"title":"Selling crypto (off-ramp)","href":"/ramps-api/widget/flows/off-ramp"},{"title":"History and refunds","href":"/ramps-api/widget/flows/history-and-refunds"},{"title":"Recovering a rejected payout","href":"/ramps-api/widget/flows/order-recovery"},{"title":"Emails Ripio sends your users","href":"/ramps-api/widget/flows/emails"}]},{"group":"Configuration","pages":[{"title":"Partner settings","href":"/ramps-api/widget/configuration/partner-settings"},{"title":"Theming","href":"/ramps-api/widget/configuration/theming"}]},{"title":"Troubleshooting and support","href":"/ramps-api/widget/troubleshooting"}]},{"group":"API Integration","pages":[{"group":"Overview","pages":[{"group":"Identity verification (KYC)","pages":[{"title":"Overview \u0026 which model to use","sidebarTitle":"Overview","href":"/ramps-api/kyc/overview"},{"title":"Ripio-hosted KYC (redirect)","sidebarTitle":"Ripio-hosted KYC (redirect)","href":"/ramps-api/kyc/kyc-with-ripio"},{"title":"Partner-submitted KYC (API)","sidebarTitle":"Partner-submitted KYC (API)","href":"/ramps-api/kyc/kyc-via-api-overview"},{"title":"KYC fields by country","sidebarTitle":"KYC fields by country","href":"/ramps-api/kyc/kyc-fields-by-country"},{"title":"Reusable KYC (Sumsub share token)","sidebarTitle":"Reusable KYC (share token)","href":"/ramps-api/kyc/reusable-kyc"}]},{"title":"On-Ramp integration","href":"/ramps-api/guides/on-ramp-integration"},{"title":"Off-Ramp integration","href":"/ramps-api/guides/off-ramp-integration"},{"title":"QR payments integration","href":"/ramps-api/guides/qr-payments-integration"},{"title":"Forwarding end-user context","href":"/ramps-api/guides/end-user-context"}]},{"group":"API Reference","pages":[{"group":"Authentication","pages":[{"openapi":"ramps-api/openapi.json POST /oauth2/token/","title":"Acquire Access Token","href":"/ramps-api/authentication/acquire-access-token"}]},{"group":"Errors","pages":[{"title":"Error Codes","href":"/ramps-api/errors/error-codes"}]},{"group":"Customers","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/customers/","title":"Create Customer","href":"/ramps-api/customers/create-customer"},{"openapi":"ramps-api/openapi.json PUT /api/v1/customers/{customerId}/","title":"Update Customer","href":"/ramps-api/customers/update-customer"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/fiatAccount/","title":"Create Deposit Account","href":"/ramps-api/customers/create-deposit-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/acceptTerms/","title":"Accept Terms and Conditions","href":"/ramps-api/customers/accept-terms"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/deactivate/","title":"Deactivate Customer","href":"/ramps-api/customers/deactivate-customer"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/reactivate/","title":"Reactivate Customer","href":"/ramps-api/customers/reactivate-customer"}]},{"group":"Terms and Conditions","pages":[{"title":"Terms and Conditions","href":"/ramps-api/terms-and-conditions/introduction"},{"openapi":"ramps-api/openapi.json GET /api/v1/termsAndConditions/","title":"Get Terms and Conditions","href":"/ramps-api/terms-and-conditions/get-terms-and-conditions"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/termsAcceptance/","title":"Get Terms Acceptance Status","href":"/ramps-api/terms-and-conditions/get-terms-acceptance-status"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/termsLink/","title":"Create Terms Acceptance Link","href":"/ramps-api/terms-and-conditions/create-terms-link"}]},{"group":"Investor Profile (Brazil)","pages":[{"title":"Investor Profile (Brazil)","href":"/ramps-api/investor-profile/introduction"},{"openapi":"ramps-api/openapi.json GET /api/v1/investorProfile/questionnaire/","title":"Get Investor Questionnaire","href":"/ramps-api/investor-profile/get-investor-questionnaire"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/investorProfile/","title":"Get Investor Profile Status","href":"/ramps-api/investor-profile/get-investor-profile-status"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/investorProfile/","title":"Submit Investor Profile","href":"/ramps-api/investor-profile/submit-investor-profile"}]},{"group":"Travel Rule (Mexico)","pages":[{"title":"Travel Rule (Mexico)","href":"/ramps-api/travel-rule/introduction"}]},{"group":"KYC","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/kycRequirements/","title":"Retrieve KYC Requirements","href":"/ramps-api/kyc/retrieve-kyc-requirements"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/start/","title":"Start KYC","description":"Starts a KYC verification for the customer. Takes no identity data — only a required `redirectUrl` and an optional `kycProviderShareToken`.\n\nIf the customer already has an approved KYC on your account, this returns `400` with the error code `20015` (`KycAlreadyApprovedException`) — nothing left to do.\n\nOtherwise, an email OTP is sent to the customer as part of starting the verification. The response's `otpRequired` tells you what to do next:\n\n- **`otpRequired: true`** — validate the code with [Validate KYC OTP](/ramps-api/kyc/validate-kyc-otp) before continuing.\n- **`otpRequired: false`** — no OTP step needed. Check the response's `status` to see what's next.\n\nIf the customer already has an approved KYC with Ripio, validating the OTP approves them immediately — no further steps required. Otherwise, once the OTP is confirmed, submit the customer's data with [Submit KYC Information](/ramps-api/kyc/submit-kyc-information) to complete the verification.","href":"/ramps-api/kyc/start-kyc"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/","title":"Submit KYC Information","href":"/ramps-api/kyc/submit-kyc-information"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/otp/resend/","title":"Resend KYC OTP","description":"Resends the email OTP for a KYC verification that is waiting on it. Only works while the verification is pending OTP confirmation — call [Start KYC](/ramps-api/kyc/start-kyc) first.","href":"/ramps-api/kyc/resend-kyc-otp"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/kyc/otp/validate/","title":"Validate KYC OTP","href":"/ramps-api/kyc/validate-kyc-otp"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/kycSubmissions/","title":"Retrieve Latest KYC Submission","href":"/ramps-api/kyc/retrieve-kyc-submission"}]},{"group":"Fiat Accounts","pages":[{"title":"Fiat account lifecycle","href":"/ramps-api/fiat-accounts/lifecycle"},{"openapi":"ramps-api/openapi.json GET /api/v1/fiatAccounts/","title":"List Fiat Accounts","href":"/ramps-api/fiat-accounts/list-fiat-accounts"},{"openapi":"ramps-api/openapi.json POST /api/v1/fiatAccounts/","title":"Create Fiat Account","href":"/ramps-api/fiat-accounts/create-fiat-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/fiatAccounts/{fiatAccountId}/confirm/","title":"Confirm Fiat Account","href":"/ramps-api/fiat-accounts/confirm-fiat-account"},{"openapi":"ramps-api/openapi.json GET /api/v1/fiatAccounts/requirements/","title":"Retrieve Fiat Account Requirements","href":"/ramps-api/fiat-accounts/retrieve-fiat-account-requirements"},{"openapi":"ramps-api/openapi.json GET /api/v1/banks/","title":"List Bank Codes","href":"/ramps-api/fiat-accounts/list-banks"}]},{"group":"Quotes","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/quotes/","title":"Create Quote","href":"/ramps-api/quotes/create-quote"}]},{"group":"On-Ramp","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/onramp/","title":"List On-Ramp Orders","href":"/ramps-api/on-ramp/list-on-ramp-orders"},{"openapi":"ramps-api/openapi.json POST /api/v1/onramp/","title":"Create On-Ramp Order","href":"/ramps-api/on-ramp/create-on-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/onramp/{orderId}/","title":"Retrieve an On-Ramp Order","href":"/ramps-api/on-ramp/retrieve-an-on-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/onrampSession/","title":"List On-Ramp Sessions","href":"/ramps-api/on-ramp/list-on-ramp-sessions"},{"openapi":"ramps-api/openapi.json POST /api/v1/onrampSession/","title":"Create On-Ramp Session","href":"/ramps-api/on-ramp/create-on-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/onrampSession/{sessionId}/","title":"Retrieve an On-Ramp Session","href":"/ramps-api/on-ramp/retrieve-an-on-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/onrampSession/","title":"Retrieve a Customer's On-Ramp Session","href":"/ramps-api/on-ramp/retrieve-a-customer-on-ramp-session"}]},{"group":"Off-Ramp","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/offramp/","title":"List Off-Ramp Orders","href":"/ramps-api/off-ramp/list-off-ramp-orders"},{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/","title":"Create Off-Ramp Order","href":"/ramps-api/off-ramp/create-off-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/offramp/{orderId}/","title":"Retrieve an Off-Ramp Order","href":"/ramps-api/off-ramp/retrieve-an-off-ramp-order"},{"openapi":"ramps-api/openapi.json GET /api/v1/offrampSession/","title":"List Off-Ramp Sessions","href":"/ramps-api/off-ramp/list-off-ramp-sessions"},{"openapi":"ramps-api/openapi.json POST /api/v1/offrampSession/","title":"Create Off-Ramp Session","href":"/ramps-api/off-ramp/create-off-ramp-session"},{"openapi":"ramps-api/openapi.json GET /api/v1/offrampSession/{sessionId}/","title":"Retrieve an Off-Ramp Session","href":"/ramps-api/off-ramp/retrieve-an-off-ramp-session"},{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/{orderId}/changeFiatAccount/","title":"Change Fiat Account and Reprocess","href":"/ramps-api/off-ramp/change-fiat-account"}]},{"group":"Refunds","pages":[{"title":"Refunds","sidebarTitle":"Overview","href":"/ramps-api/refunds/overview"},{"group":"Fiat Refunds","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/transactions/onramp/{orderId}/refund/","title":"Request a Fiat Refund","href":"/ramps-api/refunds/request-fiat-refund"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/refundableDeposits/","title":"List Refundable Deposits","href":"/ramps-api/refunds/list-refundable-deposits"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/refundableDeposits/{depositUuid}/refund/","title":"Refund a Deposit","href":"/ramps-api/refunds/refund-deposit"}]},{"group":"Crypto Refunds","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/offramp/{orderId}/refund/","title":"Request a Crypto Refund","href":"/ramps-api/refunds/request-crypto-refund"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/transactions/offramp/{orderId}/refund/","title":"Request a Customer's Crypto Refund","href":"/ramps-api/refunds/request-customer-crypto-refund"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/refundableCryptoDeposits/","title":"List Refundable Crypto Deposits","href":"/ramps-api/refunds/list-refundable-crypto-deposits"},{"openapi":"ramps-api/openapi.json POST /api/v1/customers/{customerId}/refundableCryptoDeposits/{depositId}/refund/","title":"Refund a Crypto Deposit","href":"/ramps-api/refunds/refund-crypto-deposit"}]}]},{"group":"Sell and Pay","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/fiatAccounts/","title":"Create fiat account for sell and pay","href":"/ramps-api/sell-and-pay/create-fiat-account"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/","title":"Create Sell and Pay transaction","href":"/ramps-api/sell-and-pay/create-sell-and-pay"},{"openapi":"ramps-api/openapi.json PUT /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Update Sell and Pay transaction","href":"/ramps-api/sell-and-pay/update-sell-and-pay"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/{sell_and_pay_id}/execute/","title":"Execute Sell and Pay transaction","href":"/ramps-api/sell-and-pay/execute-sell-and-pay"},{"openapi":"ramps-api/openapi.json GET /api/v1/sellAndPays/","title":"List Sell and Pay transactions","href":"/ramps-api/sell-and-pay/list-sell-and-pay"},{"openapi":"ramps-api/openapi.json GET /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Retrieve Sell and Pay transaction","href":"/ramps-api/sell-and-pay/retrieve-sell-and-pay"},{"openapi":"ramps-api/openapi.json DELETE /api/v1/sellAndPays/{sell_and_pay_id}/","title":"Delete Sell and Pay transaction","href":"/ramps-api/sell-and-pay/delete-sell-and-pay"},{"openapi":"ramps-api/openapi.json POST /api/v1/sellAndPays/validateQrCode/","title":"Validate QR Code","href":"/ramps-api/sell-and-pay/validate-qr-code"}]},{"group":"Transactions","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/transactions/","title":"List All Orders (On-Ramp \u0026 Off-Ramp)","href":"/ramps-api/transactions/list-all-orders-on-ramp-\u0026-off-ramp"},{"openapi":"ramps-api/openapi.json GET /api/v1/transactions/{orderId}/","title":"Retrieve an Order (On-Ramp or Off-Ramp)","href":"/ramps-api/transactions/retrieve-an-order"},{"group":"Customer Transactions","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/transactions/onramp/","title":"List Customer's On-Ramp Transaction History","href":"/ramps-api/transactions/list-customer-onramp-transactions"},{"openapi":"ramps-api/openapi.json GET /api/v1/customers/{customerId}/transactions/offramp/","title":"List Customer's Off-Ramp Transaction History","href":"/ramps-api/transactions/list-customer-offramp-transactions"}]}]},{"group":"Networks","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/depositNetworks/","title":"Get Deposit Networks","href":"/ramps-api/networks/get-deposit-networks"},{"openapi":"ramps-api/openapi.json GET /api/v1/withdrawalNetworks/","title":"Get Withdrawal Networks","href":"/ramps-api/networks/get-withdrawal-networks"}]},{"group":"Rates","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/rates/","title":"Get Market Rates","href":"/ramps-api/rates/get-market-rates"}]},{"group":"Transaction Limits","pages":[{"openapi":"ramps-api/openapi.json GET /api/v1/transactionLimits/","title":"Get Transaction Limits","href":"/ramps-api/transaction-limits/get-transaction-limits"}]},{"group":"Sandbox","pages":[{"title":"KYC in sandbox","href":"/ramps-api/sandbox/kyc-in-sandbox"},{"openapi":"ramps-api/openapi.json POST /api/v1/simulateDeposit/","title":"Simulate Deposit for On-Ramp (Sandbox)","href":"/ramps-api/sandbox/simulate-deposit-for-on-ramp-sandbox"}]},{"group":"Support Tickets","pages":[{"openapi":"ramps-api/openapi.json POST /api/v1/supportTickets/","title":"Create Support Ticket","href":"/ramps-api/support-tickets/create-support-ticket"},{"openapi":"ramps-api/openapi.json GET /api/v1/supportTickets/{ticketId}/","title":"Retrieve Support Ticket","href":"/ramps-api/support-tickets/retrieve-support-ticket"}]},{"group":"Webhooks","pages":[{"group":"Introduction","pages":[{"title":"Webhooks Introduction","href":"/ramps-api/webhooks/introduction"}]},{"group":"On-Ramp Events","pages":[{"title":"On-Ramp Webhook Events","href":"/ramps-api/webhooks/on-ramp-events"}]},{"group":"Off-Ramp Events","pages":[{"title":"Off-Ramp Webhook Events","href":"/ramps-api/webhooks/off-ramp-events"}]},{"group":"Sell and Pay Events","pages":[{"title":"Sell and Pay Webhook Events","href":"/ramps-api/webhooks/sell-and-pay-events"}]},{"group":"KYC Events","pages":[{"title":"KYC Webhook Events","href":"/ramps-api/webhooks/kyc-events"}]},{"group":"Account Events","pages":[{"title":"Account Webhook Events","href":"/ramps-api/webhooks/account-events"}]},{"group":"Support Ticket Events","pages":[{"title":"Support Ticket Webhook Events","href":"/ramps-api/webhooks/support-ticket-events"}]}]}]}]}]},{"tab":"wFiat Stablecoins","pages":[{"title":"wFiat Stablecoins","href":"/wfiat/overview"}]}]},"basePath":"","title":"Submit KYC Information - Ripio B2B API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}