{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
Depois de iniciar a autenticação e, se pedido, coletar os dados do dispositivo (fingerprinting), esta rota envia a autenticação para o banco emissor decidir. A resposta diz se o banco aprovou sem interação, se ele quer um desafio do comprador ou se a autenticação falhou.É a segunda chamada do 3DS via API. A primeira é Iniciar autenticação.
Quando usar
Situação
O que enviar
A inicialização trouxe fingerprintingUrl e o iframe devolveu o resultado
authenticationId e fingerprintingResult
A inicialização veio com statusrequires_submission, sem fingerprintingUrl
Use a chave pública (pk_, ou pk_test_ no sandbox) no cabeçalho Basic, como usuário e com senha vazia.
Se houve fingerprinting, espere a mensagem de fim do iframe oculto (ou o tempo limite de cerca de 60 segundos) antes de chamar.
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 devolvido por POST /v1/three-ds/authenticate. Trate como texto opaco e repasse exatamente o valor recebido. Ex.: tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string
Resultado do fingerprinting em Base64, recebido pelo postMessage do iframe oculto. Omita se não houve etapa de fingerprinting. Ex.: VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==.
Respostas
string
ID da autenticação 3DS. Ex.: tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string
Status da autenticação depois do envio: requires_challenge, succeeded, failed, error ou processing. Ex.: requires_challenge.
string | null
URL do desafio. Carregue em um iframe visível quando o status for requires_challenge. Ex.: https://provedor-3ds.exemplo.com/challenge/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string | null
Resultado da autenticação. Só vem preenchido em estados finais. Ex.: authenticated.
status
Próximo passo
requires_challenge
Mostre challengeUrl em iframe visível. Quando chegar a mensagem 3ds-authentication-challenge-complete, chame resultado do desafio
succeeded
Banco aprovou sem desafio (frictionless). Chame resultado do desafio para obter o criptograma e criar a cobrança
processing
A autenticação ainda está em processamento
failed / error
Estado final. Não crie a cobrança autenticada. Ofereça nova tentativa ou outro meio de pagamento
Para o negócio: a resposta desta rota decide se o comprador vai ver uma tela do banco. Com succeeded, o pagamento segue sem interação extra. Com requires_challenge, o checkout precisa mostrar o desafio do banco emissor e esperar o comprador concluir.
HTTP
Significado
Mensagem (message)
200
Autenticação enviada
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.
Capturar o resultado do fingerprinting
A página carregada no iframe oculto avisa o fim da coleta com uma mensagem postMessage neste formato:
Registre o listener antes de carregar o iframe e aceite só mensagens que venham desse iframe e tenham o type esperado. Se a mensagem não chegar em cerca de 60 segundos (o padrão do SDK), siga sem o resultado: fingerprintingResult é opcional.
function coletarFingerprint(fingerprintingUrl, tempoLimiteMs = 60000) { return new Promise((resolve) => { const iframe = document.createElement('iframe'); iframe.style.display = 'none'; function finalizar(resultado) { window.removeEventListener('message', onMessage); clearTimeout(timer); iframe.remove(); resolve(resultado); } function onMessage(event) { if (event.source !== iframe.contentWindow) return; if (event.data?.type !== '3ds-authentication-fingerprinting-complete') return; finalizar(event.data.fingerprintingResult); } window.addEventListener('message', onMessage); const timer = setTimeout(() => finalizar(undefined), tempoLimiteMs); iframe.src = fingerprintingUrl; document.body.appendChild(iframe); });}
Para o desenvolvedor: a mensagem vem da página do provedor de 3DS, o host da fingerprintingUrl. Esse host pode mudar: valide event.source e event.data.type e não fixe um domínio em event.origin.
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
statusfailed logo após o envio
O banco recusou a autenticação
Ofereça outra forma de pagamento ou outro cartão
Checkout parado esperando o fingerprinting
Listener registrado depois do iframe, filtro pelo type errado, ou iframe bloqueado
Registre o listener antes, filtre por 3ds-authentication-fingerprinting-complete e use um tempo limite de cerca de 60 segundos
POST /v1/three-ds/submit HTTP/1.1Host: api-global.fastpaybrasil.comAuthorization: Basic <base64 de "SUA_CHAVE_PUBLICA:">Content-Type: application/json{ "authenticationId": "tdsa_1QmCRMJM0r9zBvr4OVmMRa6X", "fingerprintingResult": "VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA=="}
{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
Veja também
Iniciar autenticação
Primeiro passo do 3DS via API.
Resultado do desafio
Dados para criar a cobrança autenticada.
Cancelar autenticação
Quando o comprador desiste no meio do fluxo.
3DS via API
Guia do fluxo completo.
{"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":"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":"referencia/3d-secure/enviar","slug":"/referencia/3d-secure/enviar","pageMetadata":{"title":"Enviar autenticação 3DS","api":"POST /v1/three-ds/submit","authMethod":"basic","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"},"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: \"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.\"\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:`Depois de iniciar a autenticação e, se pedido, coletar os dados do dispositivo (fingerprinting), esta rota envia a autenticação para o banco emissor decidir. A resposta diz se o banco aprovou sem interação, se ele quer um desafio do comprador ou se a autenticação falhou.`}),`\n`,_jsxs(_components.p,{children:[`É a segunda chamada do `,_jsx(_components.strong,{children:`3DS via API`}),`. A primeira é `,_jsx(_components.a,{href:`/referencia/3d-secure/iniciar`,children:`Iniciar autenticação`}),`.`]}),`\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:`O que enviar`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A inicialização trouxe `,_jsx(_components.code,{children:`fingerprintingUrl`}),` e o iframe devolveu o resultado`]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`authenticationId`}),` e `,_jsx(_components.code,{children:`fingerprintingResult`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A inicialização veio com `,_jsx(_components.code,{children:`status`}),` `,_jsx(_components.code,{children:`requires_submission`}),`, sem `,_jsx(_components.code,{children:`fingerprintingUrl`})]}),_jsxs(_components.td,{children:[`Só o `,_jsx(_components.code,{children:`authenticationId`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`A inicialização já veio com `,_jsx(_components.code,{children:`requires_challenge`})]}),_jsxs(_components.td,{children:[`Não precisa desta rota. Mostre o desafio e vá para `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`})]})]})]})]}),`\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:[`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`,_jsx(_components.li,{children:`Se houve fingerprinting, espere a mensagem de fim do iframe oculto (ou o tempo limite de cerca de 60 segundos) antes de chamar.`}),`\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 devolvido por `,_jsx(_components.code,{children:`POST /v1/three-ds/authenticate`}),`. Trate como texto opaco e repasse exatamente o valor recebido. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ParamField,{body:`fingerprintingResult`,type:`string`,id:`param-fingerprinting-result`,children:_jsxs(_components.p,{children:[`Resultado do fingerprinting em Base64, recebido pelo `,_jsx(_components.code,{children:`postMessage`}),` do iframe oculto. Omita se não houve etapa de fingerprinting. Ex.: `,_jsx(_components.code,{children:`VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==`}),`.`]})}),`\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 3DS. 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 envio: `,_jsx(_components.code,{children:`requires_challenge`}),`, `,_jsx(_components.code,{children:`succeeded`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),` ou `,_jsx(_components.code,{children:`processing`}),`. Ex.: `,_jsx(_components.code,{children:`requires_challenge`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`challengeUrl`,type:`string | null`,id:`param-challenge-url`,children:_jsxs(_components.p,{children:[`URL do desafio. Carregue em um iframe visível quando o `,_jsx(_components.code,{children:`status`}),` for `,_jsx(_components.code,{children:`requires_challenge`}),`. Ex.: `,_jsx(_components.code,{children:`https://provedor-3ds.exemplo.com/challenge/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`outcome`,type:`string | null`,id:`param-outcome`,children:_jsxs(_components.p,{children:[`Resultado da autenticação. Só vem preenchido em estados finais. Ex.: `,_jsx(_components.code,{children:`authenticated`}),`.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.th,{children:`Próximo passo`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requires_challenge`})}),_jsxs(_components.td,{children:[`Mostre `,_jsx(_components.code,{children:`challengeUrl`}),` em iframe visível. Quando chegar a mensagem `,_jsx(_components.code,{children:`3ds-authentication-challenge-complete`}),`, chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`succeeded`})}),_jsxs(_components.td,{children:[`Banco aprovou sem desafio (frictionless). Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),` para obter o criptograma e criar a cobrança`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`processing`})}),_jsx(_components.td,{children:`A autenticação ainda está em processamento`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`failed`}),` / `,_jsx(_components.code,{children:`error`})]}),_jsx(_components.td,{children:`Estado final. Não crie a cobrança autenticada. Ofereça nova tentativa ou outro meio de pagamento`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` a resposta desta rota decide se o comprador vai ver uma tela do banco. Com `,_jsx(_components.code,{children:`succeeded`}),`, o pagamento segue sem interação extra. Com `,_jsx(_components.code,{children:`requires_challenge`}),`, o checkout precisa mostrar o desafio do banco emissor e esperar o comprador concluir.`]})}),`\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 enviada`}),_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(Heading,{level:`2`,id:`capturar-o-resultado-do-fingerprinting`,children:`Capturar o resultado do fingerprinting`}),`\n`,_jsxs(_components.p,{children:[`A página carregada no iframe oculto avisa o fim da coleta com uma mensagem `,_jsx(_components.code,{children:`postMessage`}),` neste formato:`]}),`\n`,_jsx(CodeBlock,{filename:``,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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"3ds-authentication-fingerprinting-complete\"`}),_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:` \"fingerprintingResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Registre o listener antes de carregar o iframe e aceite só mensagens que venham desse iframe e tenham o `,_jsx(_components.code,{children:`type`}),` esperado. Se a mensagem não chegar em cerca de 60 segundos (o padrão do SDK), siga sem o resultado: `,_jsx(_components.code,{children:`fingerprintingResult`}),` é opcional.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`25`,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:`25`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`function`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` coletarFingerprint(fingerprintingUrl, tempoLimiteMs = 60000) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` return`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Promise((resolve) => {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` iframe = document.createElement(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'iframe'`}),_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\":`#D4D4D4`},children:` iframe.style.display = `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'none'`}),_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\":`#C586C0`},children:` function`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` finalizar(resultado) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` window.removeEventListener(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'message'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, onMessage);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` clearTimeout(timer);`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` iframe.remove();`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resolve(resultado);`})}),`\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\":`#C586C0`},children:` function`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` onMessage(event) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (event.source !== iframe.contentWindow) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`return`}),_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:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (event.data?.type !== `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'3ds-authentication-fingerprinting-complete'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`return`}),_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:` finalizar(event.data.fingerprintingResult);`})}),`\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:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` window.addEventListener(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'message'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, onMessage);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` timer = setTimeout(() => finalizar(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`undefined`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`), tempoLimiteMs);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` iframe.src = fingerprintingUrl;`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` document.body.appendChild(iframe);`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o desenvolvedor:`}),` a mensagem vem da página do provedor de 3DS, o host da `,_jsx(_components.code,{children:`fingerprintingUrl`}),`. Esse host pode mudar: valide `,_jsx(_components.code,{children:`event.source`}),` e `,_jsx(_components.code,{children:`event.data.type`}),` e não fixe um domínio em `,_jsx(_components.code,{children:`event.origin`}),`.`]})}),`\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`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`status`}),` `,_jsx(_components.code,{children:`failed`}),` logo após o envio`]}),_jsx(_components.td,{children:`O banco recusou a autenticação`}),_jsx(_components.td,{children:`Ofereça outra forma de pagamento ou outro cartão`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Checkout parado esperando o fingerprinting`}),_jsxs(_components.td,{children:[`Listener registrado depois do iframe, filtro pelo `,_jsx(_components.code,{children:`type`}),` errado, ou iframe bloqueado`]}),_jsxs(_components.td,{children:[`Registre o listener antes, filtre por `,_jsx(_components.code,{children:`3ds-authentication-fingerprinting-complete`}),` e use um tempo limite de cerca de 60 segundos`]})]})]})]}),`\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:`Primeiro passo do 3DS via API.`}),_jsx(Card,{title:`Resultado do desafio`,icon:`square-check`,href:`/referencia/3d-secure/resultado-desafio`,children:`Dados para criar a cobrança autenticada.`}),_jsx(Card,{title:`Cancelar autenticação`,icon:`xmark`,href:`/referencia/3d-secure/cancelar`,children:`Quando o comprador desiste no meio do fluxo.`}),_jsx(Card,{title:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo.`})]})]})}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":"Enviar autenticação 3DS","api":"POST /v1/three-ds/submit","authMethod":"basic","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"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[413,422,"questExample,ResponseExample,ResponseFie"],[793,805,"questExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)"],[20732,21830,"_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`REST (JSON)`,numberOfLines:`9`,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:`9`,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/submit `}),_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\"`}),_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:` \"fingerprintingResult\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,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:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api-global.fastpaybrasil.com/v1/three-ds/submit\"`}),_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\":`#D4D4D4`},children:` -u `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$FINVIA_PUBLIC_KEY:\"`}),_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\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_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\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"authenticationId\": \"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fingerprintingResult\": \"VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Navegador`,numberOfLines:`20`,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:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` credentials = btoa(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`${FINVIA_PUBLIC_KEY}:`\"}),_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\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` fingerprintingResult = auth.fingerprintingUrl`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ? `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` coletarFingerprint(auth.fingerprintingUrl)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` : `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`undefined`}),_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\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` fetch(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api-global.fastpaybrasil.com/v1/three-ds/submit'`}),_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\":`#D4D4D4`},children:` method: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'POST'`}),_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:` headers: {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Authorization: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Basic ${credentials}`\"}),_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\":`#D4D4D4`},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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` body: JSON.stringify({ authenticationId: auth.authenticationId, fingerprintingResult }),`})}),`\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\":`#C586C0`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` submit = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json();`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (submit.status === `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'requires_challenge'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // Carregue submit.challengeUrl em um iframe visível`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200 Desafio`,numberOfLines:`6`,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:`6`,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:`\"requires_challenge\"`}),_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:` \"challengeUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://provedor-3ds.exemplo.com/challenge/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:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`200 Sem desafio`,numberOfLines:`6`,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:`6`,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:`\"succeeded\"`}),_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:` \"challengeUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_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:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"authenticated\"`})]}),`\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:`Primeiro passo do 3DS via API.`}),_jsx(Card,{title:`Resultado do desafio`,icon:`square-check`,href:`/referencia/3d-secure/resultado-desafio`,children:`Dados para criar a cobrança autenticada.`}),_jsx(Card,{title:`Cancelar autenticação`,icon:`xmark`,href:`/referencia/3d-secure/cancelar`,children:`Quando o comprador desiste no meio do fluxo.`}),_jsx(Card,{title:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo.`})]})]})}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.\")}"]]},"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":"Capturar o resultado do fingerprinting","slug":"capturar-o-resultado-do-fingerprinting","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=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">POST\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> /v1/three-ds/submit \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>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"fingerprintingResult\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==\"\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=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -X POST \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://api-global.fastpaybrasil.com/v1/three-ds/submit\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -u \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"$FINVIA_PUBLIC_KEY:\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Content-Type: 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\"> -d \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"authenticationId\": \"tdsa_1QmCRMJM0r9zBvr4OVmMRa6X\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"fingerprintingResult\": \"VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\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=\"20\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> credentials = btoa(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`${FINVIA_PUBLIC_KEY}:`\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:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> fingerprintingResult = auth.fingerprintingUrl\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ? \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> coletarFingerprint(auth.fingerprintingUrl)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> : \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">undefined\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:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response = \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> fetch(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api-global.fastpaybrasil.com/v1/three-ds/submit'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> 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:#D4D4D4\"> headers: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> Authorization: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">`Basic ${credentials}`\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:#D4D4D4\">: \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:#D4D4D4\"> body: JSON.stringify({ authenticationId: auth.authenticationId, fingerprintingResult }),\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:#C586C0\">const\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> submit = \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> response.json();\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (submit.status === \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'requires_challenge'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\"> // Carregue submit.challengeUrl em um iframe visível\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":[]},"response":{"type":"ResponseExample","children":[{"filename":"200 Desafio","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=\"6\">\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\">\"requires_challenge\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"challengeUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://provedor-3ds.exemplo.com/challenge/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\"> \"outcome\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\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":"200 Sem desafio","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=\"6\">\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\">\"succeeded\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"challengeUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"outcome\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"authenticated\"\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":"Enviar autenticação 3DS","path":"/v1/three-ds/submit","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 devolvido por `POST /v1/three-ds/authenticate` . Trate como texto opaco e repasse exatamente o valor recebido. Ex.: `tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` .","required":true}],"fingerprintingResult":[{"type":"string","description":"Resultado do fingerprinting em Base64, recebido pelo `postMessage` do iframe oculto. Omita se não houve etapa de fingerprinting. Ex.: `VGhpcyBpcyBhIHNhbXBsZSciAzRFMgTWV0aG9kIFJlc3VsdA==` ."}]}}],"examples":{"example":{"value":{"authenticationId":"\u003cstring>","fingerprintingResult":"\u003cstring>"}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"authenticationId":[{"type":"string","description":"ID da autenticação 3DS. Ex.: `tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"status":[{"type":"string","description":"Status da autenticação depois do envio: `requires_challenge` , `succeeded` , `failed` , `error` ou `processing` . Ex.: `requires_challenge` ."}],"challengeUrl":[{"type":"object","properties":{},"description":"URL do desafio. Carregue em um iframe visível quando o `status` for `requires_challenge` . Ex.: `https://provedor-3ds.exemplo.com/challenge/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"outcome":[{"type":"object","properties":{},"description":"Resultado da autenticação. Só vem preenchido em estados finais. Ex.: `authenticated` ."}]}}],"examples":{"example":{"value":{"authenticationId":"\u003cstring>","status":"\u003cstring>","challengeUrl":{},"outcome":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"fastpay","siteName":"Finvia API","title":"Enviar autenticação 3DS - Finvia API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T18:26:58.865Z","originalFileLocation":"referencia/3d-secure/enviar.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=\"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.\">\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=\"Enviar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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/enviar\">\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=Enviar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Envia+a+autentica%C3%A7%C3%A3o+3DS+ao+banco+depois+da+coleta+de+dados+do+navegador+e+devolve+o+novo+status%2C+com+a+URL+do+desafio+quando+o+banco+pedir.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=76cf7e003f57f9aafbccc285a2fa8a4140f3531dbdeb40b8f9bd1501ab31d2f7\">\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=\"Enviar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fastpay.mintlify.site/_mintlify/api/og/v2?division=3D+Secure\u0026amp;title=Enviar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Envia+a+autentica%C3%A7%C3%A3o+3DS+ao+banco+depois+da+coleta+de+dados+do+navegador+e+devolve+o+novo+status%2C+com+a+URL+do+desafio+quando+o+banco+pedir.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=76cf7e003f57f9aafbccc285a2fa8a4140f3531dbdeb40b8f9bd1501ab31d2f7\">\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/enviar\">\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/enviar.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/enviar#webpage\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar\",\"name\":\"Enviar autenticação 3DS\",\"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.\",\"dateModified\":\"2026-11-12T18:26:58.865Z\",\"isPartOf\":{\"@id\":\"https://docs.fastpaybrasil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"3D Secure\",\"item\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Enviar autenticação 3DS\",\"item\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar#apireference\",\"headline\":\"Enviar autenticação 3DS\",\"name\":\"Enviar autenticação 3DS\",\"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.\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/enviar#webpage\"},\"dateModified\":\"2026-11-12T18:26:58.865Z\",\"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/enviar.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","description":"Cria uma autenticação 3D Secure para um cartão e devolve o primeiro passo: coleta de dados do navegador ou desafio do banco.","href":"/referencia/3d-secure/iniciar"},{"title":"Enviar autenticação 3DS","api":"POST /v1/three-ds/submit","href":"/referencia/3d-secure/enviar"},{"title":"Cancelar autenticação 3DS","api":"POST /v1/three-ds/cancel","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"},{"title":"Obter resultado do 3DS","api":"POST /v1/three-ds/challenge-result","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":"Enviar 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"]}