Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.
Cada solicitud a la API de SpherePay debe autenticarse usando una clave API. SpherePay utiliza autenticación con token Bearer — pasas tu clave en el encabezado Authorization de cada solicitud. Esta página cubre cómo generar una clave, cómo usarla y cómo manejar errores de autenticación.
Obtener tu clave API
Las claves API se generan desde el panel de SpherePay:
Copia la clave inmediatamente — no se mostrará nuevamente después de salir de la página.
Trata tu clave API como una contraseña. Nunca la expongas en código del lado del cliente, la confirmes en control de versiones, ni la compartas en texto plano. Si una clave se ve comprometida, revócala inmediatamente desde el panel y genera una nueva.
Hacer una solicitud autenticada
Pasa tu clave API como token Bearer en el encabezado Authorization en cada solicitud:
Si recibes este error en una clave que crees válida, verifica lo siguiente:
El encabezado Authorization tiene el formato Bearer YOUR_API_KEY con un solo espacio entre Bearer y la clave — sin caracteres extra ni comillas.
La clave no ha sido revocada. Inicia sesión en el panel bajo Developers → API Keys para verificar su estado.
Estás enviando la solicitud a través de HTTPS, no HTTP.
Última modificación el 18 de junio 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":"6ae4e40af8344a2328cd117d","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"API Reference","count":52},{"language":"es","tag":"Referencia de la API","count":52},{"language":"pt-BR","tag":"Referência da API","count":52},{"language":"en","tag":"Concepts","count":29},{"language":"es","tag":"Conceptos","count":29},{"language":"pt-BR","tag":"Conceitos","count":29},{"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/get-started/authentication","slug":"/es/get-started/authentication","pageMetadata":{"title":"Autenticarse con la API de SpherePay","icon":"key","sidebarTitle":"Autenticación","description":"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.","source_file":"get-started/authentication.mdx","source_language":"en","translation_language":"es","source_commit":"45af4e7","href":"/es/get-started/authentication"},"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: \"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\"\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`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Cada solicitud a la API de SpherePay debe autenticarse usando una clave API. SpherePay utiliza autenticación con token Bearer — pasas tu clave en el encabezado `,_jsx(_components.code,{children:`Authorization`}),` de cada solicitud. Esta página cubre cómo generar una clave, cómo usarla y cómo manejar errores de autenticación.`]}),`\n`,_jsx(Heading,{level:`2`,id:`obtener-tu-clave-api`,children:`Obtener tu clave API`}),`\n`,_jsx(_components.p,{children:`Las claves API se generan desde el panel de SpherePay:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Inicia sesión en `,_jsx(_components.a,{href:`https://spherepay.co/dashboard`,children:`spherepay.co/dashboard`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Navega a `,_jsx(_components.strong,{children:`Developers → API Keys`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Selecciona `,_jsx(_components.strong,{children:`Create New API Key`}),`.`]}),`\n`,_jsx(_components.li,{children:`Copia la clave inmediatamente — no se mostrará nuevamente después de salir de la página.`}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Trata tu clave API como una contraseña. Nunca la expongas en código del lado del cliente, la confirmes en control de versiones, ni la compartas en texto plano. Si una clave se ve comprometida, revócala inmediatamente desde el panel y genera una nueva.`})}),`\n`,_jsx(Heading,{level:`2`,id:`hacer-una-solicitud-autenticada`,children:`Hacer una solicitud autenticada`}),`\n`,_jsxs(_components.p,{children:[`Pasa tu clave API como token Bearer en el encabezado `,_jsx(_components.code,{children:`Authorization`}),` en cada solicitud:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` https://api.spherepay.co/v2/customer`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer YOUR_API_KEY\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Todas las solicitudes deben usar `,_jsx(_components.strong,{children:`HTTPS`}),`. Las solicitudes realizadas a través de HTTP plano serán rechazadas.`]}),`\n`,_jsx(Heading,{level:`2`,id:`encabezados-de-solicitud`,children:`Encabezados de solicitud`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Encabezado`}),_jsx(_components.th,{children:`Requerido`}),_jsx(_components.th,{children:`Valor`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Authorization`})}),_jsx(_components.td,{children:`Sí`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Bearer YOUR_API_KEY`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:`Sí para POST/PATCH`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`errores-de-autenticación`,children:`Errores de autenticación`}),`\n`,_jsxs(_components.p,{children:[`Si tu clave API falta, está malformada o es inválida, la API devuelve una respuesta `,_jsx(_components.code,{children:`403 Forbidden`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#B5CEA8`,\"--shiki-dark\":`#B5CEA8`},children:`403`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"Forbidden resource\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"correlationId\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"e633f28100526862cadc4c592435eddd\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Si recibes este error en una clave que crees válida, verifica lo siguiente:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`El encabezado `,_jsx(_components.code,{children:`Authorization`}),` tiene el formato `,_jsx(_components.code,{children:`Bearer YOUR_API_KEY`}),` con un solo espacio entre `,_jsx(_components.code,{children:`Bearer`}),` y la clave — sin caracteres extra ni comillas.`]}),`\n`,_jsxs(_components.li,{children:[`La clave no ha sido revocada. Inicia sesión en el panel bajo `,_jsx(_components.strong,{children:`Developers → API Keys`}),` para verificar su estado.`]}),`\n`,_jsx(_components.li,{children:`Estás enviando la solicitud a través de HTTPS, no HTTP.`}),`\n`]})]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Autenticarse con la API de SpherePay","icon":"key","sidebarTitle":"Autenticación","description":"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.","source_file":"get-started/authentication.mdx","source_language":"en","translation_language":"es","source_commit":"45af4e7","href":"/es/get-started/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Obtener tu clave API","slug":"obtener-tu-clave-api","depth":2,"children":[]},{"title":"Hacer una solicitud autenticada","slug":"hacer-una-solicitud-autenticada","depth":2,"children":[]},{"title":"Encabezados de solicitud","slug":"encabezados-de-solicitud","depth":2,"children":[]},{"title":"Errores de autenticación","slug":"errores-de-autenticación","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spherepayco/27b80abc67bf6551/snippets/demoAppUrl.js"],"subdomain":"spherepayco","siteName":"SpherePay","title":"Autenticarse con la API de SpherePay - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/get-started/authentication","matchLevel":1},"es":{"href":"/es/get-started/authentication","matchLevel":0},"pt-BR":{"href":"/pt-BR/get-started/authentication","matchLevel":1}}},"lastModified":"2026-06-18T02:00:00.094Z","gitLastModified":"2026-06-18T01:59:35.000Z","originalFileLocation":"es/get-started/authentication.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=\"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\">\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=\"Autenticarse con la API de SpherePay - SpherePay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpherePay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spherepay.co/es/get-started/authentication\">\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=Comenzar\u0026amp;title=Autenticarse+con+la+API+de+SpherePay\u0026amp;description=Todas+las+solicitudes+de+la+API+de+SpherePay+utilizan+autenticaci%C3%B3n+con+token+Bearer.+Aprende+a+generar+tu+clave+API+y+pasarla+correctamente+en+cada+solicitud.\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=2d9fb7370ebaf5556bd48c5621a9315f37849a02e4529c2ba3d41c79fd3078d5\">\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=\"Autenticarse con la API de SpherePay - SpherePay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spherepayco.mintlify.site/_mintlify/api/og/v2?division=Comenzar\u0026amp;title=Autenticarse+con+la+API+de+SpherePay\u0026amp;description=Todas+las+solicitudes+de+la+API+de+SpherePay+utilizan+autenticaci%C3%B3n+con+token+Bearer.+Aprende+a+generar+tu+clave+API+y+pasarla+correctamente+en+cada+solicitud.\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=2d9fb7370ebaf5556bd48c5621a9315f37849a02e4529c2ba3d41c79fd3078d5\">\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/get-started/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/get-started/authentication.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.spherepay.co/es/get-started/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.spherepay.co/get-started/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.spherepay.co/pt-BR/get-started/authentication\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.spherepay.co/get-started/authentication\">\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/get-started/authentication#webpage\",\"url\":\"https://docs.spherepay.co/es/get-started/authentication\",\"name\":\"Autenticarse con la API de SpherePay\",\"description\":\"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\",\"dateModified\":\"2026-06-18T01:59:35.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/es/get-started/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/es/get-started/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Comenzar\",\"item\":\"https://docs.spherepay.co/es/get-started/how-it-works\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Autenticarse con la API de SpherePay\",\"item\":\"https://docs.spherepay.co/es/get-started/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spherepay.co/es/get-started/authentication#article\",\"headline\":\"Autenticarse con la API de SpherePay\",\"name\":\"Autenticarse con la API de SpherePay\",\"description\":\"Todas las solicitudes de la API de SpherePay utilizan autenticación con token Bearer. Aprende a generar tu clave API y pasarla correctamente en cada solicitud.\",\"url\":\"https://docs.spherepay.co/es/get-started/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/es/get-started/authentication#webpage\"},\"dateModified\":\"2026-06-18T01:59:35.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/get-started/authentication.md","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/get-started/authentication"}]},{"language":"es","tabs":[{"tab":"Comenzar","groups":[{"group":"Introducción","pages":[{"title":"SpherePay: Pagos con stablecoins para negocios globales","icon":"house","sidebarTitle":"Descripción general","href":"/es/introduction"}]},{"group":"Comenzar","pages":[{"title":"Cómo Funciona SpherePay: Modelo de Integración","icon":"map","sidebarTitle":"Cómo funciona","description":"Aprende el modelo de integración en tres pasos de SpherePay: crea un cliente verificado, registra un instrumento de transferencia y ejecútala.","href":"/es/get-started/how-it-works"},{"title":"Autenticarse con la API de SpherePay","icon":"key","sidebarTitle":"Autenticación","href":"/es/get-started/authentication"},{"title":"Realiza tu Primera Llamada a la API de SpherePay","icon":"terminal","sidebarTitle":"Primera llamada API","description":"Recorre la creación de un cliente, el registro de una cuenta bancaria y billetera, y luego ejecuta tu primera transferencia on-ramp con la API de SpherePay.","href":"/es/get-started/first-api-call"},{"title":"Descarga de la Especificación OpenAPI 3.0 de SpherePay","icon":"file-down","sidebarTitle":"Especificación OpenAPI","href":"/es/get-started/openapi-spec"}]}]},{"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","pages":[{"title":"Referencia de la API","href":"/es/api-reference/customer/post"}]},{"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/get-started/authentication"}]}]},"basePath":"","title":"Autenticarse con la API de SpherePay - SpherePay","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}
