{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
Esta rota encerra uma autenticação 3DS que ficou pela metade. Use quando o comprador fecha o desafio do banco, volta para trocar de cartão ou desiste da compra. Cancelar deixa claro que aquela autenticação não será usada e evita confusão entre tentativas.
Quando usar
Situação
Como usar esta rota
Comprador fechou a janela do desafio
Cancele o authenticationId e permita uma nova tentativa
Comprador voltou para trocar de cartão
Cancele a autenticação do cartão anterior antes de iniciar a do novo
Seu checkout atingiu o tempo limite do desafio (o SDK usa cerca de 10 minutos)
Cancele e mostre uma mensagem de nova tentativa
A autenticação já terminou (succeeded, failed)
Esta rota não se aplica. Só cancela autenticações em requires_submission ou requires_challenge
A autenticação precisa estar em requires_submission ou requires_challenge.
Use a chave pública (pk_, ou pk_test_ no sandbox) no cabeçalho Basic, como usuário e com senha vazia.
O contrato desta rota declara a autenticação basic e diz, na descrição da rota, que a chave usada é a pública (pk_). A descrição genérica do esquema basic no contrato fala em chave secreta. Siga a descrição da rota: chave pública.
Corpo da requisição
string
required
ID da autenticação 3DS a cancelar, exatamente como veio em POST /v1/three-ds/authenticate. O valor é opaco: não valide prefixo nem tamanho. Ex.: tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
Respostas
string
ID da autenticação cancelada. Ex.: tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string
Status da autenticação depois do cancelamento. Ex.: canceled.
HTTP
Significado
Mensagem (message)
200
Autenticação cancelada
401
Chave pública inválida
Unauthorized
404
Nenhum provedor de 3DS configurado para a conta
No 3DS provider configured for this gateway
Os erros vêm no formato { statusCode, message, error }. Trate o erro pelo código HTTP, não pelo texto da mensagem.
O contrato não documenta a resposta para o cancelamento de uma autenticação que já está em estado final (por exemplo, succeeded). Chame esta rota só nos estados requires_submission e requires_challenge.
Para o negócio: cancelar uma autenticação não cria nem cancela cobrança. A cobrança só existe depois de POST /v1/charges. Se o comprador desistiu antes disso, nada foi cobrado.
Exemplo: comprador fechou o desafio
const credentials = btoa(`${FINVIA_PUBLIC_KEY}:`);async function aoFecharDesafio(authenticationId) { await fetch('https://api-global.fastpaybrasil.com/v1/three-ds/cancel', { method: 'POST', headers: { Authorization: `Basic ${credentials}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ authenticationId }), }); mostrarMensagem('Autenticação cancelada. Tente de novo ou use outro cartão.');}
Para o desenvolvedor: para uma nova tentativa depois do cancelamento, inicie uma nova autenticação em POST /v1/three-ds/authenticate. Use o novo authenticationId devolvido por ela nas etapas seguintes.
Erros comuns
Sintoma
Causa
Como resolver
404No 3DS provider configured for this gateway
A conta não tem provedor de 3DS configurado
Fale com o time Finvia para habilitar o 3DS
401Unauthorized
Chave pública inválida ou de outro ambiente
Use a pk_ (ou pk_test_) da conta que iniciou a autenticação
POST /v1/three-ds/cancel HTTP/1.1Host: api-global.fastpaybrasil.comAuthorization: Basic <base64 de "SUA_CHAVE_PUBLICA:">Content-Type: application/json{ "authenticationId": "tdsa_1QmCRMJM0r9zBvr4OVmMRa6X"}
{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
Veja também
Iniciar autenticação
Comece uma nova tentativa.
Enviar autenticação
Etapa anterior ao desafio.
3DS via API
Guia do fluxo completo.
Visão geral do 3D Secure
Os três caminhos de 3DS.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finvia API","colors":{"primary":"#017AFF","light":"#4DA3FF","dark":"#0060CC"},"logo":{"light":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/logo-light.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=bfbd4f1bf8f8d6b73724e72ebba0ba64","dark":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/logo-dark.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=1a10605df3e53d5d16ec8b1c0a9a7825","href":"https://www.finvia.com.br"},"favicon":{"light":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/favicon.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=6111b3cd8adc2008cdbcb57057e2e341","dark":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/favicon.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=6111b3cd8adc2008cdbcb57057e2e341"},"api":{"mdx":{"auth":{"method":"basic"},"server":"https://api-global.fastpaybrasil.com"}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#070D15"}},"navbar":{"links":[{"href":"https://wa.me/5531998560666","label":"Suporte"}],"primary":{"type":"button","label":"Acessar painel","href":"https://app.finvia.com.br"}},"footer":{"socials":{"website":"https://www.finvia.com.br","instagram":"https://www.instagram.com/finvia.br"}},"contextual":{"options":["copy","view","chatgpt","claude","aistudio","perplexity","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fastpay","hasAudioNarration":false,"actualSubdomain":"fastpay","customDomains":["docs.fastpaybrasil.com"],"gitSource":{"type":"github","owner":"fastsoftbrasil","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af6094a3ff3f2c220966cc1","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Referência da API","count":55},{"language":"default","tag":"Guias","count":30},{"language":"default","tag":"Casos de uso","count":18},{"language":"default","tag":"Connect","count":18},{"language":"default","tag":"Documentação","count":12},{"language":"default","tag":"Cobranças","count":10},{"language":"default","tag":"3D Secure","count":9},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Assinaturas","count":8},{"language":"default","tag":"Planos de assinatura","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":[],"page":{"pagePath":"referencia/3d-secure/cancelar","slug":"/referencia/3d-secure/cancelar","pageMetadata":{"title":"Cancelar autenticação 3DS","api":"POST /v1/three-ds/cancel","authMethod":"basic","description":"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.","href":"/referencia/3d-secure/cancelar"},"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: \"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Note,ParamField,ResponseField,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Esta rota encerra uma autenticação 3DS que ficou pela metade. Use quando o comprador fecha o desafio do banco, volta para trocar de cartão ou desiste da compra. Cancelar deixa claro que aquela autenticação não será usada e evita confusão entre tentativas.`}),`\n`,_jsx(Heading,{level:`2`,id:`quando-usar`,children:`Quando usar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situação`}),_jsx(_components.th,{children:`Como usar esta rota`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Comprador fechou a janela do desafio`}),_jsxs(_components.td,{children:[`Cancele o `,_jsx(_components.code,{children:`authenticationId`}),` e permita uma nova tentativa`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Comprador voltou para trocar de cartão`}),_jsx(_components.td,{children:`Cancele a autenticação do cartão anterior antes de iniciar a do novo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Seu checkout atingiu o tempo limite do desafio (o SDK usa cerca de 10 minutos)`}),_jsx(_components.td,{children:`Cancele e mostre uma mensagem de nova tentativa`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A autenticação já terminou (`,_jsx(_components.code,{children:`succeeded`}),`, `,_jsx(_components.code,{children:`failed`}),`)`]}),_jsxs(_components.td,{children:[`Esta rota não se aplica. Só cancela autenticações em `,_jsx(_components.code,{children:`requires_submission`}),` ou `,_jsx(_components.code,{children:`requires_challenge`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Tenha o `,_jsx(_components.code,{children:`authenticationId`}),` devolvido por `,_jsx(_components.a,{href:`/referencia/3d-secure/iniciar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A autenticação precisa estar em `,_jsx(_components.code,{children:`requires_submission`}),` ou `,_jsx(_components.code,{children:`requires_challenge`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Use a `,_jsx(_components.strong,{children:`chave pública`}),` (`,_jsx(_components.code,{children:`pk_`}),`, ou `,_jsx(_components.code,{children:`pk_test_`}),` no sandbox) no cabeçalho Basic, como usuário e com senha vazia.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O contrato desta rota declara a autenticação `,_jsx(_components.code,{children:`basic`}),` e diz, na descrição da rota, que a chave usada é a pública (`,_jsx(_components.code,{children:`pk_`}),`). A descrição genérica do esquema `,_jsx(_components.code,{children:`basic`}),` no contrato fala em chave secreta. Siga a descrição da rota: chave pública.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`authenticationId`,type:`string`,required:true,id:`param-authentication-id`,children:_jsxs(_components.p,{children:[`ID da autenticação 3DS a cancelar, exatamente como veio em `,_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`}),`. O valor é opaco: não valide prefixo nem tamanho. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsx(ResponseField,{name:`authenticationId`,type:`string`,id:`param-authentication-id-1`,children:_jsxs(_components.p,{children:[`ID da autenticação cancelada. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Status da autenticação depois do cancelamento. Ex.: `,_jsx(_components.code,{children:`canceled`}),`.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Significado`}),_jsxs(_components.th,{children:[`Mensagem (`,_jsx(_components.code,{children:`message`}),`)`]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Autenticação cancelada`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Chave pública inválida`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Unauthorized`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`Nenhum provedor de 3DS configurado para a conta`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`No 3DS provider configured for this gateway`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Os erros vêm no formato `,_jsx(_components.code,{children:`{ statusCode, message, error }`}),`. Trate o erro pelo código HTTP, não pelo texto da mensagem.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O contrato não documenta a resposta para o cancelamento de uma autenticação que já está em estado final (por exemplo, `,_jsx(_components.code,{children:`succeeded`}),`). Chame esta rota só nos estados `,_jsx(_components.code,{children:`requires_submission`}),` e `,_jsx(_components.code,{children:`requires_challenge`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` cancelar uma autenticação não cria nem cancela cobrança. A cobrança só existe depois de `,_jsx(_components.code,{children:`POST /v1/charges`}),`. Se o comprador desistiu antes disso, nada foi cobrado.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-comprador-fechou-o-desafio`,children:`Exemplo: comprador fechou o desafio`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` credentials`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` btoa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`FINVIA_PUBLIC_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\":`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` aoFecharDesafio`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`authenticationId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api-global.fastpaybrasil.com/v1/three-ds/cancel'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Basic \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`credentials`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`authenticationId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` mostrarMensagem`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Autenticação cancelada. Tente de novo ou use outro cartão.'`}),_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(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o desenvolvedor:`}),` para uma nova tentativa depois do cancelamento, inicie uma nova autenticação em `,_jsx(_components.a,{href:`/referencia/3d-secure/iniciar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`})}),`. Use o novo `,_jsx(_components.code,{children:`authenticationId`}),` devolvido por ela nas etapas seguintes.`]})}),`\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:`Sintoma`}),_jsx(_components.th,{children:`Causa`}),_jsx(_components.th,{children:`Como resolver`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`404`}),` `,_jsx(_components.code,{children:`No 3DS provider configured for this gateway`})]}),_jsx(_components.td,{children:`A conta não tem provedor de 3DS configurado`}),_jsx(_components.td,{children:`Fale com o time Finvia para habilitar o 3DS`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`401`}),` `,_jsx(_components.code,{children:`Unauthorized`})]}),_jsx(_components.td,{children:`Chave pública inválida ou de outro ambiente`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da conta que iniciou a autenticação`]})]})]})]}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`veja-também`,children:`Veja também`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Iniciar autenticação`,icon:`play`,href:`/referencia/3d-secure/iniciar`,children:`Comece uma nova tentativa.`}),_jsx(Card,{title:`Enviar autenticação`,icon:`paper-plane`,href:`/referencia/3d-secure/enviar`,children:`Etapa anterior ao desafio.`}),_jsx(Card,{title:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo.`}),_jsx(Card,{title:`Visão geral do 3D Secure`,icon:`shield-halved`,href:`/guias/3d-secure/visao-geral`,children:`Os três caminhos de 3DS.`})]})]})}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":"Cancelar autenticação 3DS","api":"POST /v1/three-ds/cancel","authMethod":"basic","description":"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.","href":"/referencia/3d-secure/cancelar"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Note,ParamField,RequestExample,ResponseExample,ResponseField,Table,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Esta rota encerra uma autenticação 3DS que ficou pela metade. Use quando o comprador fecha o desafio do banco, volta para trocar de cartão ou desiste da compra. Cancelar deixa claro que aquela autenticação não será usada e evita confusão entre tentativas.`}),`\n`,_jsx(Heading,{level:`2`,id:`quando-usar`,children:`Quando usar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situação`}),_jsx(_components.th,{children:`Como usar esta rota`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Comprador fechou a janela do desafio`}),_jsxs(_components.td,{children:[`Cancele o `,_jsx(_components.code,{children:`authenticationId`}),` e permita uma nova tentativa`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Comprador voltou para trocar de cartão`}),_jsx(_components.td,{children:`Cancele a autenticação do cartão anterior antes de iniciar a do novo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Seu checkout atingiu o tempo limite do desafio (o SDK usa cerca de 10 minutos)`}),_jsx(_components.td,{children:`Cancele e mostre uma mensagem de nova tentativa`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A autenticação já terminou (`,_jsx(_components.code,{children:`succeeded`}),`, `,_jsx(_components.code,{children:`failed`}),`)`]}),_jsxs(_components.td,{children:[`Esta rota não se aplica. Só cancela autenticações em `,_jsx(_components.code,{children:`requires_submission`}),` ou `,_jsx(_components.code,{children:`requires_challenge`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Tenha o `,_jsx(_components.code,{children:`authenticationId`}),` devolvido por `,_jsx(_components.a,{href:`/referencia/3d-secure/iniciar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`})}),`.`]}),`\n`,_jsxs(_components.li,{children:[`A autenticação precisa estar em `,_jsx(_components.code,{children:`requires_submission`}),` ou `,_jsx(_components.code,{children:`requires_challenge`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Use a `,_jsx(_components.strong,{children:`chave pública`}),` (`,_jsx(_components.code,{children:`pk_`}),`, ou `,_jsx(_components.code,{children:`pk_test_`}),` no sandbox) no cabeçalho Basic, como usuário e com senha vazia.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O contrato desta rota declara a autenticação `,_jsx(_components.code,{children:`basic`}),` e diz, na descrição da rota, que a chave usada é a pública (`,_jsx(_components.code,{children:`pk_`}),`). A descrição genérica do esquema `,_jsx(_components.code,{children:`basic`}),` no contrato fala em chave secreta. Siga a descrição da rota: chave pública.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`authenticationId`,type:`string`,required:true,id:`param-authentication-id`,children:_jsxs(_components.p,{children:[`ID da autenticação 3DS a cancelar, exatamente como veio em `,_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`}),`. O valor é opaco: não valide prefixo nem tamanho. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsx(ResponseField,{name:`authenticationId`,type:`string`,id:`param-authentication-id-1`,children:_jsxs(_components.p,{children:[`ID da autenticação cancelada. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Status da autenticação depois do cancelamento. Ex.: `,_jsx(_components.code,{children:`canceled`}),`.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Significado`}),_jsxs(_components.th,{children:[`Mensagem (`,_jsx(_components.code,{children:`message`}),`)`]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Autenticação cancelada`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Chave pública inválida`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Unauthorized`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:`Nenhum provedor de 3DS configurado para a conta`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`No 3DS provider configured for this gateway`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Os erros vêm no formato `,_jsx(_components.code,{children:`{ statusCode, message, error }`}),`. Trate o erro pelo código HTTP, não pelo texto da mensagem.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O contrato não documenta a resposta para o cancelamento de uma autenticação que já está em estado final (por exemplo, `,_jsx(_components.code,{children:`succeeded`}),`). Chame esta rota só nos estados `,_jsx(_components.code,{children:`requires_submission`}),` e `,_jsx(_components.code,{children:`requires_challenge`}),`.`]})}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` cancelar uma autenticação não cria nem cancela cobrança. A cobrança só existe depois de `,_jsx(_components.code,{children:`POST /v1/charges`}),`. Se o comprador desistiu antes disso, nada foi cobrado.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`exemplo-comprador-fechou-o-desafio`,children:`Exemplo: comprador fechou o desafio`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` credentials`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` btoa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`FINVIA_PUBLIC_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\":`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` function`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` aoFecharDesafio`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`authenticationId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api-global.fastpaybrasil.com/v1/three-ds/cancel'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Basic \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`credentials`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`authenticationId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` mostrarMensagem`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Autenticação cancelada. Tente de novo ou use outro cartão.'`}),_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(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o desenvolvedor:`}),` para uma nova tentativa depois do cancelamento, inicie uma nova autenticação em `,_jsx(_components.a,{href:`/referencia/3d-secure/iniciar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`})}),`. Use o novo `,_jsx(_components.code,{children:`authenticationId`}),` devolvido por ela nas etapas seguintes.`]})}),`\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:`Sintoma`}),_jsx(_components.th,{children:`Causa`}),_jsx(_components.th,{children:`Como resolver`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`404`}),` `,_jsx(_components.code,{children:`No 3DS provider configured for this gateway`})]}),_jsx(_components.td,{children:`A conta não tem provedor de 3DS configurado`}),_jsx(_components.td,{children:`Fale com o time Finvia para habilitar o 3DS`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`401`}),` `,_jsx(_components.code,{children:`Unauthorized`})]}),_jsx(_components.td,{children:`Chave pública inválida ou de outro ambiente`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da conta que iniciou a autenticação`]})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`REST (JSON)`,numberOfLines:`8`,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:`8`,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:` /v1/three-ds/cancel `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Host`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api-global.fastpaybrasil.com`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Basic \u003cbase64 de \"SUA_CHAVE_PUBLICA:\">`})]}),`\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`,_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:` \"authenticationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`4`,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:`4`,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-global.fastpaybrasil.com/v1/three-ds/cancel\"`}),_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:` -u`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FINVIA_PUBLIC_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:\"`}),_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:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"authenticationId\": \"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\" }'`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Navegador`,numberOfLines:`12`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`12`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` credentials`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` btoa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`FINVIA_PUBLIC_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\":`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api-global.fastpaybrasil.com/v1/three-ds/cancel'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Basic \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`credentials`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`authenticationId:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'tdsa_1QmCRMJM0r9zBvr4OVmMRa6X'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` result`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`4`,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:`4`,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:` \"authenticationId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\"`}),_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:`\"canceled\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`404`,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:` \"statusCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`404`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"No 3DS provider configured for this gateway\"`}),_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:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Not Found\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`veja-também`,children:`Veja também`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Iniciar autenticação`,icon:`play`,href:`/referencia/3d-secure/iniciar`,children:`Comece uma nova tentativa.`}),_jsx(Card,{title:`Enviar autenticação`,icon:`paper-plane`,href:`/referencia/3d-secure/enviar`,children:`Etapa anterior ao desafio.`}),_jsx(Card,{title:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo.`}),_jsx(Card,{title:`Visão geral do 3D Secure`,icon:`shield-halved`,href:`/guias/3d-secure/visao-geral`,children:`Os três caminhos de 3DS.`})]})]})}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":"Cancelar autenticação 3DS","api":"POST /v1/three-ds/cancel","authMethod":"basic","description":"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.","href":"/referencia/3d-secure/cancelar"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Quando usar","slug":"quando-usar","depth":2,"children":[]},{"title":"Antes de chamar","slug":"antes-de-chamar","depth":2,"children":[]},{"title":"Corpo da requisição","slug":"corpo-da-requisição","depth":2,"children":[]},{"title":"Respostas","slug":"respostas","depth":2,"children":[]},{"title":"Exemplo: comprador fechou o desafio","slug":"exemplo-comprador-fechou-o-desafio","depth":2,"children":[]},{"title":"Erros comuns","slug":"erros-comuns","depth":2,"children":[]},{"title":"Veja também","slug":"veja-também","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"REST (JSON)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"http\">\u003ccode language=\"http\" numberOfLines=\"8\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">POST\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> /v1/three-ds/cancel \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">HTTP\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">/\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1.1\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">Host\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> api-global.fastpaybrasil.com\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">Authorization\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> Basic \u0026#x3C;base64 de \"SUA_CHAVE_PUBLICA:\">\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#569CD6\">Content-Type\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> application/json\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"authenticationId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api-global.fastpaybrasil.com/v1/three-ds/cancel\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -u\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$FINVIA_PUBLIC_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">:\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{ \"authenticationId\": \"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\" }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Navegador","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"javascript\">\u003ccode language=\"javascript\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> credentials\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> btoa\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\">FINVIA_PUBLIC_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">:`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api-global.fastpaybrasil.com/v1/three-ds/cancel'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> `Basic \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">${\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">credentials\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#569CD6\">}\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({ \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">authenticationId:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'tdsa_1QmCRMJM0r9zBvr4OVmMRa6X'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">});\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> result\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">();\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"authenticationId\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"canceled\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"404","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"statusCode\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">404\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"No 3DS provider configured for this gateway\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Not Found\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Cancelar autenticação 3DS","path":"/v1/three-ds/cancel","servers":[{"url":"https://api-global.fastpaybrasil.com"}],"method":"post","request":{"security":[{"title":"Basic Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"basic","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"authenticationId":[{"type":"string","description":"ID da autenticação 3DS a cancelar, exatamente como veio em `POST /v1/three-ds/authenticate` . O valor é opaco: não valide prefixo nem tamanho. Ex.: `tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` .","required":true}]}}],"examples":{"example":{"value":{"authenticationId":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"authenticationId":[{"type":"string","description":"ID da autenticação cancelada. Ex.: `tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"status":[{"type":"string","description":"Status da autenticação depois do cancelamento. Ex.: `canceled` ."}]}}],"examples":{"example":{"value":{"authenticationId":"\u003cstring>","status":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"fastpay","siteName":"Finvia API","title":"Cancelar autenticação 3DS - Finvia API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T18:26:58.863Z","originalFileLocation":"referencia/3d-secure/cancelar.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finvia 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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_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/fastpay/zdwxrVWdaAIJ4yiv/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Cancelar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finvia API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fastpay.mintlify.site/_mintlify/api/og/v2?division=3D+Secure\u0026amp;title=Cancelar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Cancela+uma+autentica%C3%A7%C3%A3o+3D+Secure+que+ainda+espera+envio+ou+desafio%2C+quando+o+comprador+desiste+ou+troca+de+cart%C3%A3o.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=0101e12e60764826a3a635cd528a76b9a739ceb0214e43e6059c2da7cbb9d136\">\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=\"Cancelar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fastpay.mintlify.site/_mintlify/api/og/v2?division=3D+Secure\u0026amp;title=Cancelar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Cancela+uma+autentica%C3%A7%C3%A3o+3D+Secure+que+ainda+espera+envio+ou+desafio%2C+quando+o+comprador+desiste+ou+troca+de+cart%C3%A3o.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=0101e12e60764826a3a635cd528a76b9a739ceb0214e43e6059c2da7cbb9d136\">\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/fastpay/zdwxrVWdaAIJ4yiv/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finvia API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#017AFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/referencia/3d-secure/cancelar.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fastpaybrasil.com/#organization\",\"name\":\"Finvia API\",\"url\":\"https://docs.fastpaybrasil.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/logo-light.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=bfbd4f1bf8f8d6b73724e72ebba0ba64\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fastpaybrasil.com#website\",\"name\":\"Finvia API\",\"url\":\"https://docs.fastpaybrasil.com\",\"publisher\":{\"@id\":\"https://docs.fastpaybrasil.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar#webpage\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar\",\"name\":\"Cancelar autenticação 3DS\",\"description\":\"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\",\"dateModified\":\"2026-11-12T18:26:58.863Z\",\"isPartOf\":{\"@id\":\"https://docs.fastpaybrasil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"3D Secure\",\"item\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Cancelar autenticação 3DS\",\"item\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar#apireference\",\"headline\":\"Cancelar autenticação 3DS\",\"name\":\"Cancelar autenticação 3DS\",\"description\":\"Cancela uma autenticação 3D Secure que ainda espera envio ou desafio, quando o comprador desiste ou troca de cartão.\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/cancelar#webpage\"},\"dateModified\":\"2026-11-12T18:26:58.863Z\",\"publisher\":{\"@id\":\"https://docs.fastpaybrasil.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fastpaybrasil.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Finvia API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Finvia API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/referencia/3d-secure/cancelar.md","siteName":"Finvia API","nav":{"global":null,"tabs":[{"tab":"Documentação","pages":[{"title":"Documentação","href":"/introducao"}]},{"tab":"Casos de uso","pages":[{"title":"Casos de uso","href":"/casos-de-uso/visao-geral"}]},{"tab":"Guias","pages":[{"title":"Guias","href":"/guias/cobrancas/visao-geral"}]},{"tab":"Referência da API","groups":[{"group":"Introdução","pages":[{"title":"Introdução à Referência","icon":"book-open","href":"/referencia/introducao"}]},{"group":"Cobranças","pages":[{"title":"Listar cobranças","api":"GET /v1/charges","href":"/referencia/cobrancas/listar"},{"title":"Criar uma cobrança","api":"POST /v1/charges","href":"/referencia/cobrancas/criar"},{"title":"Consultar uma cobrança","api":"GET /v1/charges/{id}","href":"/referencia/cobrancas/consultar"},{"title":"Estornar uma cobrança","api":"POST /v1/refunds","href":"/referencia/cobrancas/estornar"},{"title":"Reenviar webhook de teste","api":"POST /v1/charges/{id}/resend-webhook","href":"/referencia/cobrancas/reenviar-webhook-teste"}]},{"group":"Apple Pay","pages":[{"title":"Registrar domínio Apple Pay","api":"POST /v1/apple-pay/domains","href":"/referencia/apple-pay/registrar-dominio"},{"title":"Listar domínios Apple Pay","api":"GET /v1/apple-pay/domains","href":"/referencia/apple-pay/listar-dominios"},{"title":"Consultar domínio Apple Pay","api":"GET /v1/apple-pay/domains/{id}","href":"/referencia/apple-pay/consultar-dominio"},{"title":"Validar domínio Apple Pay","api":"POST /v1/apple-pay/domains/{id}/validate","href":"/referencia/apple-pay/validar-dominio"},{"title":"Validar sessão Apple Pay","api":"POST /v1/apple-pay/validate-merchant","href":"/referencia/apple-pay/validar-sessao"}]},{"group":"Saldos, saques e meios de pagamento","pages":[{"title":"Consultar saldos (carteiras)","api":"GET /v1/wallets","href":"/referencia/carteiras/listar"},{"title":"Solicitar saque","api":"POST /v1/payout-requests","href":"/referencia/saques/criar"},{"title":"Listar saques","api":"GET /v1/payout-requests","href":"/referencia/saques/listar"},{"title":"Listar meios de pagamento","api":"GET /v1/payment-methods","href":"/referencia/meios-de-pagamento/listar"}]},{"group":"Clientes","pages":[{"title":"Listar clientes","api":"GET /v1/customers","href":"/referencia/clientes/listar"},{"title":"Criar um cliente","api":"POST /v1/customers","href":"/referencia/clientes/criar"},{"title":"Consultar um cliente","api":"GET /v1/customers/{id}","href":"/referencia/clientes/consultar"},{"title":"Atualizar um cliente","api":"PUT /v1/customers/{id}","href":"/referencia/clientes/atualizar"},{"title":"Excluir um cliente","api":"DELETE /v1/customers/{id}","href":"/referencia/clientes/excluir"}]},{"group":"Cartões","pages":[{"title":"Listar cartões","api":"GET /v1/cards","href":"/referencia/cartoes/listar"},{"title":"Registrar um cartão","api":"POST /v1/cards","href":"/referencia/cartoes/registrar"},{"title":"Consultar um cartão","api":"GET /v1/cards/{id}","href":"/referencia/cartoes/consultar"},{"title":"Excluir um cartão","api":"DELETE /v1/cards/{id}","href":"/referencia/cartoes/excluir"}]},{"group":"3D Secure","pages":[{"title":"Iniciar autenticação 3DS","api":"POST /v1/three-ds/authenticate","href":"/referencia/3d-secure/iniciar"},{"title":"Enviar autenticação 3DS","api":"POST /v1/three-ds/submit","description":"Envia a autenticação 3DS ao banco depois da coleta de dados do navegador e devolve o novo status, com a URL do desafio quando o banco pedir.","href":"/referencia/3d-secure/enviar"},{"title":"Cancelar autenticação 3DS","api":"POST /v1/three-ds/cancel","href":"/referencia/3d-secure/cancelar"},{"title":"Obter resultado do 3DS","api":"POST /v1/three-ds/challenge-result","description":"Devolve o resultado final da autenticação 3D Secure, com o criptograma e os identificadores que vão na cobrança de cartão.","href":"/referencia/3d-secure/resultado-desafio"},{"title":"Retomar cobrança após 3DS","api":"POST /v1/charges/{id}/resume-3ds","href":"/referencia/3d-secure/retomar-cobranca"}]},{"group":"Planos de assinatura","pages":[{"title":"Listar planos","api":"GET /v1/subscription-plans","href":"/referencia/planos/listar"},{"title":"Criar um plano","api":"POST /v1/subscription-plans","href":"/referencia/planos/criar"},{"title":"Consultar um plano","api":"GET /v1/subscription-plans/{id}","href":"/referencia/planos/consultar"},{"title":"Atualizar um plano","api":"PUT /v1/subscription-plans/{id}","href":"/referencia/planos/atualizar"},{"title":"Enviar imagem do plano","api":"POST /v1/subscription-plans/{id}/image","href":"/referencia/planos/enviar-imagem"},{"title":"Alterar status do plano","api":"PATCH /v1/subscription-plans/{id}/status","href":"/referencia/planos/alterar-status"},{"title":"Confirmar desativação do plano","api":"PATCH /v1/subscription-plans/{id}/status/confirm","href":"/referencia/planos/confirmar-desativacao"}]},{"group":"Assinaturas","pages":[{"title":"Listar assinaturas","api":"GET /v1/subscriptions","href":"/referencia/assinaturas/listar"},{"title":"Criar uma assinatura","api":"POST /v1/subscriptions","href":"/referencia/assinaturas/criar"},{"title":"Consultar uma assinatura","api":"GET /v1/subscriptions/{id}","href":"/referencia/assinaturas/consultar"},{"title":"Atualizar uma assinatura","api":"PATCH /v1/subscriptions/{id}","href":"/referencia/assinaturas/atualizar"},{"title":"Cancelar uma assinatura","api":"POST /v1/subscriptions/{id}/cancel","href":"/referencia/assinaturas/cancelar"}]},{"group":"Connect","pages":[{"title":"Listar subcontas","api":"GET /v1/submerchants","href":"/referencia/fast-connect/listar-subcontas"},{"title":"Criar subconta","api":"POST /v1/submerchants","href":"/referencia/fast-connect/criar-subconta"},{"title":"Consultar subconta","api":"GET /v1/submerchants/{id}","href":"/referencia/fast-connect/consultar-subconta"},{"title":"Enviar documentos da subconta","api":"POST /v1/submerchants/{id}/document","href":"/referencia/fast-connect/enviar-documentos"},{"title":"Criar token de upload","api":"POST /v1/submerchants/{merchantId}/document/upload-token","href":"/referencia/fast-connect/criar-token-upload"},{"title":"Enviar documentos com token","api":"POST /v1/document-uploads","href":"/referencia/fast-connect/enviar-documentos-com-token"},{"title":"Listar representantes da subconta","api":"GET /v1/submerchants/{merchantId}/legal-representatives","href":"/referencia/fast-connect/listar-representantes"},{"title":"Chaves de API da subconta","api":"GET /v1/submerchants/{id}/api-keys","href":"/referencia/fast-connect/chaves-de-api"},{"title":"Taxas e dados da subconta","api":"GET /v1/fast-connect/sub-accounts/{id}/fees-info","href":"/referencia/fast-connect/taxas-e-dados"},{"title":"Criar saque da subconta","api":"POST /v1/submerchants/{merchantId}/payout-requests","href":"/referencia/fast-connect/criar-saque"}]},{"group":"Webhooks","pages":[{"title":"Criar endpoint de webhook","api":"POST /v1/webhook-endpoints","href":"/referencia/webhooks/criar-endpoint"},{"title":"Listar endpoints de webhook","api":"GET /v1/webhook-endpoints","href":"/referencia/webhooks/listar-endpoints"},{"title":"Atualizar endpoint de webhook","api":"PUT /v1/webhook-endpoints/{webhookId}","href":"/referencia/webhooks/atualizar-endpoint"},{"title":"Excluir endpoint de webhook","api":"DELETE /v1/webhook-endpoints/{webhookId}","href":"/referencia/webhooks/excluir-endpoint"}]}]},{"tab":"Homologação","pages":[{"title":"Homologação","href":"/homologacao/roteiro"}]},{"tab":"Guias (legado)","hidden":true,"pages":[{"title":"Guias (legado)","href":"/legado"}]},{"tab":"API Reference (legado)","hidden":true,"pages":[{"title":"API Reference (legado)","href":"/api-reference/charges/get-all-charges"}]}]},"basePath":"","title":"Cancelar autenticação 3DS - Finvia API","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js"]}