O refund-in é a devolução de um recebimento Pix (cash-in). Pode ser total ou parcial, com múltiplas devoluções parciais enquanto o saldo disponível permitir.
O path POST /api/pix/refund-in/{id} exige o UUID do cash-in (campo id retornado no 201 de POST /api/pix/cash-in). Não use o transactionId do parceiro BaaS.
Você pode fazer múltiplas devoluções parciais sobre o mesmo cash-in, desde que a soma total não ultrapasse o valor original.Exemplo: cash-in de R300,00.Devoluc\ca~oparcial1:R 100,00. Devolução parcial 2: R$ 200,00.A plataforma verifica o teto considerando tanto as devoluções CONFIRMED quanto as PENDING. Se houver devoluções pendentes que somam ao máximo, novas devoluções serão rejeitadas (422).
Atenção à semântica de event.id: no evento pix_cash_in_reversal, event.id é o UUID do cash-in original, não o UUID do refund-in. O event.external_id é o externalId do refund-in.
Chave de idempotência recomendada:event_type + transaction_id + end_to_end_id do estorno. Evita colisão entre devoluções parciais do mesmo cash-in.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ClearPago","description":"Documentação oficial da API Pix ClearPago — integração, referência e operações.","colors":{"primary":"#0f766e"},"logo":{"light":"https://mintcdn.com/clearpago/mSJ86kniaUbCKbT4/logo_lightmode.png?fit=max\u0026auto=format\u0026n=mSJ86kniaUbCKbT4\u0026q=85\u0026s=874e04286f63996eee39a525d0e88605","dark":"https://mintcdn.com/clearpago/mSJ86kniaUbCKbT4/logo_darkmode.png?fit=max\u0026auto=format\u0026n=mSJ86kniaUbCKbT4\u0026q=85\u0026s=b1d1e55f3c47423ae78c56d021c837f6"},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"clearpago","hasAudioNarration":false,"actualSubdomain":"clearpago","customDomains":["docs.clearpago.com"],"gitSource":{"type":"github","owner":"europixgopay","repo":"doc-clearpago","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21b6e8b246900909733949","collectionId":"d62e408a-61dd-4644-a467-75b991618918","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21b6e8b246900909733949:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Referência de API","count":17},{"language":"default","tag":"Guias","count":8},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Conceitos","count":6},{"language":"default","tag":"Introdução","count":5},{"language":"default","tag":"Cash-out","count":4},{"language":"default","tag":"Cash-in","count":3},{"language":"default","tag":"Refund","count":3},{"language":"default","tag":"Erros","count":3},{"language":"default","tag":"Go-live","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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/refund-a-cash-in","slug":"/guides/refund-a-cash-in","pageMetadata":{"title":"Devolver um cash-in (Refund-in)","description":"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.","href":"/guides/refund-a-cash-in"},"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: \"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\"\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`,annotation:`annotation`,code:`code`,li:`li`,math:`math`,mi:`mi`,mn:`mn`,mo:`mo`,mover:`mover`,mrow:`mrow`,p:`p`,pre:`pre`,semantics:`semantics`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Mermaid,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`visão-geral`,children:`Visão geral`}),`\n`,_jsxs(_components.p,{children:[`O `,_jsx(_components.strong,{children:`refund-in`}),` é a devolução de um recebimento Pix (`,_jsx(_components.code,{children:`cash-in`}),`). Pode ser total ou parcial, com múltiplas devoluções parciais enquanto o saldo disponível permitir.`]}),`\n`,_jsx(Mermaid,{chart:`sequenceDiagram\n participant S as Seu sistema\n participant CP as ClearPago\n participant B as BaaS\n participant P as Pagador original\n\n S->>CP: POST /api/pix/refund-in/{id_do_cash_in}\n CP-->>S: 201 {id do refund, status:PENDING}\n CP->>B: Solicita devolução\n B-->>P: Pix de devolução\n B->>CP: CashInReversal (CONFIRMED)\n CP->>S: Webhook pix_cash_in_reversal`}),`\n`,_jsx(Heading,{level:`2`,id:`pré-requisitos`,children:`Pré-requisitos`}),`\n`,_jsx(_components.p,{children:`Antes de solicitar a devolução, verifique:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Condição`}),_jsx(_components.th,{children:`Detalhe`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Cash-in em `,_jsx(_components.code,{children:`PAID`})]}),_jsxs(_components.td,{children:[`Só é possível devolver recebimentos `,_jsx(_components.strong,{children:`confirmados`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Prazo`}),_jsxs(_components.td,{children:[`Máximo `,_jsx(_components.strong,{children:`89 dias`}),` após o recebimento.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Saldo disponível`}),_jsx(_components.td,{children:`A soma das devoluções (pendentes + confirmadas) não pode exceder o valor original recebido.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`identificadores-críticos`,children:`Identificadores críticos`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`O path `,_jsx(_components.code,{children:`POST /api/pix/refund-in/{id}`}),` exige o `,_jsx(_components.strong,{children:`UUID do cash-in`}),` (campo `,_jsx(_components.code,{children:`id`}),` retornado no `,_jsx(_components.code,{children:`201`}),` de `,_jsx(_components.code,{children:`POST /api/pix/cash-in`}),`). `,_jsx(_components.strong,{children:`Não use`}),` o `,_jsx(_components.code,{children:`transactionId`}),` do parceiro BaaS.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`criar-a-devolução`,children:`Criar a devolução`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.clearpago.com.br/api/pix/refund-in/a1b2c3d4-e5f6-7890-abcd-ef1234567890`}),_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 \u003cseu_api_token>\"`}),_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\"`}),_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-Correlation-ID: req-refund-001\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"refundValue\": 150.75,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"reason\": \"Pedido cancelado pelo cliente\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"externalId\": \"estorno-12345\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsxs(_components.strong,{children:[`Resposta `,_jsx(_components.code,{children:`201`}),`:`]})}),`\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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"d4e5f6a7-b8c9-0123-defa-234567890123\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PENDING\"`}),_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:` \"externalId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"estorno-12345\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Persista o `,_jsx(_components.code,{children:`id`}),` do refund`]}),` imediatamente. Ele é necessário para consultar o status com `,_jsx(_components.code,{children:`GET /api/pix/refund/{id}`}),` e para auditoria de devoluções parciais.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`campos`,children:`Campos`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Campo`}),_jsx(_components.th,{children:`Obrigatório`}),_jsx(_components.th,{children:`Notas`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refundValue`})}),_jsx(_components.td,{children:`Sim`}),_jsxs(_components.td,{children:[`Valor em `,_jsx(_components.strong,{children:`BRL`}),` a devolver. Pode ser menor que o original (devolução parcial).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reason`})}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Motivo da devolução (descritivo).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`externalId`})}),_jsx(_components.td,{children:`Não`}),_jsx(_components.td,{children:`Sua chave de negócio para o estorno. Recomendado para rastreio.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`devoluções-parciais`,children:`Devoluções parciais`}),`\n`,_jsx(_components.p,{children:`Você pode fazer múltiplas devoluções parciais sobre o mesmo cash-in, desde que a soma total não ultrapasse o valor original.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Exemplo:`}),` cash-in de R`,_jsxs(_components.span,{className:`katex`,children:[_jsx(_components.span,{className:`katex-mathml`,children:_jsx(_components.math,{xmlns:`http://www.w3.org/1998/Math/MathML`,children:_jsxs(_components.semantics,{children:[_jsxs(_components.mrow,{children:[_jsx(_components.mn,{children:`300`}),_jsx(_components.mo,{separator:`true`,children:`,`}),_jsx(_components.mn,{children:`00.`}),_jsx(_components.mi,{children:`D`}),_jsx(_components.mi,{children:`e`}),_jsx(_components.mi,{children:`v`}),_jsx(_components.mi,{children:`o`}),_jsx(_components.mi,{children:`l`}),_jsx(_components.mi,{children:`u`}),_jsxs(_components.mover,{accent:`true`,children:[_jsx(_components.mi,{children:`c`}),_jsx(_components.mo,{children:`\\\\c`})]}),_jsxs(_components.mover,{accent:`true`,children:[_jsx(_components.mi,{children:`a`}),_jsx(_components.mo,{children:`~`})]}),_jsx(_components.mi,{children:`o`}),_jsx(_components.mi,{children:`p`}),_jsx(_components.mi,{children:`a`}),_jsx(_components.mi,{children:`r`}),_jsx(_components.mi,{children:`c`}),_jsx(_components.mi,{children:`i`}),_jsx(_components.mi,{children:`a`}),_jsx(_components.mi,{children:`l`}),_jsx(_components.mn,{children:`1`}),_jsx(_components.mo,{children:`:`}),_jsx(_components.mi,{children:`R`})]}),_jsx(_components.annotation,{encoding:`application/x-tex`,children:` 300,00. Devolução parcial 1: R`})]})})}),_jsxs(_components.span,{className:`katex-html`,\"aria-hidden\":`true`,children:[_jsxs(_components.span,{className:`base`,children:[_jsx(_components.span,{className:`strut`,style:{height:`1em`,verticalAlign:`-0.25em`}}),_jsx(_components.span,{className:`mord`,children:`300`}),_jsx(_components.span,{className:`mpunct`,children:`,`}),_jsx(_components.span,{className:`mspace`,style:{marginRight:`0.1667em`}}),_jsx(_components.span,{className:`mord`,children:`00.`}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0278em`},children:`D`}),_jsx(_components.span,{className:`mord mathnormal`,children:`e`}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0359em`},children:`v`}),_jsx(_components.span,{className:`mord mathnormal`,children:`o`}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0197em`},children:`l`}),_jsx(_components.span,{className:`mord mathnormal`,children:`u`}),_jsx(_components.span,{className:`mord accent`,children:_jsxs(_components.span,{className:`vlist-t vlist-t2`,children:[_jsxs(_components.span,{className:`vlist-r`,children:[_jsxs(_components.span,{className:`vlist`,style:{height:`0.75em`},children:[_jsxs(_components.span,{style:{top:`-3em`},children:[_jsx(_components.span,{className:`pstrut`,style:{height:`3em`}}),_jsx(_components.span,{className:`mord mathnormal`,children:`c`})]}),_jsxs(_components.span,{style:{top:`-3em`},children:[_jsx(_components.span,{className:`pstrut`,style:{height:`3em`}}),_jsx(_components.span,{className:`accent-body`,style:{left:`-0.1944em`},children:_jsx(_components.span,{className:`mord`,children:`\\\\c`})})]})]}),_jsx(_components.span,{className:`vlist-s`,children:``})]}),_jsx(_components.span,{className:`vlist-r`,children:_jsx(_components.span,{className:`vlist`,style:{height:`0.25em`},children:_jsx(_components.span,{})})})]})}),_jsx(_components.span,{className:`mord accent`,children:_jsx(_components.span,{className:`vlist-t`,children:_jsx(_components.span,{className:`vlist-r`,children:_jsxs(_components.span,{className:`vlist`,style:{height:`0.6679em`},children:[_jsxs(_components.span,{style:{top:`-3em`},children:[_jsx(_components.span,{className:`pstrut`,style:{height:`3em`}}),_jsx(_components.span,{className:`mord mathnormal`,children:`a`})]}),_jsxs(_components.span,{style:{top:`-3.35em`},children:[_jsx(_components.span,{className:`pstrut`,style:{height:`3em`}}),_jsx(_components.span,{className:`accent-body`,style:{left:`-0.25em`},children:_jsx(_components.span,{className:`mord`,children:`~`})})]})]})})})}),_jsx(_components.span,{className:`mord mathnormal`,children:`o`}),_jsx(_components.span,{className:`mord mathnormal`,children:`p`}),_jsx(_components.span,{className:`mord mathnormal`,children:`a`}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0278em`},children:`r`}),_jsx(_components.span,{className:`mord mathnormal`,children:`c`}),_jsx(_components.span,{className:`mord mathnormal`,children:`ia`}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0197em`},children:`l`}),_jsx(_components.span,{className:`mord`,children:`1`}),_jsx(_components.span,{className:`mspace`,style:{marginRight:`0.2778em`}}),_jsx(_components.span,{className:`mrel`,children:`:`}),_jsx(_components.span,{className:`mspace`,style:{marginRight:`0.2778em`}})]}),_jsxs(_components.span,{className:`base`,children:[_jsx(_components.span,{className:`strut`,style:{height:`0.6833em`}}),_jsx(_components.span,{className:`mord mathnormal`,style:{marginRight:`0.0077em`},children:`R`})]})]})]}),` 100,00. Devolução parcial 2: R$ 200,00.`]}),`\n`,_jsxs(_components.p,{children:[`A plataforma verifica o teto considerando tanto as devoluções `,_jsx(_components.code,{children:`CONFIRMED`}),` quanto as `,_jsx(_components.code,{children:`PENDING`}),`. Se houver devoluções pendentes que somam ao máximo, novas devoluções serão rejeitadas (`,_jsx(_components.code,{children:`422`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`monitorar-o-status`,children:`Monitorar o status`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,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://api.clearpago.com.br/api/pix/refund/d4e5f6a7-b8c9-0123-defa-234567890123`}),_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 \u003cseu_api_token>\"`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Significado`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PENDING`})}),_jsx(_components.td,{children:`Devolução aceita; aguardando confirmação do BaaS.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`CONFIRMED`})}),_jsxs(_components.td,{children:[`Devolução `,_jsx(_components.strong,{children:`confirmada`}),` — valor devolvido ao pagador.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`FAILED`})}),_jsxs(_components.td,{children:[`Devolução `,_jsx(_components.strong,{children:`rejeitada`}),` pelo BaaS.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PROVIDER_RESULT_UNKNOWN`})}),_jsx(_components.td,{children:`Resposta ambígua; reconciliação em andamento.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`receber-o-webhook`,children:`Receber o webhook`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`http`,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:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` https://seu-sistema.com/webhooks/pix`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Content-Type`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` application/json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Digital-Signature`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \u003cbase64>`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\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:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"event_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pix_cash_in_reversal\"`}),_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:` \"event\"`}),_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\"`}),_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:` \"external_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"estorno-12345\"`}),_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:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"CONFIRMED\"`}),_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:` \"value_cents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`15075`}),_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:` \"end_to_end_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"D07136847202504011500O5222ZRBI5A\"`}),_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:` \"fee_amount_cents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_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:` \"confirmed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-01T15:05:00.000000000Z\"`})]}),`\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`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Atenção à semântica de `,_jsx(_components.code,{children:`event.id`}),`:`]}),` no evento `,_jsx(_components.code,{children:`pix_cash_in_reversal`}),`, `,_jsx(_components.code,{children:`event.id`}),` é o UUID do `,_jsx(_components.strong,{children:`cash-in original`}),`, não o UUID do refund-in. O `,_jsx(_components.code,{children:`event.external_id`}),` é o `,_jsx(_components.code,{children:`externalId`}),` do `,_jsx(_components.strong,{children:`refund-in`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Chave de idempotência recomendada:`}),` `,_jsx(_components.code,{children:`event_type`}),` + `,_jsx(_components.code,{children:`transaction_id`}),` + `,_jsx(_components.code,{children:`end_to_end_id`}),` do estorno. Evita colisão entre devoluções parciais do mesmo cash-in.`]}),`\n`,_jsx(Heading,{level:`2`,id:`erros-comuns`,children:`Erros comuns`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Mensagem`}),_jsx(_components.th,{children:`Causa`}),_jsx(_components.th,{children:`Ação`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refundValue must be greater than zero`})}),_jsx(_components.td,{children:`Valor inválido`}),_jsx(_components.td,{children:`Corrija o valor.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refundValue exceeds the amount available for refund`})}),_jsx(_components.td,{children:`Teto atingido`}),_jsx(_components.td,{children:`Reduza o valor ou verifique devoluções pendentes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refund deadline of 89 days has been exceeded`})}),_jsx(_components.td,{children:`Prazo expirado`}),_jsx(_components.td,{children:`Não é possível devolver; encerre o processo.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`refunds can only be issued for PAID cash-in transactions`})}),_jsxs(_components.td,{children:[`Cash-in não está `,_jsx(_components.code,{children:`PAID`})]}),_jsxs(_components.td,{children:[`Verifique o status com `,_jsx(_components.code,{children:`GET /api/pix/cash-in/{id}`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`original cash-in transaction not found`})}),_jsx(_components.td,{children:`UUID inválido`}),_jsxs(_components.td,{children:[`Verifique se está usando o `,_jsx(_components.code,{children:`id`}),` do cash-in (não `,_jsx(_components.code,{children:`transactionId`}),`).`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`auditoria`,children:`Auditoria`}),`\n`,_jsx(_components.p,{children:`Para listar todos os refunds:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,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:`2`,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://api.clearpago.com.br/api/pix/refund?start_date=2026-04-01\u0026end_date=2026-04-30\"`}),_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 \u003cseu_api_token>\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`referências`,children:`Referências`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api-reference/create-refund-in`,children:`POST /api/pix/refund-in/`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/api-reference/get-refund`,children:`GET /api/pix/refund/`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/webhooks/webhook-event-reference`,children:`Referência de eventos de webhook`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/core-concepts/identity-model`,children:`Modelo de identidade`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Devolver um cash-in (Refund-in)","description":"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.","href":"/guides/refund-a-cash-in"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Visão geral","slug":"visão-geral","depth":2,"children":[]},{"title":"Pré-requisitos","slug":"pré-requisitos","depth":2,"children":[]},{"title":"Identificadores críticos","slug":"identificadores-críticos","depth":2,"children":[]},{"title":"Criar a devolução","slug":"criar-a-devolução","depth":2,"children":[{"title":"Campos","slug":"campos","depth":3,"children":[]}]},{"title":"Devoluções parciais","slug":"devoluções-parciais","depth":2,"children":[]},{"title":"Monitorar o status","slug":"monitorar-o-status","depth":2,"children":[]},{"title":"Receber o webhook","slug":"receber-o-webhook","depth":2,"children":[]},{"title":"Erros comuns","slug":"erros-comuns","depth":2,"children":[]},{"title":"Auditoria","slug":"auditoria","depth":2,"children":[]},{"title":"Referências","slug":"referências","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"clearpago","siteName":"ClearPago","title":"Devolver um cash-in (Refund-in) - ClearPago","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-23T18:50:49.490Z","originalFileLocation":"guides/refund-a-cash-in.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=\"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ClearPago\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/clearpago/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/clearpago/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/clearpago/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/clearpago/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Devolver um cash-in (Refund-in) - ClearPago\">\u003cmeta data-mint-head property=\"og:description\" content=\"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ClearPago\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.clearpago.com/guides/refund-a-cash-in\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://clearpago.mintlify.app/_mintlify/api/og/v2?division=Guias\u0026amp;title=Devolver+um+cash-in+%28Refund-in%29\u0026amp;description=Como+solicitar+devolu%C3%A7%C3%A3o+de+um+recebimento+Pix%3A+regras+de+neg%C3%B3cio%2C+prazo+de+89+dias%2C+devolu%C3%A7%C3%B5es+parciais+e+auditoria.\u0026amp;theme=d304cf9661ece7b5262fc744\u0026amp;signature=cabd43d01d5aa89456588018a012a1f36b285febc737cec46e6e79898f493ea1\">\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=\"Devolver um cash-in (Refund-in) - ClearPago\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://clearpago.mintlify.app/_mintlify/api/og/v2?division=Guias\u0026amp;title=Devolver+um+cash-in+%28Refund-in%29\u0026amp;description=Como+solicitar+devolu%C3%A7%C3%A3o+de+um+recebimento+Pix%3A+regras+de+neg%C3%B3cio%2C+prazo+de+89+dias%2C+devolu%C3%A7%C3%B5es+parciais+e+auditoria.\u0026amp;theme=d304cf9661ece7b5262fc744\u0026amp;signature=cabd43d01d5aa89456588018a012a1f36b285febc737cec46e6e79898f493ea1\">\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/clearpago/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ClearPago\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f766e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.clearpago.com/guides/refund-a-cash-in\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/refund-a-cash-in.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.clearpago.com/#organization\",\"name\":\"ClearPago\",\"url\":\"https://docs.clearpago.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/clearpago/mSJ86kniaUbCKbT4/logo_lightmode.png?fit=max\u0026auto=format\u0026n=mSJ86kniaUbCKbT4\u0026q=85\u0026s=874e04286f63996eee39a525d0e88605\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.clearpago.com#website\",\"name\":\"ClearPago\",\"url\":\"https://docs.clearpago.com\",\"publisher\":{\"@id\":\"https://docs.clearpago.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.clearpago.com/guides/refund-a-cash-in#webpage\",\"url\":\"https://docs.clearpago.com/guides/refund-a-cash-in\",\"name\":\"Devolver um cash-in (Refund-in)\",\"description\":\"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\",\"dateModified\":\"2026-04-23T18:50:49.490Z\",\"isPartOf\":{\"@id\":\"https://docs.clearpago.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.clearpago.com/guides/refund-a-cash-in#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.clearpago.com/guides/refund-a-cash-in#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guias\",\"item\":\"https://docs.clearpago.com/guides/receive-pix-cash-in\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Devolver um cash-in (Refund-in)\",\"item\":\"https://docs.clearpago.com/guides/refund-a-cash-in\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.clearpago.com/guides/refund-a-cash-in#article\",\"headline\":\"Devolver um cash-in (Refund-in)\",\"name\":\"Devolver um cash-in (Refund-in)\",\"description\":\"Como solicitar devolução de um recebimento Pix: regras de negócio, prazo de 89 dias, devoluções parciais e auditoria.\",\"url\":\"https://docs.clearpago.com/guides/refund-a-cash-in\",\"mainEntityOfPage\":{\"@id\":\"https://docs.clearpago.com/guides/refund-a-cash-in#webpage\"},\"dateModified\":\"2026-04-23T18:50:49.490Z\",\"publisher\":{\"@id\":\"https://docs.clearpago.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.clearpago.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ClearPago\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ClearPago","nav":{"global":null,"groups":[{"group":"Início","pages":[{"title":"ClearPago — API Pix","href":"/index"}]},{"group":"Introdução","pages":[{"title":"Visão geral","href":"/getting-started/overview"},{"title":"Autenticação","href":"/getting-started/authentication"},{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Ambientes, headers e convenções","href":"/getting-started/environments-and-headers"},{"title":"Checklist de primeira integração","href":"/getting-started/first-integration-checklist"}]},{"group":"Conceitos","pages":[{"title":"Arquitetura","href":"/core-concepts/architecture"},{"title":"Modelo de identidade","href":"/core-concepts/identity-model"},{"title":"Ciclo de vida das operações","href":"/core-concepts/transaction-lifecycle"},{"title":"Modelo de status","href":"/core-concepts/status-model"},{"title":"Idempotência e correlação","href":"/core-concepts/idempotency-and-correlation"},{"title":"Ledger e saldo","href":"/core-concepts/ledger-and-balance"}]},{"group":"Guias","pages":[{"title":"Receber Pix (Cash-in)","href":"/guides/receive-pix-cash-in"},{"title":"Enviar Pix por chave (Cash-out)","href":"/guides/send-pix-cash-out-key"},{"title":"Enviar Pix por QR Code (Cash-out QR)","description":"Fluxo de pagamento a partir de string EMV (pix copia e cola); diferenças em relação ao cash-out por chave.","href":"/guides/send-pix-cash-out-qrcode"},{"title":"Devolver um cash-in (Refund-in)","href":"/guides/refund-a-cash-in"},{"title":"Lidar com reversão de cash-out","description":"O que é reversão de cash-out, como o webhook chega, impacto no ledger e como o sistema integrador deve reagir.","href":"/guides/handle-cash-out-reversal"},{"title":"Registrar webhooks do comerciante","href":"/guides/register-merchant-webhooks"},{"title":"Verificar assinaturas de webhook","href":"/guides/verify-webhook-signatures"},{"title":"Reconciliar transações","href":"/guides/reconcile-transactions"}]},{"group":"Referência de API","pages":[{"group":"Cash-in","pages":[{"title":"POST /api/pix/cash-in","href":"/api-reference/create-cash-in"},{"title":"GET /api/pix/cash-in","href":"/api-reference/list-cash-ins"},{"title":"GET /api/pix/cash-in/{id}","href":"/api-reference/get-cash-in"}]},{"group":"Cash-out","pages":[{"title":"POST /api/pix/cash-out","href":"/api-reference/create-cash-out"},{"title":"GET /api/pix/cash-out","href":"/api-reference/list-cash-outs"},{"title":"GET /api/pix/cash-out/{id}","href":"/api-reference/get-cash-out"},{"title":"POST /api/pix/cash-out-qrcode","href":"/api-reference/create-cash-out-qrcode"}]},{"group":"Refund","pages":[{"title":"POST /api/pix/refund-in/{id}","href":"/api-reference/create-refund-in"},{"title":"GET /api/pix/refund","href":"/api-reference/list-refunds"},{"title":"GET /api/pix/refund/{id}","href":"/api-reference/get-refund"}]},{"group":"Ledger","pages":[{"title":"GET /api/pix/ledger","href":"/api-reference/list-ledger-entries"},{"title":"GET /api/pix/ledger/{id}","href":"/api-reference/get-ledger-entry"}]},{"group":"Organização","pages":[{"title":"GET /organization/balance","href":"/api-reference/get-balance"}]},{"group":"Transações","pages":[{"title":"List transactions cash in","href":"/api-reference/list-transactions-cash-in"},{"title":"List transactions cash out","href":"/api-reference/list-transactions-cash-out"}]},{"group":"Webhooks","pages":[{"title":"POST /webhook (registro de notificações)","href":"/api-reference/register-webhook"},{"title":"GET /webhook","href":"/api-reference/list-webhooks"},{"title":"DELETE /webhook/{webhook_id}","href":"/api-reference/delete-webhook"},{"title":"GET /public-key","href":"/api-reference/get-public-key"}]}]},{"group":"Webhooks","pages":[{"title":"Webhooks: parceiro → ClearPago","href":"/webhooks/partner-to-clearpago"},{"title":"Webhooks: ClearPago → comerciante","href":"/webhooks/clearpago-to-merchant"},{"title":"Referência de payloads (webhooks)","href":"/webhooks/webhook-event-reference"}]},{"group":"Ledger e Reconciliação","pages":[{"title":"Ledger — Visão geral","href":"/ledger-and-reconciliation/ledger-overview"},{"title":"Reconciliação","href":"/ledger-and-reconciliation/reconciliation"},{"title":"Monitoramento operacional","href":"/ledger-and-reconciliation/operational-monitoring"}]},{"group":"Erros","pages":[{"title":"Tratamento de erros","href":"/errors/error-handling"},{"title":"Códigos, sintomas e ações","href":"/errors/error-codes"},{"title":"Troubleshooting","href":"/errors/troubleshooting"}]},{"group":"Go-live","pages":[{"title":"Checklist de produção","href":"/go-live/production-checklist"},{"title":"Checklist de segurança","href":"/go-live/security-checklist"},{"title":"Checklist de observabilidade","href":"/go-live/observability-checklist"}]},{"group":"FAQ","pages":[{"title":"Perguntas frequentes","href":"/faq/index"}]}]},"title":"Devolver um cash-in (Refund-in) - ClearPago","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}
