Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.
A Bunni Pay exige o cabeçalho Idempotency-Key ao criar cobranças Pix, rascunhos de links, saques e checkouts. Esse mecanismo evita duplicacao de intencoes quando uma requisicao é repetida por falha de rede ou timeout.
Regras do Idempotency-Key
O valor deve ter entre 8 e 128 caracteres.
A chave identifica uma intenção: preserve a mesma chave, o mesmo corpo e a mesma credencial em uma repeticao.
Nao crie outra chave para tentar resolver um resultado incerto.
Conflitos de idempotência retornam HTTP 409.
Nao ha fallback automatico de provedora.
Onde usar
Rota
Cabeçalho
POST /v1/payments
Obrigatório
POST /v1/payment-links
Obrigatório
POST /v1/payouts
Obrigatório
POST /public/payment-links/{slug}/checkout
Obrigatório
Comportamento por rota
Cobranças Pix
POST /v1/payments registra a intencao antes de chamar a provedora.
Mesma chave e mesmo corpo: retorna a intencao persistida e, quando disponível, a resposta original de emissao.
Mesma chave e corpo diferente: 409 IDEMPOTENCY_CONFLICT.
Intencao ainda em processamento: 409 PAYMENT_IN_PROGRESS; aguarde e mantenha os mesmos dados.
Rascunhos de link
POST /v1/payment-links persiste a chave junto com o rascunho.
Mesma chave e mesmo corpo: retorna o rascunho ja criado.
Mesma chave e corpo diferente: 409 IDEMPOTENCY_CONFLICT.
Saques Pix
POST /v1/payouts exige Idempotency-Key para evitar duplicacao de solicitacoes de saque.
Confirmação financeira
HTTP 200 na criacao confirma que a intencao foi persistida, mas nao confirma entrega de dinheiro.
Um pagamento so esta confirmado no estado paid. Um saque so esta confirmado no estado completed. Estados como pending, processing e unknown nao confirmam entrega de dinheiro.
As consultas individuais de pagamento, Pix, checkout e saque sincronizam a situacao com a provedora. Listagens e indicadores leem o estado persistido. Nao é necessário configurar webhook para consultar a situacao.
Falhas de comunicacao
Timeout ou erro 5xx nao comprovam o resultado financeiro. Quando ja tiver o identificador do recurso, consulte-o diretamente em vez de gerar uma nova intencao automaticamente.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bunni Pay","description":"Documentação da API Bunni Pay: autenticação, pagamentos Pix, carteiras, links e relatórios.","colors":{"primary":"#FF5E8E","light":"#FF7AA2","dark":"#E0457A"},"logo":{"light":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/light.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=d824344959ade8bac02a0f55341c3df2","dark":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/dark.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=70ee9d3475ce2eb0dd0f8c1e18a11422","href":"/index"},"favicon":"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/images/bunni.jpg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=ef6ffec6ebacbff04502977c2b0ef671","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"],"prefill":false,"autogenerate":true},"mdx":{"auth":{"method":"key","name":"X-API-Key"},"server":"https://api.bunnipay.com.br"}},"appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0B"}},"navbar":{"links":[{"href":"https://app.bunnipay.com.br","label":"Dashboard"},{"href":"/mcp-server","label":"MCP Server"},{"href":"/llms.txt","label":"llms.txt"}],"primary":{"type":"button","label":"Começar agora","href":"https://app.bunnipay.com.br/sign-up"}},"search":{"prompt":"Buscar na documentação..."},"seo":{"metatags":{"canonical":"https://docs.bunnipay.com.br","og:locale":"pt_BR","og:site_name":"Bunni Pay — Documentação","twitter:card":"summary_large_image","robots":"index, follow, max-image-preview:large"},"indexing":"navigable"},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}},"latex":false},"contextual":{"options":["copy","view","mcp","add-mcp","cursor","vscode","claude","chatgpt"],"display":"header"},"thumbnails":{"preset":"minimal","appearance":"dark","surface":"neutral"},"interaction":{"drilldown":false},"markdown":{"schema":true,"instructions":["Consulte o contrato Bunni antes de sugerir chamadas. Valores monetários são inteiros em centavos. Não invente endpoints ou respostas de sucesso para recursos ainda indisponíveis. Nunca solicite chaves reais no chat nem exponha credenciais no cliente."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bunnipaybr","hasAudioNarration":false,"actualSubdomain":"bunnipaybr","customDomains":["docs.bunnipay.com.br"],"gitSource":{"type":"artifacts","owner":"prod","repo":"6af651438e91e5115ee886d0","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af652078e91e5115ee8957c"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe0ffda594ac7d9eb59dd3","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"Guias","count":12},{"language":"default","tag":"Relatórios","count":6},{"language":"default","tag":"Introdução","count":6},{"language":"default","tag":"Conta","count":5},{"language":"default","tag":"MCP","count":4},{"language":"default","tag":"Links de pagamento","count":4},{"language":"default","tag":"PIX","count":4},{"language":"default","tag":"Saques Pix","count":4},{"language":"default","tag":"Checkout público","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--bunni-pink: #ff5e8e;--bunni-pink-soft: rgba(255, 94, 142, 0.12);--bunni-border: rgba(255, 255, 255, 0.06)}#navbar{background:rgba(10, 10, 11, 0.85)!important;backdrop-filter:blur(12px);border-bottom:1px solid var(--bunni-border)!important}#navbar a:hover{color:var(--bunni-pink)!important}.nav-tabs-item[data-active=\"true\"],.nav-tabs a[aria-current=\"page\"]{color:#fff!important;border-bottom-color:var(--bunni-pink)!important}#sidebar,#sidebar-content{background:#0a0a0b!important;border-right:1px solid var(--bunni-border)}#sidebar .sidebar-group-header,#sidebar h5{color:#8a8a93!important;font-size:0.72rem;letter-spacing:0.08em;text-transform:uppercase}#sidebar a{border-radius:10px;color:#b4b4bd;transition:background 0.15s, color 0.15s}#sidebar a:hover{background:rgba(255, 255, 255, 0.04);color:#fff}#sidebar a[aria-current=\"page\"],#sidebar li[data-active=\"true\"]>a{background:var(--bunni-pink-soft)!important;color:var(--bunni-pink)!important;font-weight:500}.method-pill-get,[data-method=\"GET\"],.bg-green-400\\/20{background:var(--bunni-pink-soft)!important;color:var(--bunni-pink)!important}#content-area a:not(.card):not([class*=\"button\"]){text-decoration-color:rgba(255, 94, 142, 0.4)}.card{border-color:var(--bunni-border)!important;background:#111114!important;border-radius:16px!important}.card:hover{border-color:rgba(255, 94, 142, 0.5)!important}pre,.code-block{background:#0f0f12!important;border:1px solid var(--bunni-border)!important;border-radius:14px!important}::selection{background:rgba(255, 94, 142, 0.35)}"}],"page":{"pagePath":"idempotency","slug":"/idempotency","pageMetadata":{"title":"Idempotência","description":"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.","sidebarTitle":"Idempotência","icon":"repeat","href":"/idempotency"},"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: \"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\"\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`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A Bunni Pay exige o cabeçalho `,_jsx(_components.code,{children:`Idempotency-Key`}),` ao criar cobranças Pix, rascunhos de links, saques e checkouts. Esse mecanismo evita duplicacao de intencoes quando uma requisicao é repetida por falha de rede ou timeout.`]}),`\n`,_jsx(Heading,{level:`2`,id:`regras-do-idempotency-key`,children:`Regras do Idempotency-Key`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`O valor deve ter entre `,_jsx(_components.strong,{children:`8 e 128 caracteres`}),`.`]}),`\n`,_jsx(_components.li,{children:`A chave identifica uma intenção: preserve a mesma chave, o mesmo corpo e a mesma credencial em uma repeticao.`}),`\n`,_jsx(_components.li,{children:`Nao crie outra chave para tentar resolver um resultado incerto.`}),`\n`,_jsx(_components.li,{children:`Conflitos de idempotência retornam HTTP 409.`}),`\n`,_jsx(_components.li,{children:`Nao ha fallback automatico de provedora.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`onde-usar`,children:`Onde usar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Rota`}),_jsx(_components.th,{children:`Cabeçalho`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/payments`})}),_jsx(_components.td,{children:`Obrigatório`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/payment-links`})}),_jsx(_components.td,{children:`Obrigatório`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/payouts`})}),_jsx(_components.td,{children:`Obrigatório`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /public/payment-links/{slug}/checkout`})}),_jsx(_components.td,{children:`Obrigatório`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`comportamento-por-rota`,children:`Comportamento por rota`}),`\n`,_jsx(Heading,{level:`3`,id:`cobranças-pix`,children:`Cobranças Pix`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v1/payments`}),` registra a intencao antes de chamar a provedora.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Mesma chave e mesmo corpo: retorna a intencao persistida e, quando disponível, a resposta original de emissao.`}),`\n`,_jsxs(_components.li,{children:[`Mesma chave e corpo diferente: `,_jsx(_components.code,{children:`409 IDEMPOTENCY_CONFLICT`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Intencao ainda em processamento: `,_jsx(_components.code,{children:`409 PAYMENT_IN_PROGRESS`}),`; aguarde e mantenha os mesmos dados.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`rascunhos-de-link`,children:`Rascunhos de link`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v1/payment-links`}),` persiste a chave junto com o rascunho.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Mesma chave e mesmo corpo: retorna o rascunho ja criado.`}),`\n`,_jsxs(_components.li,{children:[`Mesma chave e corpo diferente: `,_jsx(_components.code,{children:`409 IDEMPOTENCY_CONFLICT`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`saques-pix`,children:`Saques Pix`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`POST /v1/payouts`}),` exige `,_jsx(_components.code,{children:`Idempotency-Key`}),` para evitar duplicacao de solicitacoes de saque.`]}),`\n`,_jsx(Heading,{level:`2`,id:`confirmação-financeira`,children:`Confirmação financeira`}),`\n`,_jsxs(_components.p,{children:[`HTTP 200 na criacao confirma que a intencao foi persistida, mas `,_jsx(_components.strong,{children:`nao confirma entrega de dinheiro`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Um pagamento so esta confirmado no estado `,_jsx(_components.code,{children:`paid`}),`. Um saque so esta confirmado no estado `,_jsx(_components.code,{children:`completed`}),`. Estados como `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`processing`}),` e `,_jsx(_components.code,{children:`unknown`}),` nao confirmam entrega de dinheiro.`]})}),`\n`,_jsx(_components.p,{children:`As consultas individuais de pagamento, Pix, checkout e saque sincronizam a situacao com a provedora. Listagens e indicadores leem o estado persistido. Nao é necessário configurar webhook para consultar a situacao.`}),`\n`,_jsx(Heading,{level:`2`,id:`falhas-de-comunicacao`,children:`Falhas de comunicacao`}),`\n`,_jsx(_components.p,{children:`Timeout ou erro 5xx nao comprovam o resultado financeiro. Quando ja tiver o identificador do recurso, consulte-o diretamente em vez de gerar uma nova intencao automaticamente.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}},"config":{},"pageMetadata":{"title":"Idempotência","description":"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.","sidebarTitle":"Idempotência","icon":"repeat","href":"/idempotency"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Regras do Idempotency-Key","slug":"regras-do-idempotency-key","depth":2,"children":[]},{"title":"Onde usar","slug":"onde-usar","depth":2,"children":[]},{"title":"Comportamento por rota","slug":"comportamento-por-rota","depth":2,"children":[{"title":"Cobranças Pix","slug":"cobranças-pix","depth":3,"children":[]},{"title":"Rascunhos de link","slug":"rascunhos-de-link","depth":3,"children":[]},{"title":"Saques Pix","slug":"saques-pix","depth":3,"children":[]}]},{"title":"Confirmação financeira","slug":"confirmação-financeira","depth":2,"children":[]},{"title":"Falhas de comunicacao","slug":"falhas-de-comunicacao","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bunnipaybr","siteName":"Bunni Pay","title":"Idempotência - Bunni Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T00:35:03.323Z","originalFileLocation":"idempotency.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bunni Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow, max-image-preview:large\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_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/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Idempotência - Bunni Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bunni Pay — Documentação\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bunnipay.com.br/idempotency\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bunnipaybr.mintlify.site/_mintlify/api/og/v2?division=Introdu%C3%A7%C3%A3o\u0026amp;title=Idempot%C3%AAncia\u0026amp;description=Regras+de+Idempotency-Key+e+como+confirmar+o+resultado+financeiro+de+cobran%C3%A7as+e+saques.\u0026amp;theme=26b772f5e0da02d5daa64c70\u0026amp;signature=4a804a1cc94aa250a4e617f56361c10301a9ce82db5b2a78898de9767efe82fa\">\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=\"Idempotência - Bunni Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bunnipaybr.mintlify.site/_mintlify/api/og/v2?division=Introdu%C3%A7%C3%A3o\u0026amp;title=Idempot%C3%AAncia\u0026amp;description=Regras+de+Idempotency-Key+e+como+confirmar+o+resultado+financeiro+de+cobran%C3%A7as+e+saques.\u0026amp;theme=26b772f5e0da02d5daa64c70\u0026amp;signature=4a804a1cc94aa250a4e617f56361c10301a9ce82db5b2a78898de9767efe82fa\">\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/bunnipaybr/s5WbNWD_L2dwHJHE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bunni Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5E8E\">\u003cmeta data-mint-head name=\"og:locale\" content=\"pt_BR\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bunnipay.com.br/idempotency\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/idempotency.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bunnipay.com.br/#organization\",\"name\":\"Bunni Pay\",\"url\":\"https://docs.bunnipay.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bunnipaybr/OBxipp_5Heqx0S4k/logo/light.svg?fit=max\u0026auto=format\u0026n=OBxipp_5Heqx0S4k\u0026q=85\u0026s=d824344959ade8bac02a0f55341c3df2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bunnipay.com.br#website\",\"name\":\"Bunni Pay\",\"url\":\"https://docs.bunnipay.com.br\",\"publisher\":{\"@id\":\"https://docs.bunnipay.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bunnipay.com.br/idempotency#webpage\",\"url\":\"https://docs.bunnipay.com.br/idempotency\",\"name\":\"Idempotência\",\"description\":\"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\",\"dateModified\":\"2026-11-18T00:35:03.323Z\",\"isPartOf\":{\"@id\":\"https://docs.bunnipay.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bunnipay.com.br/idempotency#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bunnipay.com.br/idempotency#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Introdução\",\"item\":\"https://docs.bunnipay.com.br/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Idempotência\",\"item\":\"https://docs.bunnipay.com.br/idempotency\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bunnipay.com.br/idempotency#article\",\"headline\":\"Idempotência\",\"name\":\"Idempotência\",\"description\":\"Regras de Idempotency-Key e como confirmar o resultado financeiro de cobranças e saques.\",\"url\":\"https://docs.bunnipay.com.br/idempotency\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bunnipay.com.br/idempotency#webpage\"},\"dateModified\":\"2026-11-18T00:35:03.323Z\",\"publisher\":{\"@id\":\"https://docs.bunnipay.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bunnipay.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bunni Pay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bunni Pay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/idempotency.md","siteName":"Bunni Pay","nav":{"global":null,"tabs":[{"tab":"Guias","icon":"book-open","groups":[{"group":"Introdução","pages":[{"title":"Autenticação","description":"Como usar X-API-Key, os 9 escopos disponíveis e como gerenciar chaves no painel da Bunni Pay.","sidebarTitle":"Autenticação","icon":"key-round","href":"/authentication"},{"title":"Idempotência","sidebarTitle":"Idempotência","icon":"repeat","href":"/idempotency"},{"title":"Erros","description":"Entenda o envelope JSON success/data/error/requestId e os códigos HTTP da API Bunni Pay.","sidebarTitle":"Erros","icon":"triangle-alert","href":"/errors"},{"title":"Limites e tarifas","sidebarTitle":"Limites e tarifas","icon":"gauge","href":"/limits-fees"}]},{"group":"Conta","pages":[{"title":"Conta","href":"/account"},{"title":"Carteiras","href":"/wallets"}]},{"group":"Pix","pages":[{"title":"Cobranças Pix","icon":"qr-code","href":"/api-reference/payments"},{"title":"Saques Pix","icon":"banknote","href":"/api-reference/payouts"}]},{"group":"Loja","pages":[{"title":"Links e checkout","icon":"link","href":"/api-reference/payment-links"}]},{"group":"Relatórios","pages":[{"title":"Extrato","icon":"receipt-text","href":"/api-reference/statement"},{"title":"Estatísticas","icon":"chart-line","href":"/api-reference/analytics"},{"title":"Pagadores e bancos","icon":"users","href":"/api-reference/customers"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/routes"}]},{"tab":"MCP","icon":"bot","pages":[{"title":"MCP","href":"/mcp-server"}]}]},"basePath":"","title":"Idempotência - Bunni Pay","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}