Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição
Para começar a integrar com a Delfinance, você precisa configurar seus ambientes de desenvolvimento e obter suas credenciais de acesso. Oferecemos dois ambientes distintos para garantir a segurança e estabilidade da sua integração.
O ambiente de Sandbox é o ponto de entrada para testar a integração sem impacto financeiro. Para testar, use uma das chaves de teste do Sandbox: escolha uma conta e envie os valores nos headers x-delbank-api-key e x-delfinance-account-id.Para Produção, contrate a API no internet banking. A contratação gera a chave de API, o account-id e o certificado mTLS. Veja o passo a passo em Contratar a API.
Nunca compartilhe sua API Key, Account ID ou chave privada do certificado em repositórios públicos.
Após validar sua integração no Sandbox, o próximo passo é preparar a operação em Produção. Para entender melhor esse processo e o que muda na transição, consulte a página Ida para Produção.
Passo B: Revise as regras de segurança antes de avançar
Antes de migrar para Produção, revise as boas práticas e os componentes de segurança da integração na página Autenticação e segurança.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Delfinance","colors":{"primary":"#1A941A","light":"#25D325","dark":"#21B421"},"logo":{"light":"https://conta.Delfinance.com.br/assets/delfinance-dark-CehGtYbD.png","dark":"https://conta.Delfinance.com.br/assets/delfinance-DbGOasZf.png"},"favicon":"https://conta.delfinance.com.br/icon.png","api":{"examples":{"languages":["bash","javascript","python","go"]},"mdx":{"server":["https://apisandbox.delbank.com.br","https://api.delbank.com.br"]}},"appearance":{"default":"light","strict":true},"background":{"color":{"dark":"#0D0D0D"}},"navbar":{"links":[{"href":"mailto:suporte@Delfinance.com.br","label":"Suporte"}]},"footer":{"socials":{"x":"https://x.com/Delfinance","github":"https://github.com/Delfinance","linkedin":"https://linkedin.com/company/Delfinance"}},"fonts":{"heading":{"family":"Outfit"},"body":{"family":"Outfit"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"delfinance","hasAudioNarration":false,"actualSubdomain":"delfinance","customDomains":["docs.delfinance.com.br"],"gitSource":{"type":"github","owner":"tech-andrade","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aec89bb3744ce14d0845fab","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Referência API","count":78},{"language":"default","tag":"Como integrar","count":64},{"language":"default","tag":"Split de Pagamentos","count":33},{"language":"default","tag":"Pix","count":25},{"language":"default","tag":"Pix Automático","count":22},{"language":"default","tag":"Boleto","count":9},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Repasses","count":8},{"language":"default","tag":"Receber via Pix (Pix Cash-in)","count":8},{"language":"default","tag":"Conta","count":6}]},"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"iniciacao/primeiros-passos","slug":"/iniciacao/primeiros-passos","pageMetadata":{"title":"Primeiros passos","description":"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição","icon":"play","href":"/iniciacao/primeiros-passos"},"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: \"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\"\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`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._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:[_jsx(_components.p,{children:`Para começar a integrar com a Delfinance, você precisa configurar seus ambientes de desenvolvimento e obter suas credenciais de acesso. Oferecemos dois ambientes distintos para garantir a segurança e estabilidade da sua integração.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`1-ambientes-sandbox-vs-produção`,children:`1. Ambientes: Sandbox vs Produção`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Recurso`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Sandbox (Testes)`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Produção (Real)`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Objetivo`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Simular cenários de teste sem dinheiro real`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Processar transações financeiras reais`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`URL Base`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`https://apisandbox.delbank.com.br`})}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`https://api.delbank.com.br`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Limites`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Rate limit reduzido, dados fictícios`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Rate limit comercial, dados reais`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Dinheiro`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Moeda fictícia`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Dinheiro real (BRL)`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`2-configurando-seu-ambiente-de-sandbox`,children:`2. Configurando seu Ambiente de Sandbox`}),`\n`,_jsxs(_components.p,{children:[`O ambiente de Sandbox é o ponto de entrada para testar a integração sem impacto financeiro. Para testar, use uma das `,_jsx(_components.a,{href:`/autenticacao/chaves-teste`,children:`chaves de teste do Sandbox`}),`: escolha uma conta e envie os valores nos headers `,_jsx(_components.code,{children:`x-delbank-api-key`}),` e `,_jsx(_components.code,{children:`x-delfinance-account-id`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Para Produção, contrate a API no internet banking. A contratação gera a chave de API, o account-id e o certificado mTLS. Veja o passo a passo em `,_jsx(_components.a,{href:`/iniciacao/contratar-api`,children:`Contratar a API`}),`.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Nunca compartilhe sua API Key, Account ID ou chave privada do certificado em repositórios públicos.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`3-urls-base-e-headers-padrão`,children:`3. URLs base e headers padrão`}),`\n`,_jsx(_components.p,{children:`Antes de fazer a primeira chamada, vale conhecer os endpoints e os headers que a API espera.`}),`\n`,_jsx(Heading,{level:`3`,id:`urls-base`,children:`URLs base`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Ambiente`}),_jsx(_components.th,{children:`URL base`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sandbox`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://apisandbox.delbank.com.br`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Produção`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://api.delbank.com.br`})})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`headers-padrão`,children:`Headers padrão`}),`\n`,_jsx(_components.p,{children:`Os headers abaixo são parte do modelo atual de integração:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cabeçalho`}),_jsx(_components.th,{children:`Obrigatório`}),_jsx(_components.th,{children:`Descrição`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-delbank-api-key`})}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Chave de API da integração`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-delfinance-account-id`})}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:`Identificador da conta`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:`Sim`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`IdempotencyKey`})}),_jsx(_components.td,{children:`Em operações de cashout`}),_jsx(_components.td,{children:`Chave única de idempotência`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`próximo-passo`,children:`Próximo passo`}),`\n`,_jsxs(_components.p,{children:[`Após validar sua integração no Sandbox, o próximo passo é preparar a operação em Produção. Para entender melhor esse processo e o que muda na transição, consulte a página `,_jsx(_components.a,{href:`/iniciacao/ida-producao`,children:`Ida para Produção`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`4-fazendo-a-primeira-requisição`,children:`4. Fazendo a primeira requisição`}),`\n`,_jsx(_components.p,{children:`Com a sua API Key e o Account ID em mãos, você já consegue chamar a API no ambiente de Sandbox.`}),`\n`,_jsx(Heading,{level:`3`,id:`passo-a-envie-as-credenciais-da-api`,children:`Passo A: Envie as credenciais da API`}),`\n`,_jsx(_components.p,{children:`Use os headers abaixo para autenticar a requisição:`}),`\n`,_jsx(CodeBlock,{filename:``,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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://apisandbox.delbank.com.br/v1/accounts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-delbank-api-key: SUA_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-delfinance-account-id: SUA_ACCOUNT_ID\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`passo-b-revise-as-regras-de-segurança-antes-de-avançar`,children:`Passo B: Revise as regras de segurança antes de avançar`}),`\n`,_jsxs(_components.p,{children:[`Antes de migrar para Produção, revise as boas práticas e os componentes de segurança da integração na página `,_jsx(_components.a,{href:`/autenticacao/credenciais`,children:`Autenticação e segurança`}),`.`]})]})}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":"Primeiros passos","description":"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição","icon":"play","href":"/iniciacao/primeiros-passos"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Ambientes: Sandbox vs Produção","slug":"1-ambientes-sandbox-vs-produção","depth":2,"children":[]},{"title":"2. Configurando seu Ambiente de Sandbox","slug":"2-configurando-seu-ambiente-de-sandbox","depth":2,"children":[]},{"title":"3. URLs base e headers padrão","slug":"3-urls-base-e-headers-padrão","depth":2,"children":[{"title":"URLs base","slug":"urls-base","depth":3,"children":[]},{"title":"Headers padrão","slug":"headers-padrão","depth":3,"children":[]},{"title":"Próximo passo","slug":"próximo-passo","depth":3,"children":[]}]},{"title":"4. Fazendo a primeira requisição","slug":"4-fazendo-a-primeira-requisição","depth":2,"children":[{"title":"Passo A: Envie as credenciais da API","slug":"passo-a-envie-as-credenciais-da-api","depth":3,"children":[]},{"title":"Passo B: Revise as regras de segurança antes de avançar","slug":"passo-b-revise-as-regras-de-segurança-antes-de-avançar","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"delfinance","siteName":"Delfinance","title":"Primeiros passos - Delfinance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T22:41:17.357Z","originalFileLocation":"iniciacao/primeiros-passos.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\">\u003cmeta data-mint-head name=\"application-name\" content=\"Delfinance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://conta.delfinance.com.br/icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://conta.delfinance.com.br/icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://conta.delfinance.com.br/icon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://conta.delfinance.com.br/icon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Primeiros passos - Delfinance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Delfinance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.delfinance.com.br/iniciacao/primeiros-passos\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://delfinance.mintlify.site/_mintlify/api/og/v2?division=Introdu%C3%A7%C3%A3o\u0026amp;title=Primeiros+passos\u0026amp;description=Configure+seus+ambientes%2C+obtenha+suas+credenciais+e+fa%C3%A7a+sua+primeira+requisi%C3%A7%C3%A3o\u0026amp;theme=53b2d4423d14b78b743ce0a4\u0026amp;signature=1bc257d06d77567a9120ca83950909e443661d9eae8fb279cbc77c608aa894f7\">\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=\"Primeiros passos - Delfinance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://delfinance.mintlify.site/_mintlify/api/og/v2?division=Introdu%C3%A7%C3%A3o\u0026amp;title=Primeiros+passos\u0026amp;description=Configure+seus+ambientes%2C+obtenha+suas+credenciais+e+fa%C3%A7a+sua+primeira+requisi%C3%A7%C3%A3o\u0026amp;theme=53b2d4423d14b78b743ce0a4\u0026amp;signature=1bc257d06d77567a9120ca83950909e443661d9eae8fb279cbc77c608aa894f7\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/delfinance/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Delfinance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1A941A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.delfinance.com.br/iniciacao/primeiros-passos\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/iniciacao/primeiros-passos.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.delfinance.com.br/#organization\",\"name\":\"Delfinance\",\"url\":\"https://docs.delfinance.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://conta.delfinance.com.br/assets/delfinance-dark-CehGtYbD.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.delfinance.com.br#website\",\"name\":\"Delfinance\",\"url\":\"https://docs.delfinance.com.br\",\"publisher\":{\"@id\":\"https://docs.delfinance.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos#webpage\",\"url\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos\",\"name\":\"Primeiros passos\",\"description\":\"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\",\"dateModified\":\"2026-11-04T22:41:17.357Z\",\"isPartOf\":{\"@id\":\"https://docs.delfinance.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Introdução\",\"item\":\"https://docs.delfinance.com.br/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Primeiros passos\",\"item\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos#article\",\"headline\":\"Primeiros passos\",\"name\":\"Primeiros passos\",\"description\":\"Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição\",\"url\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos\",\"mainEntityOfPage\":{\"@id\":\"https://docs.delfinance.com.br/iniciacao/primeiros-passos#webpage\"},\"dateModified\":\"2026-11-04T22:41:17.357Z\",\"publisher\":{\"@id\":\"https://docs.delfinance.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.delfinance.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Delfinance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Delfinance","nav":{"global":null,"tabs":[{"tab":"Como integrar","groups":[{"group":"Introdução","pages":[{"title":"Visão Geral","description":"Introdução rápida à documentação da Delfinance e ao fluxo de integração","icon":"home","href":""},{"title":"Primeiros passos","icon":"play","href":"/iniciacao/primeiros-passos"},{"title":"Contratar a API","description":"Contrate a API pelo internet banking e obtenha a chave de API, o account-id e o certificado mTLS de Produção","icon":"file-signature","href":"/iniciacao/contratar-api"},{"title":"Ida para Produção","icon":"rocket","href":"/iniciacao/ida-producao"},{"title":"Idempotência","icon":"repeat","href":"/iniciacao/idempotencia"}]},{"group":"Autenticação","pages":[{"title":"Credenciais","icon":"key","href":"/autenticacao/credenciais"},{"title":"mTLS","icon":"lock","href":"/autenticacao/mtls"},{"title":"Exemplos de Conexão","sidebarTitle":"Exemplos de Conexão","icon":"code","href":"/autenticacao/exemplos-conexao"},{"title":"Filtros de IPs","icon":"shield-check","href":"/autenticacao/filtros-ip"},{"title":"Chaves de Teste","icon":"flask","href":"/autenticacao/chaves-teste"}]},{"group":"Receber via Pix (Pix Cash-in)","pages":[{"title":"Receber via Pix","sidebarTitle":"Visão geral","icon":"qrcode","href":"/guias/pix/receber-pix/visao-geral"},{"title":"Gerenciar Chave Pix","sidebarTitle":"Chave Pix","icon":"key","href":"/guias/pix/receber-pix/chave-pix"},{"title":"Cobrança Reutilizável (QR Code Estático)","sidebarTitle":"Cobrança reutilizável","icon":"repeat","href":"/guias/pix/receber-pix/cobranca-reutilizavel"},{"title":"Cobrança Imediata (QR Code Dinâmico)","sidebarTitle":"Cobrança imediata","icon":"bolt","href":"/guias/pix/receber-pix/cobranca-imediata"},{"title":"Cobrança com Vencimento (QR Code cobv)","sidebarTitle":"Cobrança com vencimento","icon":"calendar-clock","href":"/guias/pix/receber-pix/cobranca-com-vencimento"},{"title":"Devolver um Pix Recebido","sidebarTitle":"Devolver Pix recebido","icon":"rotate-left","href":"/guias/pix/receber-pix/devolucao"},{"title":"Comprovante de Transação","sidebarTitle":"Comprovante","icon":"receipt","href":"/guias/pix/comprovante"},{"title":"Simulação de Pagamento","sidebarTitle":"Simular pagamento","icon":"flask","href":"/guias/pix/receber-pix/simulacao-pagamento"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","icon":"circle-exclamation","href":"/guias/pix/receber-pix/troubleshooting"}]},{"group":"Pagar via Pix (Pix Cash-out)","pages":[{"title":"Pagar via Pix","sidebarTitle":"Visão geral","icon":"paper-plane","href":"/guias/pix/pagar-pix/visao-geral"},{"title":"Pagar via Chave Pix","sidebarTitle":"Por chave Pix","icon":"key","href":"/guias/pix/pagar-pix/por-chave"},{"title":"Pagar via Dados Bancários","sidebarTitle":"Por dados bancários","icon":"building-columns","href":"/guias/pix/pagar-pix/por-dados-bancarios"},{"title":"Pagar via QR Code","sidebarTitle":"Por QR Code","icon":"qrcode","href":"/guias/pix/pagar-pix/por-qrcode"},{"title":"Consultar Pagamento","sidebarTitle":"Consultar pagamento","icon":"magnifying-glass","href":"/guias/pix/pagar-pix/consultar-pagamento"},{"title":"Comprovante de Transação","sidebarTitle":"Comprovante","icon":"receipt","href":"/guias/pix/comprovante"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","icon":"circle-exclamation","href":"/guias/pix/pagar-pix/troubleshooting"}]},{"group":"Pix Automático","tag":"BETA","pages":[{"title":"Pix Automático","sidebarTitle":"Visão geral","icon":"arrows-rotate","tag":"BETA","href":"/guias/pix/pix-automatico/visao-geral"},{"title":"Regras e Prazos do Pix Automático","sidebarTitle":"Regras e prazos","icon":"clock","tag":"BETA","href":"/guias/pix/pix-automatico/regras-e-prazos"},{"title":"Jornada 1: Solicitação de Autorização","sidebarTitle":"Jornada 1: solicitação no app","icon":"mobile-screen","tag":"BETA","href":"/guias/pix/pix-automatico/jornada-1-solicitacao"},{"title":"Jornada 2: QR Code de Autorização","sidebarTitle":"Jornada 2: QR Code de autorização","icon":"qrcode","tag":"BETA","href":"/guias/pix/pix-automatico/jornada-2-qrcode"},{"title":"Jornada 3: Pagamento Imediato e Autorização","sidebarTitle":"Jornada 3: pagamento + autorização","icon":"bolt","tag":"BETA","href":"/guias/pix/pix-automatico/jornada-3-pagamento-imediato"},{"title":"Jornada 4: Pagamento com Oferta de Adesão","sidebarTitle":"Jornada 4: pagamento + oferta","icon":"file-invoice","tag":"BETA","href":"/guias/pix/pix-automatico/jornada-4-oferta"},{"title":"Consultar Autorizações e Agendamentos","sidebarTitle":"Consultar autorizações e agendamentos","icon":"magnifying-glass","tag":"BETA","href":"/guias/pix/pix-automatico/consultar"},{"title":"Cancelar Autorização ou Agendamento","sidebarTitle":"Cancelar","icon":"ban","tag":"BETA","href":"/guias/pix/pix-automatico/cancelar"},{"title":"Pix Automático na Conta Pagadora","sidebarTitle":"Lado do pagador","icon":"user-check","tag":"BETA","href":"/guias/pix/pix-automatico/pagador"}]},{"group":"Pagar via TED (TED Cash-out)","pages":[{"title":"Pagar via TED","sidebarTitle":"Visão geral","icon":"building-columns","href":"/guias/ted/pagar-ted/visao-geral"},{"title":"Enviar TED","sidebarTitle":"Enviar TED","icon":"paper-plane","href":"/guias/ted/pagar-ted/enviar-ted"},{"title":"Consultar Pagamento","sidebarTitle":"Consultar pagamento","icon":"magnifying-glass","href":"/guias/ted/pagar-ted/consultar-pagamento"}]},{"group":"Pagar boletos e contas (Cash-out)","pages":[{"title":"Pagar boletos e contas","sidebarTitle":"Visão geral","icon":"barcode","href":"/guias/pagamento-contas/visao-geral"},{"title":"Consultar boleto ou conta","sidebarTitle":"Consultar boleto ou conta","icon":"magnifying-glass","href":"/guias/pagamento-contas/consultar"},{"title":"Pagar boleto ou conta","sidebarTitle":"Pagar","icon":"paper-plane","href":"/guias/pagamento-contas/pagar"},{"title":"Troubleshooting","sidebarTitle":"Troubleshooting","icon":"circle-exclamation","href":"/guias/pagamento-contas/troubleshooting"}]},{"group":"Cobranças via Boleto","pages":[{"title":"Cobranças via Boleto","sidebarTitle":"Visão geral","icon":"barcode","href":"/guias/boleto/visao-geral"},{"title":"Emitir Boleto","sidebarTitle":"Emitir boleto","icon":"plus","href":"/guias/boleto/emitir-boleto"},{"title":"Consultar Boleto","sidebarTitle":"Consultar boleto","icon":"magnifying-glass","href":"/guias/boleto/consultar-boleto"},{"title":"Consultar Pagamentos","sidebarTitle":"Consultar pagamentos","icon":"money-check-dollar","href":"/guias/boleto/consultar-pagamento"},{"title":"Gerenciar Boleto","sidebarTitle":"Gerenciar boleto","icon":"sliders","href":"/guias/boleto/gerenciar-boleto"},{"title":"Simular Pagamento de Boleto","sidebarTitle":"Simular pagamento","icon":"flask","href":"/guias/boleto/simulacao-pagamento"}]},{"group":"Split de Pagamentos","pages":[{"title":"Split de Pagamentos","sidebarTitle":"Visão geral","icon":"arrows-split-up-and-left","href":"/guias/split-pagamentos/visao-geral"},{"title":"Configurar o split padrão da conta","sidebarTitle":"Configurar split padrão","icon":"gear","href":"/guias/split-pagamentos/configurar"},{"title":"Split por cobrança (QR Code)","sidebarTitle":"Split por cobrança","icon":"qrcode","href":"/guias/split-pagamentos/split-por-cobranca"},{"title":"Cadastro de beneficiários","sidebarTitle":"Cadastro de beneficiários","icon":"address-book","tag":"BETA","href":"/guias/split-pagamentos/beneficiarios"},{"title":"Acompanhar repasses","sidebarTitle":"Acompanhar repasses","icon":"list-check","tag":"BETA","href":"/guias/split-pagamentos/acompanhar-repasses"},{"title":"Status do repasse","sidebarTitle":"Status do repasse","icon":"diagram-project","tag":"BETA","href":"/guias/split-pagamentos/status-do-repasse"},{"title":"Split para marketplaces","sidebarTitle":"Guia para marketplaces","icon":"store","tag":"BETA","href":"/guias/split-pagamentos/marketplace"},{"title":"Consultar o split padrão da conta","sidebarTitle":"Consultar split padrão","icon":"magnifying-glass","href":"/guias/split-pagamentos/consultar"},{"title":"Remover o split padrão da conta","sidebarTitle":"Remover split padrão","icon":"trash","href":"/guias/split-pagamentos/remover"},{"title":"Ordens de Split de Pagamentos","sidebarTitle":"Ordens","icon":"receipt","href":"/guias/split-pagamentos/ordens"}]},{"group":"Saldo e extrato","pages":[{"title":"Consultar Saldo","sidebarTitle":"Saldo","icon":"wallet","href":"/guias/conta/saldo"},{"title":"Consultar Extrato","sidebarTitle":"Extrato","icon":"list","href":"/guias/conta/extrato"},{"title":"Extrato Periódico","sidebarTitle":"Extrato periódico","icon":"file-csv","href":"/guias/conta/extrato-periodico"},{"title":"Comprovante de Transação","sidebarTitle":"Comprovante","icon":"receipt","href":"/guias/pix/comprovante"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","sidebarTitle":"Visão geral","icon":"webhook","href":"/guias/webhooks/visao-geral"},{"title":"Webhooks Pix","sidebarTitle":"Pix","icon":"pix","href":"/guias/webhooks/pix"},{"title":"Webhooks Boleto","sidebarTitle":"Boleto","icon":"barcode","href":"/guias/webhooks/boleto"},{"title":"MEDs","sidebarTitle":"MEDs","icon":"triangle-exclamation","href":"/guias/webhooks/meds"}]}]},{"tab":"Pix","pages":[{"title":"Pix","href":"/guias/pix"}]},{"tab":"Boleto","pages":[{"title":"Boleto","href":"/guias/boleto"}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/guias/webhooks"}]},{"tab":"Referência API","pages":[{"title":"Referência API","href":"/api-reference/introducao"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/visao-geral"}]},{"tab":"IA 🆕","pages":[{"title":"IA 🆕","href":"/iniciacao/contexto-ia"}]}]},"basePath":"","title":"Primeiros passos - Delfinance","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":[],"chunks":[]}