Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.
O endpoint de saldo permite que sua aplicação consulte instantaneamente a disponibilidade financeira da conta antes de emitir solicitações de saque ou transferências para terceiros.
Saldo total líquido disponível imediatamente para solicitações de saque ou pagamentos externos via PIX.
blocked
number (float)
Saldo temporariamente retido (por exemplo, reservas de segurança de chargeback, disputas MED em análise ou ordens em processamento).
currency
string
Moeda da conta. O valor retornado é sempre "BRL".
Boas Práticas na Consulta de Saldo
Sempre consulte o saldo disponível antes de disparar transferências de saque via POST /v1/withdrawals. Caso o valor do saque somado às tarifas exceda o campo available, a requisição retornará 402 Payment Required.
Possíveis Respostas de Erro
Código HTTP
Erro
Solução
401 Unauthorized
Chave de API ausente ou inválida.
Verifique se o cabeçalho Authorization: Bearer sk_live_... está presente.
403 Forbidden
Chave de API sem o escopo payments:read.
Adicione a permissão no painel ou gere uma nova chave de acesso.
429 Too Many Requests
Limite de chamadas por minuto atingido.
Respeite o rate limit e cacheie a resposta caso sua aplicação faça consultas em alta frequência.
Saques PIX
Como realizar transferências e liquidações externas
Webhooks
Receber notificações de pagamento em tempo real
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Kavro Pay","description":"Documentação oficial da API Kavro Pay . Cobranças PIX ultra-rápidas, saques instantâneos, gestão de subcontas, webhooks e paylinks. Especificação oficial para Agentes de IA e LLMs: https://api.kavropay.online/llms.txt","colors":{"primary":"#2563eb","light":"#3b82f6","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/kavro/Ouq6ictAGQ4dbo1L/images/kavro-logo-wordmark.png?fit=max\u0026auto=format\u0026n=Ouq6ictAGQ4dbo1L\u0026q=85\u0026s=a0c9317437623e76810920d78ccfafeb","dark":"https://mintcdn.com/kavro/Ouq6ictAGQ4dbo1L/images/kavro-logo-wordmark.png?fit=max\u0026auto=format\u0026n=Ouq6ictAGQ4dbo1L\u0026q=85\u0026s=a0c9317437623e76810920d78ccfafeb"},"favicon":{"light":"https://mintcdn.com/kavro/E8FCSR5KqdQq_AFB/favicon.svg?fit=max\u0026auto=format\u0026n=E8FCSR5KqdQq_AFB\u0026q=85\u0026s=f9a75853c19f7d57640635c4509761da","dark":"https://mintcdn.com/kavro/Ouq6ictAGQ4dbo1L/images/60baa346-ce02-4b07-a894-d7c35537bc19.png?fit=max\u0026auto=format\u0026n=Ouq6ictAGQ4dbo1L\u0026q=85\u0026s=b165ad576d4940fb7d2251a81ef1a927"},"api":{},"navbar":{"links":[{"href":"https://api.kavropay.online/llms.txt","label":"llms.txt"},{"href":"/erros-status","label":"Central de Erros \u0026 Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://kavropay.online"}},"footer":{"socials":{"x":"https://x.com/mintlify","github":"https://github.com/mintlify","linkedin":"https://linkedin.com/company/mintlify"}},"fonts":{"family":"Plus Jakarta Sans"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kavro","hasAudioNarration":false,"actualSubdomain":"kavro","customDomains":["docs.kavropay.online"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-phanomcloud-6ca2c5af","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af8c8f4f845026aa4bd70e8","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Endpoints API","count":32},{"language":"default","tag":"Subcontas","count":13},{"language":"default","tag":"Infraestrutura","count":7},{"language":"default","tag":"Webhooks \u0026 Notificações","count":6},{"language":"default","tag":"Primeiros Passos","count":4},{"language":"default","tag":"Cobranças PIX","count":4},{"language":"default","tag":"Links de Pagamento","count":4},{"language":"default","tag":"Gestão de Clientes","count":3},{"language":"default","tag":"Saques PIX","count":3},{"language":"default","tag":"Split de Pagamentos","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"saldo-conta","slug":"/saldo-conta","pageMetadata":{"title":"Consulta de Saldo da Conta","sidebarTitle":"Saldo da Conta","description":"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.","icon":"wallet","href":"/saldo-conta"},"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: \"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\"\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={code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,CodeGroup,Heading,Note,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`O endpoint de saldo permite que sua aplicação consulte instantaneamente a disponibilidade financeira da conta antes de emitir solicitações de saque ou transferências para terceiros.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Escopo Necessário:`}),` `,_jsx(_components.code,{children:`payments:read`})]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`consultar-saldo`,children:`Consultar Saldo`}),`\n`,`\n`,_jsx(Heading,{level:`3`,id:`requisição`,children:`Requisição`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.kavropay.com.br/v1/balance`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_live_sua_chave_aqui\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`18`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` axios`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` require`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'axios'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` getBalance`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` res`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` axios`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`get`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.kavropay.com.br/v1/balance'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Bearer sk_live_sua_chave_aqui'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Saldo disponível:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`available`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Saldo bloqueado:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`blocked`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Moeda:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`currency`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Erro ao consultar saldo:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`err`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` ||`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` err`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`message`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`getBalance`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`12`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`url `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.kavropay.com.br/v1/balance\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer sk_live_sua_chave_aqui\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(url, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json()`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Saldo Disponível: R$ `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'available'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:.2f}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Saldo Bloqueado: R$ `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`data.get(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'blocked'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:.2f}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`PHP`,numberOfLines:`16`,language:`php`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`php`,children:_jsxs(_components.code,{language:`php`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c?`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`php`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$curl`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` curl_init`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`curl_setopt_array`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` CURLOPT_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =>`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.kavropay.com.br/v1/balance\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` CURLOPT_RETURNTRANSFER`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` CURLOPT_HTTPHEADER`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer sk_live_sua_chave_aqui\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]);`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` curl_exec`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`curl_close`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` json_decode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`echo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Disponível: R$ \"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` .`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` number_format`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'available'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`], `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`','`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'.'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`resposta-de-sucesso-http-200-ok`,children:`Resposta de Sucesso (HTTP 200 OK)`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"available\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3450.00`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"blocked\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.00`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BRL\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`detalhamento-dos-campos-da-resposta`,children:`Detalhamento dos Campos da Resposta`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Campo`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Tipo`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`available`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`number (float)`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Saldo total líquido disponível imediatamente para solicitações de saque ou pagamentos externos via PIX.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`blocked`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`number (float)`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Saldo temporariamente retido (por exemplo, reservas de segurança de chargeback, disputas MED em análise ou ordens em processamento).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`string`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Moeda da conta. O valor retornado é sempre `,_jsx(_components.code,{children:`\"BRL\"`}),`.`]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`boas-práticas-na-consulta-de-saldo`,children:`Boas Práticas na Consulta de Saldo`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Sempre consulte o saldo disponível antes de disparar transferências de saque via `,_jsx(_components.code,{children:`POST /v1/withdrawals`}),`. Caso o valor do saque somado às tarifas exceda o campo `,_jsx(_components.code,{children:`available`}),`, a requisição retornará `,_jsx(_components.code,{children:`402 Payment Required`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`possíveis-respostas-de-erro`,children:`Possíveis Respostas de Erro`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Código HTTP`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Erro`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Solução`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`401 Unauthorized`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Chave de API ausente ou inválida.`}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Verifique se o cabeçalho `,_jsx(_components.code,{children:`Authorization: Bearer sk_live_...`}),` está presente.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`403 Forbidden`})}),_jsxs(_components.td,{style:{textAlign:`left`},children:[`Chave de API sem o escopo `,_jsx(_components.code,{children:`payments:read`}),`.`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Adicione a permissão no painel ou gere uma nova chave de acesso.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`429 Too Many Requests`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Limite de chamadas por minuto atingido.`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Respeite o rate limit e cacheie a resposta caso sua aplicação faça consultas em alta frequência.`})]})]})]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Saques PIX`,icon:`arrow-left`,horizontal:true,href:`/saques-pix`,children:_jsx(_components.p,{children:`Como realizar transferências e liquidações externas`})}),_jsx(Card,{title:`Webhooks`,icon:`arrow-right`,horizontal:true,href:`/webhooks`,children:_jsx(_components.p,{children:`Receber notificações de pagamento em tempo real`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Consulta de Saldo da Conta","sidebarTitle":"Saldo da Conta","description":"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.","icon":"wallet","href":"/saldo-conta"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Consultar Saldo","slug":"consultar-saldo","depth":2,"children":[{"title":"Requisição","slug":"requisição","depth":3,"children":[]},{"title":"Resposta de Sucesso (HTTP 200 OK)","slug":"resposta-de-sucesso-http-200-ok","depth":3,"children":[]},{"title":"Detalhamento dos Campos da Resposta","slug":"detalhamento-dos-campos-da-resposta","depth":3,"children":[]}]},{"title":"Boas Práticas na Consulta de Saldo","slug":"boas-práticas-na-consulta-de-saldo","depth":2,"children":[]},{"title":"Possíveis Respostas de Erro","slug":"possíveis-respostas-de-erro","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"kavro","siteName":"Kavro Pay","title":"Consulta de Saldo da Conta - Kavro Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T03:52:58.459Z","originalFileLocation":"saldo-conta.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Kavro Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_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/kavro/WOOtRhwvKmPG9jzA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Consulta de Saldo da Conta - Kavro Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kavro Pay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kavropay.online/saldo-conta\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kavro.mintlify.site/_mintlify/api/og/v2?division=Endpoints+API\u0026amp;title=Consulta+de+Saldo+da+Conta\u0026amp;description=Verifique+em+tempo+real+o+saldo+dispon%C3%ADvel+para+saques+e+os+valores+retidos+na+sua+carteira+KavroPay.\u0026amp;theme=f5b661c7842dbc50c2a2b86b\u0026amp;signature=92f93dbc19545058fa7c64bf5906a586fcba169a0a6c72effc14fbf1c344d8cc\">\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=\"Consulta de Saldo da Conta - Kavro Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kavro.mintlify.site/_mintlify/api/og/v2?division=Endpoints+API\u0026amp;title=Consulta+de+Saldo+da+Conta\u0026amp;description=Verifique+em+tempo+real+o+saldo+dispon%C3%ADvel+para+saques+e+os+valores+retidos+na+sua+carteira+KavroPay.\u0026amp;theme=f5b661c7842dbc50c2a2b86b\u0026amp;signature=92f93dbc19545058fa7c64bf5906a586fcba169a0a6c72effc14fbf1c344d8cc\">\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/kavro/WOOtRhwvKmPG9jzA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kavro Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kavropay.online/saldo-conta\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/saldo-conta.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kavropay.online/#organization\",\"name\":\"Kavro Pay\",\"url\":\"https://docs.kavropay.online\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kavro/Ouq6ictAGQ4dbo1L/images/kavro-logo-wordmark.png?fit=max\u0026auto=format\u0026n=Ouq6ictAGQ4dbo1L\u0026q=85\u0026s=a0c9317437623e76810920d78ccfafeb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kavropay.online#website\",\"name\":\"Kavro Pay\",\"url\":\"https://docs.kavropay.online\",\"publisher\":{\"@id\":\"https://docs.kavropay.online/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kavropay.online/saldo-conta#webpage\",\"url\":\"https://docs.kavropay.online/saldo-conta\",\"name\":\"Consulta de Saldo da Conta\",\"description\":\"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\",\"dateModified\":\"2026-11-14T03:52:58.459Z\",\"isPartOf\":{\"@id\":\"https://docs.kavropay.online#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kavropay.online/saldo-conta#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kavropay.online/saldo-conta#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints API\",\"item\":\"https://docs.kavropay.online/cobrancas-pix/criar-cobranca\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Consulta de Saldo da Conta\",\"item\":\"https://docs.kavropay.online/saldo-conta\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kavropay.online/saldo-conta#article\",\"headline\":\"Consulta de Saldo da Conta\",\"name\":\"Consulta de Saldo da Conta\",\"description\":\"Verifique em tempo real o saldo disponível para saques e os valores retidos na sua carteira KavroPay.\",\"url\":\"https://docs.kavropay.online/saldo-conta\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kavropay.online/saldo-conta#webpage\"},\"dateModified\":\"2026-11-14T03:52:58.459Z\",\"publisher\":{\"@id\":\"https://docs.kavropay.online/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kavropay.online#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Kavro Pay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Kavro Pay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/saldo-conta.md","siteName":"Kavro Pay","nav":{"global":null,"groups":[{"group":"Primeiros Passos","pages":[{"title":"Visão geral","sidebarTitle":"Visão geral","icon":"eye","href":"/index"},{"title":"Autenticação \u0026 Cabeçalhos HTTP","icon":"key","sidebarTitle":"Autenticação","href":"/autenticacao"},{"title":"Escopos de Permissão","sidebarTitle":"Escopos","icon":"shield-check","href":"/escopos"},{"title":"Formato de Valores \u0026 Metadata","sidebarTitle":"Formato de Valores","icon":"coins","href":"/parametros"}]},{"group":"Endpoints API","pages":[{"group":"Cobranças PIX","pages":[{"title":"Criar cobrança PIX","sidebarTitle":"Criar cobrança","api":"POST /v1/charges","href":"/cobrancas-pix/criar-cobranca"},{"title":"Consultar cobrança PIX","sidebarTitle":"Consultar cobrança","api":"GET /v1/charges/{id}","href":"/cobrancas-pix/consultar-cobranca"},{"title":"Consultar status da cobrança","sidebarTitle":"Consultar status","api":"GET /v1/charges/{id}/status","href":"/cobrancas-pix/consultar-status"},{"title":"Listar cobranças PIX","sidebarTitle":"Listar cobranças","api":"GET /v1/charges","href":"/cobrancas-pix/listar-cobrancas"}]},{"group":"Saques PIX","pages":[{"title":"Solicitar saque PIX","sidebarTitle":"Solicitar saque","api":"POST /v1/withdrawals","href":"/saques-pix/solicitar-saque"},{"title":"Consultar saque PIX","sidebarTitle":"Consultar saque","api":"GET /v1/withdrawals/{id}","href":"/saques-pix/consultar-saque"},{"title":"Listar saques PIX","sidebarTitle":"Listar saques","api":"GET /v1/withdrawals","href":"/saques-pix/listar-saques"}]},{"group":"Subcontas","pages":[{"title":"Visão Geral de Subcontas","sidebarTitle":"Visão geral","icon":"sitemap","href":"/subcontas/visao-geral"},{"title":"Criar subconta","sidebarTitle":"Criar subconta","api":"POST /v1/subaccounts","href":"/subcontas/criar-subconta"},{"title":"Listar subcontas","sidebarTitle":"Listar subcontas","api":"GET /v1/subaccounts","href":"/subcontas/listar-subcontas"},{"title":"Consultar subconta","sidebarTitle":"Consultar detalhes","api":"GET /v1/subaccounts/{id}","href":"/subcontas/consultar-subconta"},{"title":"Consultar saldo da subconta","sidebarTitle":"Consultar saldo","api":"GET /v1/subaccounts/{id}/balance","href":"/subcontas/consultar-saldo"},{"title":"Aporte de saldo na subconta","sidebarTitle":"Aporte de saldo","api":"POST /v1/subaccounts/{id}/add-balance","href":"/subcontas/aporte-saldo"},{"title":"Resgate de saldo da subconta","sidebarTitle":"Resgate de saldo","api":"POST /v1/subaccounts/{id}/remove-balance","href":"/subcontas/resgate-saldo"},{"title":"Transferência interna entre contas","sidebarTitle":"Transferência interna","api":"POST /v1/subaccounts/transfer","href":"/subcontas/transferencia"},{"title":"Configurar markup da subconta","sidebarTitle":"Configurar markup","api":"POST /v1/subaccounts/{id}/pricing","href":"/subcontas/configurar-markup"},{"title":"Limites operacionais da subconta","sidebarTitle":"Limites operacionais","api":"POST /v1/subaccounts/{id}/limits","href":"/subcontas/limites-operacionais"},{"title":"Bloquear ou desbloquear subconta","sidebarTitle":"Bloquear / Desbloquear","api":"POST /v1/subaccounts/{id}/lock","href":"/subcontas/bloqueio"},{"title":"Extrato contábil da subconta","sidebarTitle":"Extrato contábil","api":"GET /v1/subaccounts/{id}/statement","href":"/subcontas/extrato-contabil"},{"title":"Excluir subconta","sidebarTitle":"Excluir subconta","api":"DELETE /v1/subaccounts/{id}","href":"/subcontas/excluir-subconta"}]},{"title":"Verificação de Status Unificado","sidebarTitle":"Status Unificado","description":"Consulta instantânea (\u003c 10ms) do status atual de qualquer cobrança ou saque através de um único endpoint leve.","icon":"gauge","href":"/status-unificado"},{"title":"Consulta de Saldo da Conta","sidebarTitle":"Saldo da Conta","icon":"wallet","href":"/saldo-conta"},{"group":"Links de Pagamento","pages":[{"title":"Criar link de pagamento","sidebarTitle":"Criar link","api":"POST /v1/paylinks","description":"Cria uma página pública de checkout com link compartilhável.","href":"/paylinks/criar-link"},{"title":"Listar links de pagamento","sidebarTitle":"Listar links","api":"GET /v1/paylinks","href":"/paylinks/listar-links"},{"title":"Consultar link de pagamento","sidebarTitle":"Consultar link","api":"GET /v1/paylinks/{id}","href":"/paylinks/consultar-link"},{"title":"Checkout público do paylink","sidebarTitle":"Checkout público","api":"POST /v1/paylinks/public/{id}/checkout","href":"/paylinks/checkout-publico"}]},{"group":"Split de Pagamentos","pages":[{"title":"Split de Pagamentos (Multi-Recebedores)","sidebarTitle":"Visão geral do Split","icon":"arrows-split-up-and-left","href":"/split-de-pagamentos/visao-geral"},{"title":"Simular cálculo de Split","sidebarTitle":"Simular cálculo","api":"POST /v1/splits/calculate","href":"/split-de-pagamentos/simular-split"},{"title":"Listar extrato de Splits","sidebarTitle":"Extrato de Splits","api":"GET /v1/splits","href":"/split-de-pagamentos/extrato-splits"}]},{"group":"Gestão de Clientes","pages":[{"title":"Listar clientes","sidebarTitle":"Listar clientes","api":"GET /v1/customers","href":"/gestao-clientes/listar-clientes"},{"title":"Consultar cliente","sidebarTitle":"Consultar cliente","api":"GET /v1/customers/{id}","href":"/gestao-clientes/consultar-cliente"},{"title":"Atualizar cliente","sidebarTitle":"Atualizar cliente","api":"PATCH /v1/customers/{id}","href":"/gestao-clientes/atualizar-cliente"}]}]},{"group":"Infraestrutura","pages":[{"group":"Webhooks \u0026 Notificações","pages":[{"title":"Webhooks \u0026 Notificações em Tempo Real","sidebarTitle":"Visão geral \u0026 Eventos","icon":"bell","href":"/webhooks/visao-geral"},{"title":"Listar webhooks","sidebarTitle":"Listar webhooks","api":"GET /v1/webhooks","href":"/webhooks/listar-webhooks"},{"title":"Criar webhook","sidebarTitle":"Criar webhook","api":"POST /v1/webhooks","href":"/webhooks/criar-webhook"},{"title":"Testes e Simulações em Sandbox","sidebarTitle":"Testar disparo \u0026 Sandbox","api":"POST /v1/webhooks/{id}/test","href":"/webhooks/testar-disparo"},{"title":"Entregas \u0026 Logs de webhook","sidebarTitle":"Entregas \u0026 Logs","api":"GET /v1/webhooks/deliveries","href":"/webhooks/entregas-logs"},{"title":"Validação de Assinatura HMAC","sidebarTitle":"Validação HMAC","icon":"shield-halved","href":"/webhooks/validacao-hmac"}]},{"title":"Idempotência \u0026 Infraestrutura","sidebarTitle":"Idempotência \u0026 Alta Disponibilidade","icon":"fingerprint","href":"/infraestrutura"}]},{"group":"Referência","pages":[{"title":"Central de Erros \u0026 Status","icon":"bug","href":"/erros-status"},{"title":"llms.txt (Guia para Modelos de IA \u0026 Agentes)","sidebarTitle":"llms.txt","icon":"robot","href":"/llms"}]}]},"basePath":"","title":"Consulta de Saldo da Conta - Kavro Pay","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}