Como receber e tratar notificações em tempo real sobre transações da Legacy.
A Legacy oferece suporte a Webhooks, mecanismo que envia requisições HTTP POST diretamente para a sua aplicação toda vez que ocorre uma mudança de evento importante em nossa infraestrutura.Por exemplo, você pode receber um alerta sempre que:
O pagamento de um PIX for aprovado pelo banco.
Um saque (Payout) finalizar com sucesso.
Um pagamento por Cartão de Crédito virar Chargeback.
Onde configurar
Durante as requisições, por exemplo na criação de um Payback POST /payin, você envidará nativamente a propriedade webhookUrl. A Legacy enviará todas as atualizações pertencentes àquele pagamento para a URL informada dinamicamente.
Validação e Eventos (Payins)
Quando a Legacy enviar um webhook do Payin, nós usaremos o seguinte Payload:
Geralmente, um Payout trafegará pelo status PROCESSING até consolidar-se emAPPROVED ou FAILED.
Sempre retorne qualquer status HTTP no range 2xx (Ex: 200 OK) nos seus controladores de webhook. Se nosso endpoint falhar, tentaremos despachar novamente em janelas crescentes de repetição.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Legacy API","colors":{"primary":"#EBB305","light":"#FCD34D"},"logo":{"light":"https://mintcdn.com/lunosat/rNNhSTCxsA0j_CBH/logo/light.svg?fit=max\u0026auto=format\u0026n=rNNhSTCxsA0j_CBH\u0026q=85\u0026s=8183d89e958fef47ae483dd69b46f30e","dark":"https://mintcdn.com/lunosat/rNNhSTCxsA0j_CBH/logo/light.svg?fit=max\u0026auto=format\u0026n=rNNhSTCxsA0j_CBH\u0026q=85\u0026s=8183d89e958fef47ae483dd69b46f30e","href":"https://legacyecom.com.br"},"favicon":"https://mintcdn.com/lunosat/W8ZQfN6dlin-3-8H/favicon.png?fit=max\u0026auto=format\u0026n=W8ZQfN6dlin-3-8H\u0026q=85\u0026s=42bfc58050283d92cf8b3c4f9e96f28e","api":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lunosat","hasAudioNarration":false,"actualSubdomain":"lunosat","customDomains":["developers.holdinglegacy.io"],"gitSource":{"type":"github","owner":"lunosat","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae943351a3329c39da3c66b:success","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Guia Geral","count":9},{"language":"default","tag":"API Reference","count":6},{"language":"default","tag":"Pagamento com Cartão","count":4},{"language":"default","tag":"Payins (Recebimentos)","count":3},{"language":"default","tag":"Payouts (Pagamentos)","count":3},{"language":"default","tag":"Conceitos Essenciais","count":3},{"language":"default","tag":"Bem-vindo(a)","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[],"page":{"pagePath":"webhooks","slug":"/webhooks","pageMetadata":{"title":"Webhooks","description":"Como receber e tratar notificações em tempo real sobre transações da Legacy.","icon":"webhook","href":"/webhooks"},"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 receber e tratar notificações em tempo real sobre transações da Legacy.\"\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`,em:`em`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A Legacy oferece suporte a Webhooks, mecanismo que envia requisições `,_jsx(_components.code,{children:`HTTP POST`}),` diretamente para a sua aplicação toda vez que ocorre uma mudança de evento importante em nossa infraestrutura.`]}),`\n`,_jsx(_components.p,{children:`Por exemplo, você pode receber um alerta sempre que:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`O pagamento de um `,_jsx(_components.code,{children:`PIX`}),` for aprovado pelo banco.`]}),`\n`,_jsxs(_components.li,{children:[`Um saque (`,_jsx(_components.code,{children:`Payout`}),`) finalizar com sucesso.`]}),`\n`,_jsx(_components.li,{children:`Um pagamento por Cartão de Crédito virar Chargeback.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`onde-configurar`,children:`Onde configurar`}),`\n`,_jsxs(_components.p,{children:[`Durante as requisições, por exemplo na criação de um Payback `,_jsx(_components.code,{children:`POST /payin`}),`, você envidará nativamente a propriedade `,_jsx(_components.code,{children:`webhookUrl`}),`. A Legacy enviará todas as atualizações pertencentes àquele pagamento para a URL informada dinamicamente.`]}),`\n`,_jsx(Heading,{level:`2`,id:`validação-e-eventos-payins`,children:`Validação e Eventos (Payins)`}),`\n`,_jsxs(_components.p,{children:[`Quando a Legacy enviar um webhook do Payin, nós usaremos o seguinte `,_jsx(_components.strong,{children:`Payload`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,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:`12`,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:`\"payin_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:`\"APPROVED\"`}),_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:` \"paymentMethod\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PIX\"`}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10000`}),_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:` \"referenceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"meu-pedido-1234\"`}),_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:` \"customer\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Maria Silva\"`}),_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:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"maria@email.com\"`})]}),`\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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-02T12:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`possíveis-status-do-payin`,children:`Possíveis Status do Payin`}),`\n`,_jsx(_components.p,{children:`É aconselhável que o seu sistema saiba lidar de forma fluida com estes retornos:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`PENDING`}),` - Gerado, aguardando liquidação.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`APPROVED`}),` - O saldo está disponível para a loja.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`FAILED`}),` - Falha catastrófica (Ex: Adquirente fora do ar).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CANCELED`}),` - A transação foi cancelada antes de ocorrer.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`REFUSED`}),` - Saldo negado pelo emissor do Cartão ou sistema Anti-Fraudes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`REFUNDED`}),` - Você aplicou um estorno parcial/total na mesma.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`CHARGEBACK`}),` - Seu cliente contestou com o banco emissor o uso indevido da compra.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`MED`}),` - Seu cliente contestou com o banco emissor o uso indevido da compra.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`EXPIRED`}),` - Janela de PIX ou Boleto vencidas.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`validação-e-eventos-payouts`,children:`Validação e Eventos (Payouts)`}),`\n`,_jsxs(_components.p,{children:[`Para o saque manual efetuado via API, `,_jsx(_components.code,{children:`POST /payout`}),`, a estrutura possui o seguinte comportamento de disparos no Webhook:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:`\"payout_98765\"`}),_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:`\"APPROVED\"`}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`50000`}),_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:` \"pixKey\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"maria@email.com\"`}),_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:` \"pixKeyType\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"EMAIL\"`}),_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:` \"referenceId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"saque-afiliado-01\"`}),_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:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-03-02T12:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsxs(_components.em,{children:[`Geralmente, um Payout trafegará pelo status `,_jsx(_components.code,{children:`PROCESSING`}),` até consolidar-se em`]}),` `,_jsx(_components.code,{children:`APPROVED `}),_jsxs(_components.em,{children:[`ou `,_jsx(_components.code,{children:`FAILED`}),`.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Sempre retorne qualquer status HTTP no range `,_jsx(_components.code,{children:`2xx`}),` (Ex: `,_jsx(_components.code,{children:`200 OK`}),`) nos seus controladores de webhook. Se nosso endpoint falhar, tentaremos despachar novamente em janelas crescentes de repetição.`]})})]})}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":"Webhooks","description":"Como receber e tratar notificações em tempo real sobre transações da Legacy.","icon":"webhook","href":"/webhooks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Onde configurar","slug":"onde-configurar","depth":2,"children":[]},{"title":"Validação e Eventos (Payins)","slug":"validação-e-eventos-payins","depth":2,"children":[{"title":"Possíveis Status do Payin","slug":"possíveis-status-do-payin","depth":3,"children":[]}]},{"title":"Validação e Eventos (Payouts)","slug":"validação-e-eventos-payouts","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"lunosat","siteName":"Legacy API","title":"Webhooks - Legacy API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-05T20:08:04.449Z","originalFileLocation":"webhooks.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 receber e tratar notificações em tempo real sobre transações da Legacy.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Legacy API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_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/lunosat/dAR8aWPsAruxYZ5B/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Webhooks - Legacy API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Como receber e tratar notificações em tempo real sobre transações da Legacy.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Legacy API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.holdinglegacy.io/webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lunosat.mintlify.site/_mintlify/api/og/v2?division=Conceitos+Essenciais\u0026amp;title=Webhooks\u0026amp;description=Como+receber+e+tratar+notifica%C3%A7%C3%B5es+em+tempo+real+sobre+transa%C3%A7%C3%B5es+da+Legacy.\u0026amp;theme=d862cbdfee8c3ba6487a6107\u0026amp;signature=fd869d57e20100670ae2276d566a9a049bd9d26afcde5f9a24517c5ef53754c2\">\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=\"Webhooks - Legacy API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Como receber e tratar notificações em tempo real sobre transações da Legacy.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lunosat.mintlify.site/_mintlify/api/og/v2?division=Conceitos+Essenciais\u0026amp;title=Webhooks\u0026amp;description=Como+receber+e+tratar+notifica%C3%A7%C3%B5es+em+tempo+real+sobre+transa%C3%A7%C3%B5es+da+Legacy.\u0026amp;theme=d862cbdfee8c3ba6487a6107\u0026amp;signature=fd869d57e20100670ae2276d566a9a049bd9d26afcde5f9a24517c5ef53754c2\">\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/lunosat/dAR8aWPsAruxYZ5B/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Legacy API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EBB305\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.holdinglegacy.io/webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.holdinglegacy.io/#organization\",\"name\":\"Legacy API\",\"url\":\"https://developers.holdinglegacy.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lunosat/rNNhSTCxsA0j_CBH/logo/light.svg?fit=max\u0026auto=format\u0026n=rNNhSTCxsA0j_CBH\u0026q=85\u0026s=8183d89e958fef47ae483dd69b46f30e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.holdinglegacy.io#website\",\"name\":\"Legacy API\",\"url\":\"https://developers.holdinglegacy.io\",\"publisher\":{\"@id\":\"https://developers.holdinglegacy.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.holdinglegacy.io/webhooks#webpage\",\"url\":\"https://developers.holdinglegacy.io/webhooks\",\"name\":\"Webhooks\",\"description\":\"Como receber e tratar notificações em tempo real sobre transações da Legacy.\",\"dateModified\":\"2026-07-05T20:08:04.449Z\",\"isPartOf\":{\"@id\":\"https://developers.holdinglegacy.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.holdinglegacy.io/webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.holdinglegacy.io/webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conceitos Essenciais\",\"item\":\"https://developers.holdinglegacy.io/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Webhooks\",\"item\":\"https://developers.holdinglegacy.io/webhooks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.holdinglegacy.io/webhooks#article\",\"headline\":\"Webhooks\",\"name\":\"Webhooks\",\"description\":\"Como receber e tratar notificações em tempo real sobre transações da Legacy.\",\"url\":\"https://developers.holdinglegacy.io/webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://developers.holdinglegacy.io/webhooks#webpage\"},\"dateModified\":\"2026-07-05T20:08:04.449Z\",\"publisher\":{\"@id\":\"https://developers.holdinglegacy.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.holdinglegacy.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Legacy API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Legacy API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/webhooks.md","siteName":"Legacy API","nav":{"global":null,"tabs":[{"tab":"Guia Geral","groups":[{"group":"Bem-vindo(a)","pages":[{"title":"Bem-vindo(a) à Legacy","href":""},{"title":"Início Rápido","icon":"rocket","href":"/quickstart"}]},{"group":"Conceitos Essenciais","pages":[{"title":"Autenticação","description":"Guia de como se autenticar na API da Legacy usando suas chaves de produção.","icon":"lock","href":"/authentication"},{"title":"Webhooks","icon":"webhook","href":"/webhooks"},{"title":"Dicionário de Erros","description":"Entenda os principais códigos de erro padronizados retornados pela API e como lidar com eles.","icon":"bug","href":"/status"}]},{"group":"Pagamento com Cartão","pages":[{"title":"Pagamento com Cartão (Visão Geral)","icon":"credit-card","href":"/integracao-cartao"},{"title":"Tokenização de Cartões","icon":"shield-halved","href":"/tokenizacao"},{"title":"Autenticação 3D Secure (3DS)","icon":"fingerprint","href":"/3ds"},{"title":"Antifraude","icon":"shield-check","href":"/antifraude"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/payins/create"}]}]},"basePath":"","title":"Webhooks - Legacy API","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}