{
"code": "customer/onboarding-v3-managed",
"correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
"detail": "This customer cannot be used with this route.",
"status": 409
}
Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).
{
"code": "customer/onboarding-v3-managed",
"correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
"detail": "This customer cannot be used with this route.",
"status": 409
}
Este endpoint funciona solo contra https://api.sandbox.spherepay.co. Reporta un resultado de verificación simulado para un cliente, porque sandbox nunca llama a los proveedores de verificación. approved aprueba todos los perfiles de verificación que tiene el cliente (A, y C y D cuando aplican), de modo que el cliente puede usar todas las rutas que esos perfiles habilitan; rejected los rechaza todos. Pasa profile para avanzar un solo perfil: A (kyc_profile_a, kyb_profile_a), o aprobar C o D (kyc_profile_c, kyc_profile_d, kyb_profile_c, kyb_profile_d) mientras los demás quedan como están. Los clientes incorporados mediante el link de KYC alojado se avanzan de la misma manera. Avanzar al resultado actual no cambia nada, y un cliente rechazado no puede ser aprobado (422).
Autorizaciones
Authorization
string
header
requerido
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros de ruta
id
string
requerido
Cuerpo
application/json
outcome
enum<string>
requerido
The verification outcome the provider reports for the customer.
Opciones disponibles:
approved,
rejected
Ejemplo:
"approved"
profile
enum<string>
Advance only this profile: A (kyc_profile_a, kyb_profile_a), or approve C or D (kyc_profile_c, kyc_profile_d, kyb_profile_c, kyb_profile_d) while the others stay as they are. Use the kyc_ names for individuals and the kyb_ names for businesses; a business C or D also covers its representatives. Omit it to advance every profile the customer has.
Opciones disponibles:
kyc_profile_a,
kyb_profile_a,
kyc_profile_c,
kyb_profile_c,
kyc_profile_d,
kyb_profile_d
Ejemplo:
"kyc_profile_a"
Respuesta
Individual
Business
Response containing information about an individual customer.
createdAt
string
requerido
ISO 8601 formatted customer creation timestamp
Ejemplo:
"2026-03-09T20:46:31.305Z"
enabledVerificationProfiles
enum<string>[] | null
requerido
Which verification profile families this customer may onboard through. Set explicitly at creation — from the request when supplied, otherwise a snapshot of the application's families at that moment — and thereafter changed only by an explicit update, so it does not follow later changes to the application. Always a subset of the application's families. Distinct from verificationProfiles, which reports the evaluated profiles and their statuses.
Opciones disponibles:
a,
b,
c,
d
Ejemplo:
["a", "c"]
id
string
requerido
Customer ID
Ejemplo:
"customer_f31121c389624d3697cbf3ea8830b7a4"
tosStatus
enum<string>
requerido
Customer Terms of Service acceptance status (incomplete | pending | approved).
Opciones disponibles:
incomplete,
pending,
approved
Ejemplo:
"incomplete"
type
enum<string>
requerido
Customer type
Opciones disponibles:
individual
Ejemplo:
"individual"
updatedAt
string
requerido
ISO 8601 formatted customer update timestamp
Ejemplo:
"2026-03-09T20:46:31.305Z"
verificationProfiles
object[]
requerido
The evaluated verification profiles for this customer and their statuses — what the customer is being assessed against right now, as opposed to enabledVerificationProfiles, which says which families they are permitted to use. Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See KYC Flow for individuals or KYB Flow for businesses. See Verification Profile for individual status definitions and criteria breakdown or Verification Profile for business status definitions and criteria breakdown.
The customer's date of birth in YYYY-MM-DD format (individual customers only).
Ejemplo:
"1990-01-15"
email
string
Customer email address
Ejemplo:
"jane.smith@example.com"
firstName
string
Customer first name (individual customers only)
Ejemplo:
"Jane"
lastName
string
Customer last name (individual customers only)
Ejemplo:
"Smith"
meta
object
Show child attributes
personalInformation
object
Personal information for an individual customer, echoed back from the most recent submission. The tax identification number is omitted from responses for privacy.
Show child attributes
phone
string
Customer phone number
Ejemplo:
"+14155550123"
statusDetails
object
Additional context on why the customer's verification reached its current status.
Show child attributes
Ejemplo:
{ "message": "Please re-upload a clear photo of the front and back of the director's ID and correct the tax ID number.", "reasons": [ { "externalReason": "Cannot validate ID — upload a photo of the ID that is clear", "reasonCode": "poor_image_quality", "verificationProfiles": ["kyb_profile_a"] }, { "externalReason": "The tax identification number is not in a valid format for the selected country and ID type.", "reasonCode": "invalid_tax_identification_number", "verificationProfiles": ["kyb_profile_a"] } ], "updatedAt": "2026-07-16T21:04:00Z" }
Última modificación el 16 de noviembre de 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SpherePay","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48","dark":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-dark.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=841362b62b2d8a0da3d2b69d22c62d88"},"favicon":"https://mintcdn.com/spherepayco/a4WF4v5_QYD1dXam/favicon.png?fit=max\u0026auto=format\u0026n=a4WF4v5_QYD1dXam\u0026q=85\u0026s=b3c29639701db7176e6ac8f2b03f68a7","api":{"playground":{"display":"none"}},"navbar":{"primary":{"type":"button","label":"Sphere Dashboard ↗","href":"https://spherepay.co/dashboard"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"metadata":{"timestamp":true},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spherepayco","hasAudioNarration":false,"actualSubdomain":"spherepayco","customDomains":["docs.spherepay.co"],"gitSource":{"type":"github","owner":"sphere-laboratories","repo":"mintlify-docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afb548f102c05d39eace92b","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"en","tag":"API Reference","count":56},{"language":"es","tag":"Referencia de la API","count":56},{"language":"pt-BR","tag":"Referência da API","count":56},{"language":"en","tag":"Concepts","count":30},{"language":"es","tag":"Conceptos","count":30},{"language":"pt-BR","tag":"Conceitos","count":30},{"language":"en","tag":"Onboarding","count":27},{"language":"es","tag":"Incorporación","count":27},{"language":"pt-BR","tag":"Onboarding","count":27},{"language":"en","tag":"Money movement","count":24},{"language":"es","tag":"Movimiento de dinero","count":24},{"language":"pt-BR","tag":"Movimentação de dinheiro","count":24},{"language":"en","tag":"Webhooks","count":13},{"language":"es","tag":"Webhooks","count":13},{"language":"pt-BR","tag":"Webhooks","count":13},{"language":"en","tag":"Accounts","count":9},{"language":"en","tag":"Transfers","count":9},{"language":"en","tag":"Get Started","count":9},{"language":"es","tag":"Cuentas","count":9},{"language":"es","tag":"Transferencias","count":9},{"language":"es","tag":"Comenzar","count":9},{"language":"pt-BR","tag":"Contas","count":9},{"language":"pt-BR","tag":"Transferências","count":9},{"language":"pt-BR","tag":"Começar","count":9},{"language":"en","tag":"Virtual Accounts","count":7},{"language":"es","tag":"Cuentas Virtuales","count":7},{"language":"pt-BR","tag":"Contas Virtuais","count":7},{"language":"en","tag":"Documents \u0026 Verification","count":6},{"language":"es","tag":"Documentos y Verificación","count":6},{"language":"pt-BR","tag":"Documentos e Verificação","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@spherepay.co","showHelpButton":true}},"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":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6a02974593b34b4b8541d063","deploymentId":"69f39b63abf2e25489b5290d","questionText":"What currencies are supported?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:13.452Z","updatedAt":"2026-05-12T02:58:13.452Z","__v":0},{"_id":"6a02973893b34b4b8541d023","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I create a transfer?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:00.452Z","updatedAt":"2026-05-12T02:58:00.452Z","__v":0},{"_id":"6a02972c93b34b4b8541cfef","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I onboard a business?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:57:48.946Z","updatedAt":"2026-05-12T02:57:48.946Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=\"update-tag\"]{padding:2px 8px;border:1px solid var(--gray-200, #e5e7eb);background:transparent;color:var(--gray-600, #4b5563);font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;border-radius:4px;line-height:1.4}.dark [data-component-part=\"update-tag\"]{border-color:var(--gray-700, #374151);color:var(--gray-300, #d1d5db)}[data-component-part=\"update-tag-list\"]{margin-top:0.5rem;gap:0.375rem}nav[class*=\"navbar\"] ul li a.link{border-radius:0!important;background:transparent!important;border-bottom:2px solid transparent;transition:border-color 120ms ease, color 120ms ease}nav[class*=\"navbar\"] ul li a.link:hover{background:transparent!important;color:#18181b!important;border-bottom-color:rgba(37, 99, 235, 0.4)}.dark nav[class*=\"navbar\"] ul li a.link:hover{color:#60A5FA!important;border-bottom-color:rgba(96, 165, 250, 0.4)}nav[class*=\"navbar\"] ul li a.link[aria-current=\"page\"]{background:transparent!important;border-bottom-color:var(--mintlify-primary, #2563EB);color:#18181b!important}.dark nav[class*=\"navbar\"] ul li a.link[aria-current=\"page\"]{color:#fafafa!important;border-bottom-color:#60A5FA}nav[class*=\"navbar\"][class*=\"justify-center\"]{justify-content:flex-start!important}button:has(>div>svg.lucide-search){width:auto!important;min-width:220px;padding-left:14px!important;padding-right:12px!important;justify-content:space-between!important}button:has(>div>svg.lucide-search) .truncate.min-w-0{display:block!important}a[href=\"https://spherepay.co/dashboard\"] span[class*=\"bg-primary-dark\"]{border-radius:6px!important;background-color:#2970FF!important;transition:background-color 120ms ease}a[href=\"https://spherepay.co/dashboard\"]:hover span[class*=\"bg-primary-dark\"]{background-color:#155EEF!important;opacity:1!important}a[href=\"https://spherepay.co/dashboard\"] svg{display:none!important}[data-component-part=\"card-icon\"]{width:44px!important;height:44px!important;display:flex!important;align-items:center;justify-content:center;background:rgba(209, 224, 255, 0.5);border-radius:10px;margin-bottom:1rem}.dark [data-component-part=\"card-icon\"]{background:rgba(96, 165, 250, 0.15)}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){margin-left:24px;padding-left:4px;border-left:1.5px solid #E5E7EB}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)) a[href*=\"/api-reference/\"]{padding-left:16px!important}.dark ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){border-left-color:rgba(255, 255, 255, 0.12)}#sidebar button[aria-expanded]>div:has(>svg[viewBox=\"0 -9 3 24\"]){margin-left:auto}#sidebar:has(a[href*=\"/api-reference/\"]){border-right:1px solid #E5E7EB}.dark #sidebar:has(a[href*=\"/api-reference/\"]){border-right-color:rgba(255, 255, 255, 0.1)}.sidebar-group-icon{display:none!important}#navbar-transition{border-bottom-color:#E5E7EB!important}@media (min-width: 1024px){#navbar-transition::after{content:\"\";position:absolute;left:0;right:0;top:64px;height:1px;background:#E5E7EB;pointer-events:none}}#navbar .flex-1{border-bottom-color:transparent!important}.dark #navbar-transition{border-bottom-color:rgba(255, 255, 255, 0.1)!important}.dark #navbar-transition::after{background:rgba(255, 255, 255, 0.1)}"}],"page":{"pagePath":"es/api-reference/sandbox/customer-advance","slug":"/es/api-reference/sandbox/customer-advance","pageMetadata":{"title":"Avanzar un Cliente de Sandbox","sidebarTitle":"Avanzar Cliente","openapi":"openapi/spherepay.yaml POST /v2/sandbox/customer/{id}/advance","source_file":"api-reference/sandbox/customer-advance.mdx","source_language":"en","translation_language":"es","source_commit":"b14036c","description":"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).","href":"/es/api-reference/sandbox/customer-advance"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Este endpoint funciona solo contra `,_jsx(_components.code,{children:`https://api.sandbox.spherepay.co`}),`. Reporta un resultado de verificación simulado para un cliente, porque sandbox nunca llama a los proveedores de verificación. `,_jsx(_components.code,{children:`approved`}),` aprueba todos los perfiles de verificación que tiene el cliente (A, y C y D cuando aplican), de modo que el cliente puede usar todas las rutas que esos perfiles habilitan; `,_jsx(_components.code,{children:`rejected`}),` los rechaza todos. Pasa `,_jsx(_components.code,{children:`profile`}),` para avanzar un solo perfil: A (`,_jsx(_components.code,{children:`kyc_profile_a`}),`, `,_jsx(_components.code,{children:`kyb_profile_a`}),`), o aprobar C o D (`,_jsx(_components.code,{children:`kyc_profile_c`}),`, `,_jsx(_components.code,{children:`kyc_profile_d`}),`, `,_jsx(_components.code,{children:`kyb_profile_c`}),`, `,_jsx(_components.code,{children:`kyb_profile_d`}),`) mientras los demás quedan como están. Los clientes incorporados mediante el link de KYC alojado se avanzan de la misma manera. Avanzar al resultado actual no cambia nada, y un cliente rechazado no puede ser aprobado (`,_jsx(_components.code,{children:`422`}),`).`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Avanzar un Cliente de Sandbox","sidebarTitle":"Avanzar Cliente","openapi":"openapi/spherepay.yaml POST /v2/sandbox/customer/{id}/advance","source_file":"api-reference/sandbox/customer-advance.mdx","source_language":"en","translation_language":"es","source_commit":"b14036c","description":"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).","href":"/es/api-reference/sandbox/customer-advance"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spherepayco/27b80abc67bf6551/snippets/demoAppUrl.js"],"openApiReferenceData":{"operation":{"description":"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).","operationId":"postV2SandboxCustomerByIdAdvance","parameters":["e2fc39e7-5020-45ca-90f6-0a7c04cdc67b"],"requestBody":"8d919532-7ddd-4cb8-96aa-4b228891b6fb","responses":{"201":"71837dca-10c4-4e0d-a805-b67d5d088f51","202":"0c1aab77-f586-4e3b-89b8-6671761be026","400":"c673f526-32c8-4a7f-ba80-faa1eb14359b","404":"8c0f0cfe-9360-4fc4-80ec-a13e52529436","409":"c75eeb3c-bad9-47c0-adaa-c1bf537ca523","422":"703df849-9d91-4b73-821b-e80e28ddd2cb"},"servers":["68716800-e4f7-47d7-ad78-a67683686bf5"],"summary":"Advance a sandbox customer","method":"post","type":"path","security":["d2c5e951-bc5c-4c0e-9398-d81153991947"],"path":"/v2/sandbox/customer/{id}/advance","baseUrlOptions":["https://api.sandbox.spherepay.co"],"title":"Advance a sandbox customer","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e2fc39e7-5020-45ca-90f6-0a7c04cdc67b":{"in":"path","name":"id","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"properties":{"outcome":{"description":"The verification outcome the provider reports for the customer.","enum":["approved","rejected"],"example":"approved","type":"string","isRequired":true,"uniqueKey":"outcome","typeLabel":"enum\u003cstring>"},"profile":{"description":"Advance only this profile: A (kyc_profile_a, kyb_profile_a), or approve C or D (kyc_profile_c, kyc_profile_d, kyb_profile_c, kyb_profile_d) while the others stay as they are. Use the kyc_ names for individuals and the kyb_ names for businesses; a business C or D also covers its representatives. Omit it to advance every profile the customer has.","enum":["kyc_profile_a","kyb_profile_a","kyc_profile_c","kyb_profile_c","kyc_profile_d","kyb_profile_d"],"example":"kyc_profile_a","type":"string","uniqueKey":"profile","typeLabel":"enum\u003cstring>"}},"required":["outcome"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"outcome":"approved","profile":"kyc_profile_a"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"71837dca-10c4-4e0d-a805-b67d5d088f51":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Individual","description":"Response containing information about an individual customer.","required":["id","enabledVerificationProfiles","verificationProfiles","tosStatus","createdAt","updatedAt","type"],"properties":{"createdAt":{"description":"ISO 8601 formatted customer creation timestamp","example":"2026-03-09T20:46:31.305Z","type":"string","isRequired":true,"uniqueKey":"oneOf.0.createdAt","typeLabel":"string"},"enabledVerificationProfiles":{"oneOf":[{"description":"Which verification profile families this customer may onboard through. Set explicitly at creation — from the request when supplied, otherwise a snapshot of the application's families at that moment — and thereafter changed only by an explicit update, so it does not follow later changes to the application. Always a subset of the application's families. Distinct from `verificationProfiles`, which reports the evaluated profiles and their statuses.","example":["a","c"],"items":{"enum":["a","b","c","d"],"type":"string","uniqueKey":"oneOf.0.enabledVerificationProfiles.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.enabledVerificationProfiles.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"description":"Which verification profile families this customer may onboard through. Set explicitly at creation — from the request when supplied, otherwise a snapshot of the application's families at that moment — and thereafter changed only by an explicit update, so it does not follow later changes to the application. Always a subset of the application's families. Distinct from `verificationProfiles`, which reports the evaluated profiles and their statuses.","example":["a","c"],"items":{"enum":["a","b","c","d"],"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.0.enabledVerificationProfiles.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.enabledVerificationProfiles","typeLabel":"enum\u003cstring>[] | null"},"id":{"description":"Customer ID","example":"customer_f31121c389624d3697cbf3ea8830b7a4","type":"string","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"tosStatus":{"description":"Customer Terms of Service acceptance status (incomplete | pending | approved).","enum":["incomplete","pending","approved"],"example":"incomplete","type":"string","x-enumNames":["Incomplete","Pending","Approved"],"isRequired":true,"uniqueKey":"oneOf.0.tosStatus","typeLabel":"enum\u003cstring>"},"type":{"description":"Customer type","enum":["individual"],"example":"individual","type":"string","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"updatedAt":{"description":"ISO 8601 formatted customer update timestamp","example":"2026-03-09T20:46:31.305Z","type":"string","isRequired":true,"uniqueKey":"oneOf.0.updatedAt","typeLabel":"string"},"verificationProfiles":{"description":"The evaluated verification profiles for this customer and their statuses — what the customer is being assessed against right now, as opposed to `enabledVerificationProfiles`, which says which families they are permitted to use. Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See [KYC Flow](/concepts/onboarding/individual-kyc) for individuals or [KYB Flow](/concepts/onboarding/business-kyb) for businesses. See [Verification Profile](/concepts/onboarding/verification-profile) for individual status definitions and criteria breakdown or [Verification Profile](/concepts/onboarding/verification-profile) for business status definitions and criteria breakdown.","example":[{"criteria":{"complete":["email_address","phone_number","residential_address","tax_identification_number"],"errors":[],"pending":[],"required":["identity_document","liveness_report_document"]},"name":"kyc_profile_a","status":"incomplete"}],"items":{"properties":{"name":{"description":"The name of the verification profile.","enum":["kyc_profile_a","kyb_profile_a","ubo_kyc_profile_a","kyc_profile_b","kyb_profile_b","kyb_profile_c","kyc_profile_c","ubo_kyc_profile_c","kyb_profile_d","kyc_profile_d","ubo_kyc_profile_d"],"example":"kyc_profile_a","type":"string","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"status":{"description":"The status of the verification profile.","enum":["incomplete","pending","approved","rejected","rejected_final","manual_review","resubmission_required"],"example":"incomplete","type":"string","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"criteria":{"description":"The criteria for the verification profile.","example":{"complete":["email_address","phone_number","residential_address","tax_identification_number"],"errors":[],"pending":[],"required":["identity_document","liveness_report_document"]},"properties":{"complete":{"description":"Completed fields.","example":["email_address","phone_number","residential_address","tax_identification_number"],"items":{"type":"string","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.complete.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.complete","typeLabel":"string[]"},"errors":{"description":"The errors that occurred while verifying the fields.","example":[],"items":{"properties":{"name":{"enum":["email_verification","phone_verification","residential_address","identity_document","tax_identification_number","liveness_check","terms_of_service","email_address","phone_number","master_service_agreement","legal_name","trade_name","entity_type","entity_type_description","description","registered_address","operating_address","business_representatives","naics_code","website","incorporated_on","identification_number","registration_number","estimated_annual_revenue","expected_monthly_payments","account_purpose","account_purpose_description","source_of_funds","source_of_funds_description","is_dao","regulated_activities","regulated_activities_description","participates_in_regulated_financial_activity","regulated_financial_activity_description","money_services_description","compliance_screening_explanation","operates_in_prohibited_countries","incorporation_cert_document","incorporation_articles_document","shareholder_registry_document","proof_of_nature_of_business_document","proof_of_address_document","liveness_report_document","ownership_percentage","is_control_person","control_person_added","is_signer","relationship_established_at","title","employment_status","acting_as_intermediary","sex","country_of_birth","nationality","middle_name","occupation_soc_code","w8_ben_document","w9_document","state_of_birth","ip_address","ip_address_approved","expected_monthly_transaction_count","transaction_frequency","expected_counterparty_types","expected_geographies","w8_ben_e_document","corporate_resolution_document","source_of_funds_document","financial_statements_document","bank_statement_document","regulated_activity_document","flow_of_funds_document","kyc_b_approval","kyb_b_approval"],"type":"string","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"detail":{"type":"string","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX].detail","typeLabel":"string"}},"required":["name"],"type":"object","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.errors","typeLabel":"object[]"},"pending":{"description":"Pending fields. These fields are currently being verified.","example":[],"items":{"type":"string","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.pending.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.pending","typeLabel":"string[]"},"required":{"description":"Required fields. These fields are required to be completed before the verification profile can be approved.","example":["identity_document","liveness_report_document"],"items":{"type":"string","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.required.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria.required","typeLabel":"string[]"}},"required":["complete","pending","required","errors"],"type":"object","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX].criteria","typeLabel":"object"}},"required":["name","status"],"type":"object","uniqueKey":"oneOf.0.verificationProfiles.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.verificationProfiles","typeLabel":"object[]"},"dateOfBirth":{"description":"The customer's date of birth in YYYY-MM-DD format (individual customers only).","example":"1990-01-15","type":"string","uniqueKey":"oneOf.0.dateOfBirth","typeLabel":"string"},"email":{"description":"Customer email address","example":"jane.smith@example.com","type":"string","uniqueKey":"oneOf.0.email","typeLabel":"string"},"firstName":{"description":"Customer first name (individual customers only)","example":"Jane","type":"string","uniqueKey":"oneOf.0.firstName","typeLabel":"string"},"lastName":{"description":"Customer last name (individual customers only)","example":"Smith","type":"string","uniqueKey":"oneOf.0.lastName","typeLabel":"string"},"meta":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.meta.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"oneOf.0.meta","typeLabel":"object"},"personalInformation":{"description":"Personal information for an individual customer, echoed back from the most recent submission. The tax identification number is omitted from responses for privacy.","properties":{"accountPurpose":{"type":"string","uniqueKey":"oneOf.0.personalInformation.accountPurpose","typeLabel":"string"},"accountPurposeDescription":{"type":"string","uniqueKey":"oneOf.0.personalInformation.accountPurposeDescription","typeLabel":"string"},"actingAsIntermediary":{"description":"Whether the customer is acting as an intermediary on behalf of a third party. Required by some verification providers.","example":false,"type":"boolean","uniqueKey":"oneOf.0.personalInformation.actingAsIntermediary","typeLabel":"boolean"},"countryOfBirth":{"description":"The ISO3166-1 Alpha-3 country code of the country where the customer was born. See [Country Codes](/concepts/reference/supported-countries).","example":"USA","type":"string","uniqueKey":"oneOf.0.personalInformation.countryOfBirth","typeLabel":"string"},"employmentStatus":{"type":"string","uniqueKey":"oneOf.0.personalInformation.employmentStatus","typeLabel":"string"},"expectedMonthlyPayments":{"type":"string","uniqueKey":"oneOf.0.personalInformation.expectedMonthlyPayments","typeLabel":"string"},"gender":{"type":"string","uniqueKey":"oneOf.0.personalInformation.gender","typeLabel":"string"},"middleName":{"description":"The customer's middle name. Required for some verification flows.","example":"James","type":"string","uniqueKey":"oneOf.0.personalInformation.middleName","typeLabel":"string"},"nationality":{"description":"The ISO3166-1 Alpha-3 country code of the customer's nationality. Required by some verification providers. See [Country Codes](/concepts/reference/supported-countries).","example":"USA","type":"string","uniqueKey":"oneOf.0.personalInformation.nationality","typeLabel":"string"},"occupationSocCode":{"description":"The customer's occupation as a 6-digit Standard Occupational Classification (SOC) code, validated against the supported occupation list. Required for some verification flows.","example":"151252","type":"string","uniqueKey":"oneOf.0.personalInformation.occupationSocCode","typeLabel":"string"},"residencyCountry":{"description":"The ISO3166-1 Alpha-3 country code of the customer's country of residency. Often satisfied by the address country, but some verification providers require it as a separate attribute. See [Country Codes](/concepts/reference/supported-countries).","example":"USA","type":"string","uniqueKey":"oneOf.0.personalInformation.residencyCountry","typeLabel":"string"},"sourceOfFunds":{"type":"string","uniqueKey":"oneOf.0.personalInformation.sourceOfFunds","typeLabel":"string"},"stateOfBirth":{"description":"The subdivision code of the state/province where the customer was born, without the country prefix (e.g. `JAL`, not `MX-JAL`). Requires `countryOfBirth`. Required by some verification providers.","example":"JAL","type":"string","uniqueKey":"oneOf.0.personalInformation.stateOfBirth","typeLabel":"string"},"taxIdentificationNumberCountry":{"description":"The ISO3166-1 Alpha-3 country code for the tax identification number. Required when providing tax identification information. See [Country Codes](/concepts/reference/supported-countries).","example":"USA","type":"string","uniqueKey":"oneOf.0.personalInformation.taxIdentificationNumberCountry","typeLabel":"string"},"taxIdentificationNumberDescription":{"description":"Description of the tax identification number. Required when type is `other`","type":"string","uniqueKey":"oneOf.0.personalInformation.taxIdentificationNumberDescription","typeLabel":"string"},"taxIdentificationNumberType":{"description":"The type of tax identification number of the customer. Required when providing tax identification information. Please refer to the [Individual Verification Criteria](/concepts/onboarding/verification-profile) for the full list of reference.","example":"ssn","type":"string","uniqueKey":"oneOf.0.personalInformation.taxIdentificationNumberType","typeLabel":"string"}},"type":"object","uniqueKey":"oneOf.0.personalInformation","typeLabel":"object"},"phone":{"description":"Customer phone number","example":"+14155550123","type":"string","uniqueKey":"oneOf.0.phone","typeLabel":"string"},"statusDetails":{"description":"Additional context on why the customer's verification reached its current status.","example":{"message":"Please re-upload a clear photo of the front and back of the director's ID and correct the tax ID number.","reasons":[{"externalReason":"Cannot validate ID — upload a photo of the ID that is clear","reasonCode":"poor_image_quality","verificationProfiles":["kyb_profile_a"]},{"externalReason":"The tax identification number is not in a valid format for the selected country and ID type.","reasonCode":"invalid_tax_identification_number","verificationProfiles":["kyb_profile_a"]}],"updatedAt":"2026-07-16T21:04:00Z"},"properties":{"reasons":{"items":{"properties":{"reasonCode":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.statusDetails.reasons.items.[INDEX].reasonCode","typeLabel":"string"},"verificationProfiles":{"items":{"type":"string","uniqueKey":"oneOf.0.statusDetails.reasons.items.[INDEX].verificationProfiles.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.statusDetails.reasons.items.[INDEX].verificationProfiles","typeLabel":"string[]"},"externalReason":{"type":"string","uniqueKey":"oneOf.0.statusDetails.reasons.items.[INDEX].externalReason","typeLabel":"string"}},"required":["reasonCode","verificationProfiles"],"type":"object","uniqueKey":"oneOf.0.statusDetails.reasons.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.0.statusDetails.reasons","typeLabel":"object[]"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.statusDetails.updatedAt","typeLabel":"string"},"message":{"type":"string","uniqueKey":"oneOf.0.statusDetails.message","typeLabel":"string"}},"required":["reasons","updatedAt"],"type":"object","uniqueKey":"oneOf.0.statusDetails","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"Individual · object"},{"type":"object","title":"Business","description":"Response containing information about a business customer.","required":["id","enabledVerificationProfiles","verificationProfiles","tosStatus","createdAt","updatedAt","type"],"properties":{"createdAt":{"description":"ISO 8601 formatted customer creation timestamp","example":"2026-03-09T20:46:31.305Z","type":"string","isRequired":true,"uniqueKey":"oneOf.1.createdAt","typeLabel":"string"},"enabledVerificationProfiles":{"oneOf":[{"description":"Which verification profile families this customer may onboard through. Set explicitly at creation — from the request when supplied, otherwise a snapshot of the application's families at that moment — and thereafter changed only by an explicit update, so it does not follow later changes to the application. Always a subset of the application's families. Distinct from `verificationProfiles`, which reports the evaluated profiles and their statuses.","example":["a","c"],"items":{"enum":["a","b","c","d"],"type":"string","uniqueKey":"oneOf.1.enabledVerificationProfiles.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.enabledVerificationProfiles.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"description":"Which verification profile families this customer may onboard through. Set explicitly at creation — from the request when supplied, otherwise a snapshot of the application's families at that moment — and thereafter changed only by an explicit update, so it does not follow later changes to the application. Always a subset of the application's families. Distinct from `verificationProfiles`, which reports the evaluated profiles and their statuses.","example":["a","c"],"items":{"enum":["a","b","c","d"],"type":"string"},"type":"null","isRequired":true,"uniqueKey":"oneOf.1.enabledVerificationProfiles.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.enabledVerificationProfiles","typeLabel":"enum\u003cstring>[] | null"},"id":{"description":"Customer ID","example":"customer_f31121c389624d3697cbf3ea8830b7a4","type":"string","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"tosStatus":{"description":"Customer Terms of Service acceptance status (incomplete | pending | approved).","enum":["incomplete","pending","approved"],"example":"incomplete","type":"string","x-enumNames":["Incomplete","Pending","Approved"],"isRequired":true,"uniqueKey":"oneOf.1.tosStatus","typeLabel":"enum\u003cstring>"},"type":{"description":"Customer type","enum":["business"],"example":"business","type":"string","isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"},"updatedAt":{"description":"ISO 8601 formatted customer update timestamp","example":"2026-03-09T20:46:31.305Z","type":"string","isRequired":true,"uniqueKey":"oneOf.1.updatedAt","typeLabel":"string"},"verificationProfiles":{"description":"The evaluated verification profiles for this customer and their statuses — what the customer is being assessed against right now, as opposed to `enabledVerificationProfiles`, which says which families they are permitted to use. Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See [KYC Flow](/concepts/onboarding/individual-kyc) for individuals or [KYB Flow](/concepts/onboarding/business-kyb) for businesses. See [Verification Profile](/concepts/onboarding/verification-profile) for individual status definitions and criteria breakdown or [Verification Profile](/concepts/onboarding/verification-profile) for business status definitions and criteria breakdown.","example":[{"criteria":{"complete":["email_address","phone_number","residential_address","tax_identification_number"],"errors":[],"pending":[],"required":["identity_document","liveness_report_document"]},"name":"kyc_profile_a","status":"incomplete"}],"items":{"properties":{"name":{"description":"The name of the verification profile.","enum":["kyc_profile_a","kyb_profile_a","ubo_kyc_profile_a","kyc_profile_b","kyb_profile_b","kyb_profile_c","kyc_profile_c","ubo_kyc_profile_c","kyb_profile_d","kyc_profile_d","ubo_kyc_profile_d"],"example":"kyc_profile_a","type":"string","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"status":{"description":"The status of the verification profile.","enum":["incomplete","pending","approved","rejected","rejected_final","manual_review","resubmission_required"],"example":"incomplete","type":"string","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"criteria":{"description":"The criteria for the verification profile.","example":{"complete":["email_address","phone_number","residential_address","tax_identification_number"],"errors":[],"pending":[],"required":["identity_document","liveness_report_document"]},"properties":{"complete":{"description":"Completed fields.","example":["email_address","phone_number","residential_address","tax_identification_number"],"items":{"type":"string","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.complete.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.complete","typeLabel":"string[]"},"errors":{"description":"The errors that occurred while verifying the fields.","example":[],"items":{"properties":{"name":{"enum":["email_verification","phone_verification","residential_address","identity_document","tax_identification_number","liveness_check","terms_of_service","email_address","phone_number","master_service_agreement","legal_name","trade_name","entity_type","entity_type_description","description","registered_address","operating_address","business_representatives","naics_code","website","incorporated_on","identification_number","registration_number","estimated_annual_revenue","expected_monthly_payments","account_purpose","account_purpose_description","source_of_funds","source_of_funds_description","is_dao","regulated_activities","regulated_activities_description","participates_in_regulated_financial_activity","regulated_financial_activity_description","money_services_description","compliance_screening_explanation","operates_in_prohibited_countries","incorporation_cert_document","incorporation_articles_document","shareholder_registry_document","proof_of_nature_of_business_document","proof_of_address_document","liveness_report_document","ownership_percentage","is_control_person","control_person_added","is_signer","relationship_established_at","title","employment_status","acting_as_intermediary","sex","country_of_birth","nationality","middle_name","occupation_soc_code","w8_ben_document","w9_document","state_of_birth","ip_address","ip_address_approved","expected_monthly_transaction_count","transaction_frequency","expected_counterparty_types","expected_geographies","w8_ben_e_document","corporate_resolution_document","source_of_funds_document","financial_statements_document","bank_statement_document","regulated_activity_document","flow_of_funds_document","kyc_b_approval","kyb_b_approval"],"type":"string","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX].name","typeLabel":"enum\u003cstring>"},"detail":{"type":"string","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX].detail","typeLabel":"string"}},"required":["name"],"type":"object","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.errors","typeLabel":"object[]"},"pending":{"description":"Pending fields. These fields are currently being verified.","example":[],"items":{"type":"string","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.pending.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.pending","typeLabel":"string[]"},"required":{"description":"Required fields. These fields are required to be completed before the verification profile can be approved.","example":["identity_document","liveness_report_document"],"items":{"type":"string","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.required.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria.required","typeLabel":"string[]"}},"required":["complete","pending","required","errors"],"type":"object","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX].criteria","typeLabel":"object"}},"required":["name","status"],"type":"object","uniqueKey":"oneOf.1.verificationProfiles.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.verificationProfiles","typeLabel":"object[]"},"businessLegalName":{"description":"Customer business legal name (business customers only)","example":"Acme Corporation Inc.","type":"string","uniqueKey":"oneOf.1.businessLegalName","typeLabel":"string"},"businessTradeName":{"description":"Customer business trade name (business customers only)","example":"Acme Corp","type":"string","uniqueKey":"oneOf.1.businessTradeName","typeLabel":"string"},"email":{"description":"Customer email address","example":"jane.smith@example.com","type":"string","uniqueKey":"oneOf.1.email","typeLabel":"string"},"meta":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.1.meta.additionalProperties","typeLabel":"any"},"type":"object","uniqueKey":"oneOf.1.meta","typeLabel":"object"},"phone":{"description":"Customer phone number","example":"+14155550123","type":"string","uniqueKey":"oneOf.1.phone","typeLabel":"string"},"statusDetails":{"description":"Additional context on why the customer's verification reached its current status.","example":{"message":"Please re-upload a clear photo of the front and back of the director's ID and correct the tax ID number.","reasons":[{"externalReason":"Cannot validate ID — upload a photo of the ID that is clear","reasonCode":"poor_image_quality","verificationProfiles":["kyb_profile_a"]},{"externalReason":"The tax identification number is not in a valid format for the selected country and ID type.","reasonCode":"invalid_tax_identification_number","verificationProfiles":["kyb_profile_a"]}],"updatedAt":"2026-07-16T21:04:00Z"},"properties":{"reasons":{"items":{"properties":{"reasonCode":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.statusDetails.reasons.items.[INDEX].reasonCode","typeLabel":"string"},"verificationProfiles":{"items":{"type":"string","uniqueKey":"oneOf.1.statusDetails.reasons.items.[INDEX].verificationProfiles.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.statusDetails.reasons.items.[INDEX].verificationProfiles","typeLabel":"string[]"},"externalReason":{"type":"string","uniqueKey":"oneOf.1.statusDetails.reasons.items.[INDEX].externalReason","typeLabel":"string"}},"required":["reasonCode","verificationProfiles"],"type":"object","uniqueKey":"oneOf.1.statusDetails.reasons.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.statusDetails.reasons","typeLabel":"object[]"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.statusDetails.updatedAt","typeLabel":"string"},"message":{"type":"string","uniqueKey":"oneOf.1.statusDetails.message","typeLabel":"string"}},"required":["reasons","updatedAt"],"type":"object","uniqueKey":"oneOf.1.statusDetails","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"Business · object"}],"uniqueKey":"","typeLabel":"Individual · object | Business · object"},"examples":{"Example":{"title":"Example","value":{"createdAt":"2026-03-09T20:46:31.305Z","enabledVerificationProfiles":["a","c"],"id":"customer_f31121c389624d3697cbf3ea8830b7a4","tosStatus":"incomplete","type":"individual","updatedAt":"2026-03-09T20:46:31.305Z","verificationProfiles":[{"criteria":{"complete":["email_address","phone_number","residential_address","tax_identification_number"],"errors":[],"pending":[],"required":["identity_document","liveness_report_document"]},"name":"kyc_profile_a","status":"incomplete"}],"dateOfBirth":"1990-01-15","email":"jane.smith@example.com","firstName":"Jane","lastName":"Smith","meta":{},"personalInformation":{"accountPurpose":"\u003cstring>","accountPurposeDescription":"\u003cstring>","actingAsIntermediary":false,"countryOfBirth":"USA","employmentStatus":"\u003cstring>","expectedMonthlyPayments":"\u003cstring>","gender":"\u003cstring>","middleName":"James","nationality":"USA","occupationSocCode":"151252","residencyCountry":"USA","sourceOfFunds":"\u003cstring>","stateOfBirth":"JAL","taxIdentificationNumberCountry":"USA","taxIdentificationNumberDescription":"\u003cstring>","taxIdentificationNumberType":"ssn"},"phone":"+14155550123","statusDetails":{"message":"Please re-upload a clear photo of the front and back of the director's ID and correct the tax ID number.","reasons":[{"externalReason":"Cannot validate ID — upload a photo of the ID that is clear","reasonCode":"poor_image_quality","verificationProfiles":["kyb_profile_a"]},{"externalReason":"The tax identification number is not in a valid format for the selected country and ID type.","reasonCode":"invalid_tax_identification_number","verificationProfiles":["kyb_profile_a"]}],"updatedAt":"2026-07-16T21:04:00Z"}}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"0c1aab77-f586-4e3b-89b8-6671761be026":{"description":"Identity verification passed and the provider customer creation is queued; profile A stays pending until the provider has created the customer.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c673f526-32c8-4a7f-ba80-faa1eb14359b":{"content":{"application/json":{"examples":{"Bad Request":{"title":"Bad Request","summary":"Bad Request","value":{"code":"address/invalid","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Invalid request parameters","status":400}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Bad Request","exampleType":"examples"},"8c0f0cfe-9360-4fc4-80ec-a13e52529436":{"content":{"application/json":{"examples":{"Not Found":{"title":"Not Found","summary":"Not Found","value":{"code":"resource/not-found","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Resource not found","status":404}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Not Found","exampleType":"examples"},"c75eeb3c-bad9-47c0-adaa-c1bf537ca523":{"content":{"application/json":{"examples":{"Customer not available on this route":{"title":"Customer not available on this route","summary":"Customer not available on this route","value":{"code":"customer/onboarding-v3-managed","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"This customer cannot be used with this route.","status":409}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Conflict - the customer cannot be used with this route","exampleType":"examples"},"703df849-9d91-4b73-821b-e80e28ddd2cb":{"content":{"application/json":{"examples":{"Validation Error":{"title":"Validation Error","summary":"Validation Error","value":{"code":"validation/failed","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Validation failed","errors":[{"detail":"Invalid email format","pointer":"/email"},{"detail":"Name is required","pointer":"/name"}],"status":422}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unprocessable Entity - Validation Error","exampleType":"examples"}},"security":{"d2c5e951-bc5c-4c0e-9398-d81153991947":{"bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"68716800-e4f7-47d7-ad78-a67683686bf5":{"description":"Sandbox","url":"https://api.sandbox.spherepay.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi/spherepay.yaml"},"subdomain":"spherepayco","siteName":"SpherePay","title":"Avanzar un Cliente de Sandbox - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/sandbox/customer-advance","matchLevel":1},"es":{"href":"/es/api-reference/sandbox/customer-advance","matchLevel":0},"pt-BR":{"href":"/pt-BR/api-reference/sandbox/customer-advance","matchLevel":1}}},"lastModified":"2026-11-16T19:08:05.134Z","gitLastModified":"2026-11-16T19:07:54.000Z","originalFileLocation":"es/api-reference/sandbox/customer-advance.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\">\u003cmeta data-mint-head name=\"application-name\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Avanzar un Cliente de Sandbox - SpherePay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpherePay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spherepayco.mintlify.site/_mintlify/api/og/v2?division=Simulaci%C3%B3n+de+Sandbox\u0026amp;title=Avanzar+un+Cliente+de+Sandbox\u0026amp;description=Sandbox+only.+Reports+a+simulated+verification+outcome%3B+sandbox+never+calls+the+verification+providers.+Approved+approves+every+verification+profile+the+custome\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=34f994ecc793febd519cdd9ac8087f92579bcb79cd5ac11a1d68120c6dfac3b3\">\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=\"Avanzar un Cliente de Sandbox - SpherePay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spherepayco.mintlify.site/_mintlify/api/og/v2?division=Simulaci%C3%B3n+de+Sandbox\u0026amp;title=Avanzar+un+Cliente+de+Sandbox\u0026amp;description=Sandbox+only.+Reports+a+simulated+verification+outcome%3B+sandbox+never+calls+the+verification+providers.+Approved+approves+every+verification+profile+the+custome\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=34f994ecc793febd519cdd9ac8087f92579bcb79cd5ac11a1d68120c6dfac3b3\">\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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/sandbox/customer-advance.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.spherepay.co/api-reference/sandbox/customer-advance\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.spherepay.co/pt-BR/api-reference/sandbox/customer-advance\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.spherepay.co/api-reference/sandbox/customer-advance\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spherepay.co/#organization\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spherepay.co#website\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance#webpage\",\"url\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\",\"name\":\"Avanzar un Cliente de Sandbox\",\"description\":\"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\",\"dateModified\":\"2026-11-16T19:07:54.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SpherePay\",\"item\":\"https://docs.spherepay.co\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Avanzar un Cliente de Sandbox\",\"item\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance#apireference\",\"headline\":\"Avanzar un Cliente de Sandbox\",\"name\":\"Avanzar un Cliente de Sandbox\",\"description\":\"Sandbox only. Reports a simulated verification outcome; sandbox never calls the verification providers. Approved approves every verification profile the customer has (A, and C and D where they apply), so the customer can use every route those profiles open; rejected rejects them all. Pass profile to advance profile A only. Customers onboarded through the hosted KYC link are advanced the same way. Advancing to the current outcome changes nothing; a rejected customer cannot be approved (422).\",\"url\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/es/api-reference/sandbox/customer-advance#webpage\"},\"dateModified\":\"2026-11-16T19:07:54.000Z\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SpherePay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SpherePay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/api-reference/sandbox/customer-advance.md","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/sandbox/customer-advance"}]},{"language":"es","tabs":[{"tab":"Comenzar","pages":[{"title":"Comenzar","href":"/es/introduction"}]},{"tab":"Conceptos","pages":[{"title":"Conceptos","href":"/es/concepts/overview"}]},{"tab":"Guías","pages":[{"title":"Guías","href":"/es/implementation-guides/overview"}]},{"tab":"Soluciones","pages":[{"title":"Soluciones","href":"/es/solutions/overview"}]},{"tab":"Referencia de la API","groups":[{"group":"Incorporación","pages":[{"group":"Clientes","icon":"user","pages":[{"title":"Crear un Cliente Individual o Empresarial","sidebarTitle":"Crear Cliente","openapi":"openapi/spherepay.yaml POST /v2/customer","href":"/es/api-reference/customer/post"},{"title":"Listar Clientes con Filtros y Paginación","sidebarTitle":"Listar Clientes","openapi":"openapi/spherepay.yaml GET /v2/customer","href":"/es/api-reference/customer/get"},{"title":"Recuperar un Cliente con Estado de Verificación","sidebarTitle":"Obtener Cliente","openapi":"openapi/spherepay.yaml GET /v2/customer/{id}","href":"/es/api-reference/customer/get-id"},{"title":"Actualizar Dirección, Teléfono o Correo del Cliente","sidebarTitle":"Actualizar Cliente","openapi":"openapi/spherepay.yaml PATCH /v2/customer/{id}","href":"/es/api-reference/customer/patch-id"}]},{"group":"Links de Incorporación","icon":"link","pages":[{"title":"Crear Cliente vía Link","sidebarTitle":"Crear Cliente vía Link","openapi":"openapi/spherepay.yaml POST /v2/customer/kyc-link","href":"/es/api-reference/customer/kyc-link"},{"title":"Regenerar el Link KYC de un Cliente","sidebarTitle":"Regenerar Link KYC","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/kyc-link","href":"/es/api-reference/customer/kyc"}]},{"group":"Documentos y Verificación","icon":"file-check","pages":[{"title":"Subir Documentos de Identidad KYC y KYB","sidebarTitle":"Subir Documento","openapi":"openapi/spherepay.yaml POST /v2/document","href":"/es/api-reference/document/post"},{"title":"Generar un Link de Verificación Facial para el Cliente","sidebarTitle":"Link de Verificación Facial","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/face-verification-link","href":"/es/api-reference/enhanced-due-diligence/face-verification-link"},{"title":"Generar un Link de Verificación Facial de UBO para KYB","sidebarTitle":"Link de Verificación Facial de UBO","openapi":"openapi/spherepay.yaml POST /v2/business-representative/{id}/face-verification-link","href":"/es/api-reference/enhanced-due-diligence/ubo-face-verification-link"},{"title":"Enviar un Código OTP para Verificación del Cliente","sidebarTitle":"Enviar Código de Verificación","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-send","href":"/es/api-reference/enhanced-due-diligence/send-verification-code"},{"title":"Verificar un Código OTP del Cliente para Correo o Teléfono","sidebarTitle":"Verificar Código OTP","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-verify","href":"/es/api-reference/enhanced-due-diligence/verify-verification-code"},{"title":"Registrar la Aceptación de Términos de Servicio del Cliente","sidebarTitle":"Aceptar Términos de Servicio","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/tos-link","href":"/es/api-reference/enhanced-due-diligence/tos"}]},{"group":"Representantes Empresariales","icon":"users","pages":[{"title":"Registrar un UBO Empresarial para Verificación KYB","sidebarTitle":"Registrar Representante","openapi":"openapi/spherepay.yaml POST /v2/business-representative","href":"/es/api-reference/business-representative/post"},{"title":"Listar Todos los Representantes Empresariales y UBOs","sidebarTitle":"Listar Representantes","openapi":"openapi/spherepay.yaml GET /v2/business-representative","href":"/es/api-reference/business-representative/get"},{"title":"Recuperar un Representante Empresarial por ID","sidebarTitle":"Obtener Representante","openapi":"openapi/spherepay.yaml GET /v2/business-representative/{id}","href":"/es/api-reference/business-representative/get-id"},{"title":"Actualizar un Representante Empresarial Antes del KYB","sidebarTitle":"Actualizar Representante","openapi":"openapi/spherepay.yaml PATCH /v2/business-representative/{id}","href":"/es/api-reference/business-representative/patch-id"},{"title":"Eliminar un Representante Empresarial o UBO","sidebarTitle":"Eliminar Representante","openapi":"openapi/spherepay.yaml DELETE /v2/business-representative/{id}","href":"/es/api-reference/business-representative/delete-id"}]}]},{"group":"Cuentas","pages":[{"group":"Cuentas Bancarias","icon":"landmark","pages":[{"title":"Registrar Cuenta Bancaria del Cliente para Transferencias","sidebarTitle":"Registrar Cuenta Bancaria","openapi":"openapi/spherepay.yaml POST /v2/bank-account","href":"/es/api-reference/bank-account/post"},{"title":"Listar Todas las Cuentas Bancarias del Cliente Registradas","sidebarTitle":"Listar Cuentas Bancarias","openapi":"openapi/spherepay.yaml GET /v2/bank-account","href":"/es/api-reference/bank-account/get"},{"title":"Recuperar una Cuenta Bancaria por ID","sidebarTitle":"Obtener Cuenta Bancaria","openapi":"openapi/spherepay.yaml GET /v2/bank-account/{id}","href":"/es/api-reference/bank-account/get-id"},{"title":"Actualizar Configuración de Rieles de la Cuenta Bancaria","sidebarTitle":"Actualizar Cuenta Bancaria","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","href":"/es/api-reference/bank-account/patch-id"},{"title":"Eliminar una Cuenta Bancaria del Cliente Registrada","sidebarTitle":"Eliminar Cuenta Bancaria","openapi":"openapi/spherepay.yaml DELETE /v2/bank-account/{id}","href":"/es/api-reference/bank-account/delete-id"}]},{"group":"Billeteras","icon":"wallet","pages":[{"title":"Registrar Billetera Cripto del Cliente para Transferencias","sidebarTitle":"Registrar Billetera","openapi":"openapi/spherepay.yaml POST /v2/wallet","href":"/es/api-reference/wallet/post"},{"title":"Listar Todas las Billeteras Cripto del Cliente Registradas","sidebarTitle":"Listar Billeteras","openapi":"openapi/spherepay.yaml GET /v2/wallet","href":"/es/api-reference/wallet/get"},{"title":"Recuperar una Billetera Cripto del Cliente por ID","sidebarTitle":"Obtener Billetera","openapi":"openapi/spherepay.yaml GET /v2/wallet/{id}","href":"/es/api-reference/wallet/get-id"},{"title":"Eliminar una Billetera Cripto del Cliente Registrada","sidebarTitle":"Eliminar Billetera","openapi":"openapi/spherepay.yaml DELETE /v2/wallet/{id}","href":"/es/api-reference/wallet/delete-id"}]}]},{"group":"Movimiento de dinero","pages":[{"group":"Transferencias","icon":"arrow-right-left","pages":[{"title":"Crear una Transferencia On-Ramp u Off-Ramp","sidebarTitle":"Crear Transferencia","openapi":"openapi/spherepay.yaml POST /v2/transfer","href":"/es/api-reference/transfer/post"},{"title":"Listar Transferencias On-Ramp y Off-Ramp","sidebarTitle":"Listar Transferencias","openapi":"openapi/spherepay.yaml GET /v2/transfer","href":"/es/api-reference/transfer/get"},{"title":"Recuperar una Transferencia con Instrucciones de Depósito","sidebarTitle":"Obtener Transferencia","openapi":"openapi/spherepay.yaml GET /v2/transfer/{id}","href":"/es/api-reference/transfer/get-id"},{"title":"Cancelar una Transferencia Pendiente Sin Fondos","sidebarTitle":"Cancelar Transferencia","openapi":"openapi/spherepay.yaml DELETE /v2/transfer/{id}","href":"/es/api-reference/transfer/delete-id"}]},{"group":"Cotizaciones","icon":"calculator","pages":[{"title":"Crear una Cotización con Tasa Bloqueada","sidebarTitle":"Crear Cotización","openapi":"openapi/spherepay.yaml POST /v2/quote","href":"/es/api-reference/quote/post"},{"title":"Listar Cotizaciones con Tasa Bloqueada de tu Cuenta","sidebarTitle":"Listar Cotizaciones","openapi":"openapi/spherepay.yaml GET /v2/quote","href":"/es/api-reference/quote/get"},{"title":"Recuperar una Cotización por ID","sidebarTitle":"Obtener Cotización","openapi":"openapi/spherepay.yaml GET /v2/quote/{id}","href":"/es/api-reference/quote/get-id"},{"title":"Actualizar Estado de Cotización","sidebarTitle":"Actualizar Cotización","openapi":"openapi/spherepay.yaml PUT /v2/quote/{id}","href":"/es/api-reference/quote/put-id"}]},{"group":"Cuentas Virtuales","icon":"credit-card","pages":[{"title":"Crear una Cuenta Bancaria Virtual para On-Ramp de Fiat","sidebarTitle":"Crear Cuenta Virtual","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","href":"/es/api-reference/virtual-account/post"},{"title":"Listar Todas las Cuentas Bancarias Virtuales Onramper","sidebarTitle":"Listar Cuentas Virtuales","openapi":"openapi/spherepay.yaml GET /v2/virtual-account","href":"/es/api-reference/virtual-account/get"},{"title":"Recuperar un Onramper Account por ID","sidebarTitle":"Obtener Cuenta Virtual","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}","href":"/es/api-reference/virtual-account/get-id"},{"title":"Actualizar la Billetera de Destino de un Onramper Account","sidebarTitle":"Actualizar Cuenta Virtual","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}","href":"/es/api-reference/virtual-account/patch"},{"title":"Listar Transferencias de un Onramper Account","sidebarTitle":"Listar Transferencias de la Cuenta","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}/transfer","href":"/es/api-reference/virtual-account/list-transfers"},{"title":"Desactivar una Cuenta Bancaria Virtual Onramper","sidebarTitle":"Desactivar Cuenta","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/deactivate","href":"/es/api-reference/virtual-account/deactivate"},{"title":"Reactivar un Onramper Account Desactivado","sidebarTitle":"Reactivar Cuenta","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/reactivate","href":"/es/api-reference/virtual-account/reactivate"}]},{"group":"Offloader Wallets","icon":"arrow-up-from-line","pages":[{"title":"Crear un Offloader Wallet para Pagos Cripto","sidebarTitle":"Crear Offloader Wallet","openapi":"openapi/spherepay.yaml POST /v2/offloader-wallet","href":"/es/api-reference/offloader-wallet/post"},{"title":"Listar Todos los Offloader Wallets de tu Cuenta","sidebarTitle":"Listar Offloader Wallets","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet","href":"/es/api-reference/offloader-wallet/get"},{"title":"Recuperar un Offloader Wallet por ID","sidebarTitle":"Obtener Offloader Wallet","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet/{id}","href":"/es/api-reference/offloader-wallet/get-id"},{"title":"Actualizar el Destino Bancario de un Offloader Wallet","sidebarTitle":"Actualizar Offloader Wallet","openapi":"openapi/spherepay.yaml PATCH /v2/offloader-wallet/{id}","href":"/es/api-reference/offloader-wallet/patch-id"}]}]},{"group":"Webhooks","pages":[{"group":"Endpoints de Webhook","icon":"plug","pages":[{"title":"Registrar un Endpoint de Webhook para Entrega de Eventos","sidebarTitle":"Crear Endpoint de Webhook","openapi":"openapi/spherepay.yaml POST /v2/webhook-endpoints","href":"/es/api-reference/webhook-endpoints/post"},{"title":"Listar Todos los Endpoints de Webhook Registrados","sidebarTitle":"Listar Endpoints de Webhook","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints","href":"/es/api-reference/webhook-endpoints/get"},{"title":"Recuperar un Endpoint de Webhook por ID","sidebarTitle":"Obtener Endpoint de Webhook","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints/{id}","href":"/es/api-reference/webhook-endpoints/get-id"},{"title":"Eliminar un Endpoint de Webhook","sidebarTitle":"Eliminar Endpoint de Webhook","openapi":"openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}","href":"/es/api-reference/webhook-endpoints/delete-id"}]},{"group":"Eventos","icon":"bell","pages":[{"title":"Listar Eventos y su Estado de Entrega","sidebarTitle":"Listar Eventos","openapi":"openapi/spherepay.yaml GET /v2/events","href":"/es/api-reference/events/get"},{"title":"Recuperar un Evento con su Historial Completo de Entregas","sidebarTitle":"Obtener Evento","openapi":"openapi/spherepay.yaml GET /v2/events/{id}","href":"/es/api-reference/events/get-id"},{"title":"Reenviar una Entrega de Evento Fallida","sidebarTitle":"Reenviar Entrega","openapi":"openapi/spherepay.yaml POST /v2/events/replay/{eventDeliveryId}","description":"Redeliver an event to its webhook endpoint by the ID of a prior delivery attempt.","href":"/es/api-reference/events/replay"}]}]},{"group":"Simulación de Sandbox","pages":[{"title":"Avanzar un Cliente de Sandbox","sidebarTitle":"Avanzar Cliente","openapi":"openapi/spherepay.yaml POST /v2/sandbox/customer/{id}/advance","href":"/es/api-reference/sandbox/customer-advance"},{"title":"Avanzar una Transferencia de Sandbox","sidebarTitle":"Avanzar Transferencia","openapi":"openapi/spherepay.yaml POST /v2/sandbox/transfer/{id}/advance","description":"Sandbox only. Moves a transfer to the given status through the same status pipeline production uses. The matching transfer.* webhook is delivered when webhooks are enabled for the application; undeliverable has no webhook event. Advancing to the current status is a no-op that returns the transfer unchanged; a transition the lifecycle does not allow is rejected with 422.","href":"/es/api-reference/sandbox/transfer-advance"},{"title":"Emitir Tokens de Prueba","sidebarTitle":"Emitir Tokens de Prueba","openapi":"openapi/spherepay.yaml POST /v2/sandbox/faucet","href":"/es/api-reference/sandbox/faucet-post"},{"title":"Recuperar una Emisión de Tokens de Prueba","sidebarTitle":"Obtener Emisión","openapi":"openapi/spherepay.yaml GET /v2/sandbox/faucet/{id}","href":"/es/api-reference/sandbox/faucet-get-id"}]}]},{"tab":"Notas","pages":[{"title":"Notas","href":"/es/changelog"}]},{"tab":"FAQ","href":"https://spherepay-knowledge-base.help.usepylon.com/"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/sandbox/customer-advance"}]}]},"basePath":"","title":"Avanzar un Cliente de Sandbox - SpherePay","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","Page-CWFqNdGh.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}