{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
O 3D Secure (3DS) é a verificação em que o banco emissor do cartão confirma que quem está comprando é o titular. Esta rota abre essa verificação: você envia o valor, o cartão e os dados do navegador, e a Finvia devolve um authenticationId e o próximo passo. Às vezes o banco aprova sem interagir com o comprador (fluxo sem atrito, ou frictionless). Outras vezes ele pede um desafio: o comprador se autentica diretamente no banco emissor, em uma tela exibida dentro do seu checkout.Esta é a primeira chamada do 3DS via API, o fluxo em que você conduz cada etapa. Se prefere que a Finvia conduza tudo, use o 3DS gerenciado. Se usa o SDK de segurança, ele faz estas chamadas por você (SDK de 3D Secure).
Quando usar
Situação
Caminho
Você quer controlar cada etapa do 3DS no seu front-end
Não se aplica: a autenticação já vem no token do Apple Pay
Para o negócio: quando a configuração da sua conta exige 3DS, uma cobrança de cartão sem autenticação bem-sucedida é recusada. O 3DS acrescenta uma etapa ao checkout e, em alguns casos, um desafio para o comprador. Decida com o time técnico qual dos três caminhos (gerenciado, SDK ou via API) combina com o seu checkout.
Antes de chamar
Use a chave pública (pk_, ou pk_test_ no sandbox) no cabeçalho Basic, como usuário e com senha vazia. Esta rota foi feita para ser chamada do navegador, onde a chave secreta nunca pode aparecer.
A conta precisa ter um provedor de 3DS configurado. Sem ele, a rota responde 404 com a mensagem No 3DS provider configured for this gateway.
Colete os dados do navegador do comprador (objeto browser).
Nunca use a chave secreta (sk_) no front-end. As rotas de 3D Secure usam a chave pública.
O contrato desta rota declara a autenticação basic e diz, na descrição da rota, que a chave usada é a pública (pk_) como usuário do Basic. 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
Campos obrigatórios: amount, currency, card e browser.
number
required
Valor da transação na moeda informada, em reais quando a moeda é BRL. Ex.: 100.
string
required
Código da moeda no padrão ISO 4217. Ex.: BRL.
object
required
Cartão que será autenticado.
Show propriedades
string
required
Número do cartão. Ex.: 4111111111111111.
string
Nome do titular. Ex.: John Doe.
string
required
Mês de validade, de 1 a 12, com 1 ou 2 dígitos. Ex.: 12.
string
required
Ano de validade com 4 dígitos. Ex.: 2025.
object
required
Dados do navegador do comprador, usados pelo banco na análise (schema BrowserInfo).
Show propriedades
string
required
User agent do navegador. Ex.: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36.
string
required
IP do comprador. Ex.: 177.128.144.97.
string
Valor do cabeçalho Accept do navegador. Ex.: text/html,application/xhtml+xml.
string
Idioma do navegador. Ex.: pt-BR.
integer
Diferença do fuso em minutos em relação ao UTC. Ex.: -180.
boolean
Se o JavaScript está habilitado. Ex.: true.
boolean
Se o Java está habilitado. Ex.: false.
integer
Largura da tela em pixels. Ex.: 1920.
integer
Altura da tela em pixels. Ex.: 1080.
integer
Profundidade de cor da tela, em bits. Ex.: 24.
Para o desenvolvedor: quase todos os campos de browser saem direto do JavaScript da página: navigator.userAgent, navigator.language, screen.width, screen.height e screen.colorDepth. Para timezoneOffset, inverta o sinal de new Date().getTimezoneOffset(): no horário de Brasília ele devolve 180, e o exemplo do contrato é -180. O ipAddress precisa vir do seu servidor, que enxerga o IP de quem fez a requisição.
Respostas
string
Identificador da autenticação 3DS. Guarde: ele é enviado em enviar, cancelar e resultado do desafio. O valor é gerado pelo provedor de 3DS e deve ser tratado como texto opaco: repasse exatamente o que recebeu, sem validar prefixo nem tamanho. Ex.: tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string
Situação atual da autenticação: requires_submission, requires_challenge, succeeded, failed, error, canceled ou processing. Ex.: requires_submission.
string | null
URL para carregar em um iframe oculto, que coleta dados do dispositivo (fingerprinting). Ao terminar, a página envia por postMessage a mensagem { "type": "3ds-authentication-fingerprinting-complete", "fingerprintingResult": "<Base64>" }. Depois chame POST /v1/three-ds/submit. Ex.: https://provedor-3ds.exemplo.com/fingerprint/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string | null
URL para carregar em um iframe visível quando o status é requires_challenge. É nesse iframe que o comprador faz o desafio do banco. Ao final, a página envia por postMessage a mensagem { "type": "3ds-authentication-challenge-complete", "status": "succeeded" } (ou failed, error, canceled). Ex.: https://provedor-3ds.exemplo.com/challenge/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X.
string | null
Resultado da autenticação. Só vem preenchido em estados finais. Valores: authenticated, informational, attempt_acknowledged, rejected, denied, abandoned, not_supported, processing_error, internal_error, canceled. Ex.: authenticated.
As URLs de fingerprintingUrl e challengeUrl são da página do provedor de 3DS, e o host pode mudar. Não fixe o domínio no código. Ao receber uma mensagem, confira se event.source === iframe.contentWindow e se event.data.type é o tipo esperado. O fluxo completo, com exemplos, está no guia 3DS via API.
O que fazer com cada status
status
Próximo passo
requires_submission
Se veio fingerprintingUrl, carregue em iframe oculto e espere a mensagem de fim, por cerca de 60 segundos. Depois chame enviar, com fingerprintingResult se ele chegou e sem ele se não chegou. Sem fingerprintingUrl, chame enviar direto
requires_challenge
Carregue challengeUrl em iframe visível. Depois da mensagem de fim do desafio, chame resultado do desafio
processing
A autenticação ainda está em processamento
succeeded
Autenticação concluída. Busque o resultado em resultado do desafio para criar a cobrança
failed / error
Estado final. Chame resultado do desafio para obter o state e não siga com a cobrança autenticada
canceled
A autenticação foi cancelada
HTTP
Significado
Mensagem (message)
200
Autenticação iniciada
401
Chave pública inválida
Unauthorized
404
Nenhum provedor de 3DS configurado para a conta
No 3DS provider configured for this gateway
Trate o erro pelo código HTTP, não pelo texto da mensagem.O corpo de erro tem três campos:
integer
Código HTTP.
string
Mensagem descritiva do erro.
string
Tipo do erro.
Fluxo completo do 3DS via API
1
Inicie a autenticação
Chame esta rota com o cartão, o valor e os dados do navegador. Guarde o authenticationId.
2
Faça o fingerprinting, se pedido
Se a resposta trouxer fingerprintingUrl, carregue a URL em um iframe oculto e espere a mensagem 3ds-authentication-fingerprinting-complete, com o fingerprintingResult.
Se o status for requires_challenge, carregue challengeUrl em um iframe visível para o comprador concluir o desafio e espere a mensagem 3ds-authentication-challenge-complete.
5
Busque o resultado
Chame POST /v1/three-ds/challenge-result depois do fim do desafio, ou quando a autenticação já estiver em estado final. A resposta traz o criptograma e os identificadores da autenticação.
6
Crie a cobrança
Envie o resultado no campo paymentMethod.threeDS de POST /v1/charges, chamado do seu servidor com a chave secreta.
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, de outro ambiente, ou chave secreta no lugar
Use a pk_ (ou pk_test_) da conta
Chave secreta exposta no navegador
A chamada foi feita com sk_ no front-end
Troque pela chave pk_ e gere uma nova chave secreta
Iframe de fingerprinting não devolve nada
Listener de postMessage não registrado antes de carregar o iframe
Registre o listener e só depois carregue a fingerprintingUrl
{ "statusCode": 404, "message": "No 3DS provider configured for this gateway", "error": "Not Found"}
Veja também
3DS via API
Guia do fluxo completo com as rotas de 3DS.
Enviar autenticação
Próximo passo depois do fingerprinting.
Visão geral do 3D Secure
Gerenciado, SDK ou via API.
SDK de 3D Secure
O mesmo fluxo com o SDK no navegador.
{"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/iniciar","slug":"/referencia/3d-secure/iniciar","pageMetadata":{"title":"Iniciar autenticação 3DS","api":"POST /v1/three-ds/authenticate","authMethod":"basic","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"},"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: \"Cria uma autenticação 3D Secure para um cartão e devolve o primeiro passo: coleta de dados do navegador ou desafio do banco.\"\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,Expandable,Heading,Info,Note,ParamField,ResponseField,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,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(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`O 3D Secure (3DS) é a verificação em que o banco emissor do cartão confirma que quem está comprando é o titular. Esta rota abre essa verificação: você envia o valor, o cartão e os dados do navegador, e a Finvia devolve um `,_jsx(_components.code,{children:`authenticationId`}),` e o próximo passo. Às vezes o banco aprova sem interagir com o comprador (fluxo sem atrito, ou frictionless). Outras vezes ele pede um desafio: o comprador se autentica diretamente no banco emissor, em uma tela exibida dentro do seu checkout.`]}),`\n`,_jsxs(_components.p,{children:[`Esta é a primeira chamada do `,_jsx(_components.strong,{children:`3DS via API`}),`, o fluxo em que você conduz cada etapa. Se prefere que a Finvia conduza tudo, use o `,_jsx(_components.a,{href:`/guias/3d-secure/gerenciado`,children:`3DS gerenciado`}),`. Se usa o SDK de segurança, ele faz estas chamadas por você (`,_jsx(_components.a,{href:`/guias/3d-secure/sdk`,children:`SDK de 3D Secure`}),`).`]}),`\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:`Caminho`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer controlar cada etapa do 3DS no seu front-end`}),_jsxs(_components.td,{children:[`Esta rota, seguida de `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),` e `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer o fluxo pronto no navegador, com modal`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guias/3d-secure/sdk`,children:`SDK de 3D Secure`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer que a Finvia conduza a autenticação a partir da cobrança`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`threeDSMode`}),` `,_jsx(_components.code,{children:`managed`}),` em `,_jsx(_components.a,{href:`/referencia/cobrancas/criar`,children:_jsx(_components.code,{children:`POST /v1/charges`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pagamento com Apple Pay`}),_jsx(_components.td,{children:`Não se aplica: a autenticação já vem no token do Apple Pay`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` quando a configuração da sua conta exige 3DS, uma cobrança de cartão sem autenticação bem-sucedida é recusada. O 3DS acrescenta uma etapa ao checkout e, em alguns casos, um desafio para o comprador. Decida com o time técnico qual dos três caminhos (gerenciado, SDK ou via API) combina com o seu checkout.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\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. Esta rota foi feita para ser chamada do navegador, onde a chave secreta nunca pode aparecer.`]}),`\n`,_jsxs(_components.li,{children:[`A conta precisa ter um provedor de 3DS configurado. Sem ele, a rota responde `,_jsx(_components.code,{children:`404`}),` com a mensagem `,_jsx(_components.code,{children:`No 3DS provider configured for this gateway`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Colete os dados do navegador do comprador (objeto `,_jsx(_components.code,{children:`browser`}),`).`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Basic base64(pk_sua_chave_publica:)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Nunca use a chave secreta (`,_jsx(_components.code,{children:`sk_`}),`) no front-end. As rotas de 3D Secure usam a chave pública.`]})}),`\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_`}),`) como usuário do Basic. 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`,_jsxs(_components.p,{children:[`Campos obrigatórios: `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`card`}),` e `,_jsx(_components.code,{children:`browser`}),`.`]}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`Valor da transação na moeda informada, em reais quando a moeda é `,_jsx(_components.code,{children:`BRL`}),`. Ex.: `,_jsx(_components.code,{children:`100`}),`.`]})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`Código da moeda no padrão ISO 4217. Ex.: `,_jsx(_components.code,{children:`BRL`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`card`,type:`object`,required:true,id:`param-card`,children:[_jsx(_components.p,{children:`Cartão que será autenticado.`}),_jsxs(Expandable,{title:`propriedades`,children:[_jsx(ParamField,{body:`number`,type:`string`,required:true,id:`param-number`,children:_jsxs(_components.p,{children:[`Número do cartão. Ex.: `,_jsx(_components.code,{children:`4111111111111111`}),`.`]})}),_jsx(ParamField,{body:`holderName`,type:`string`,id:`param-holder-name`,children:_jsxs(_components.p,{children:[`Nome do titular. Ex.: `,_jsx(_components.code,{children:`John Doe`}),`.`]})}),_jsx(ParamField,{body:`expirationMonth`,type:`string`,required:true,id:`param-expiration-month`,children:_jsxs(_components.p,{children:[`Mês de validade, de 1 a 12, com 1 ou 2 dígitos. Ex.: `,_jsx(_components.code,{children:`12`}),`.`]})}),_jsx(ParamField,{body:`expirationYear`,type:`string`,required:true,id:`param-expiration-year`,children:_jsxs(_components.p,{children:[`Ano de validade com 4 dígitos. Ex.: `,_jsx(_components.code,{children:`2025`}),`.`]})})]})]}),`\n`,_jsxs(ParamField,{body:`browser`,type:`object`,required:true,id:`param-browser`,children:[_jsxs(_components.p,{children:[`Dados do navegador do comprador, usados pelo banco na análise (schema `,_jsx(_components.code,{children:`BrowserInfo`}),`).`]}),_jsxs(Expandable,{title:`propriedades`,children:[_jsxs(ParamField,{body:`userAgent`,type:`string`,required:true,id:`param-user-agent`,children:[`User agent do navegador. Ex.: `,_jsx(_components.code,{children:`Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36`}),`.`]}),_jsxs(ParamField,{body:`ipAddress`,type:`string`,required:true,id:`param-ip-address`,children:[`IP do comprador. Ex.: `,_jsx(_components.code,{children:`177.128.144.97`}),`.`]}),_jsxs(ParamField,{body:`acceptHeader`,type:`string`,id:`param-accept-header`,children:[`Valor do cabeçalho Accept do navegador. Ex.: `,_jsx(_components.code,{children:`text/html,application/xhtml+xml`}),`.`]}),_jsxs(ParamField,{body:`language`,type:`string`,id:`param-language`,children:[`Idioma do navegador. Ex.: `,_jsx(_components.code,{children:`pt-BR`}),`.`]}),_jsxs(ParamField,{body:`timezoneOffset`,type:`integer`,id:`param-timezone-offset`,children:[`Diferença do fuso em minutos em relação ao UTC. Ex.: `,_jsx(_components.code,{children:`-180`}),`.`]}),_jsxs(ParamField,{body:`javascriptEnabled`,type:`boolean`,id:`param-javascript-enabled`,children:[`Se o JavaScript está habilitado. Ex.: `,_jsx(_components.code,{children:`true`}),`.`]}),_jsxs(ParamField,{body:`javaEnabled`,type:`boolean`,id:`param-java-enabled`,children:[`Se o Java está habilitado. Ex.: `,_jsx(_components.code,{children:`false`}),`.`]}),_jsxs(ParamField,{body:`screenWidth`,type:`integer`,id:`param-screen-width`,children:[`Largura da tela em pixels. Ex.: `,_jsx(_components.code,{children:`1920`}),`.`]}),_jsxs(ParamField,{body:`screenHeight`,type:`integer`,id:`param-screen-height`,children:[`Altura da tela em pixels. Ex.: `,_jsx(_components.code,{children:`1080`}),`.`]}),_jsxs(ParamField,{body:`colorDepth`,type:`integer`,id:`param-color-depth`,children:[`Profundidade de cor da tela, em bits. Ex.: `,_jsx(_components.code,{children:`24`}),`.`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o desenvolvedor:`}),` quase todos os campos de `,_jsx(_components.code,{children:`browser`}),` saem direto do JavaScript da página: `,_jsx(_components.code,{children:`navigator.userAgent`}),`, `,_jsx(_components.code,{children:`navigator.language`}),`, `,_jsx(_components.code,{children:`screen.width`}),`, `,_jsx(_components.code,{children:`screen.height`}),` e `,_jsx(_components.code,{children:`screen.colorDepth`}),`. Para `,_jsx(_components.code,{children:`timezoneOffset`}),`, inverta o sinal de `,_jsx(_components.code,{children:`new Date().getTimezoneOffset()`}),`: no horário de Brasília ele devolve `,_jsx(_components.code,{children:`180`}),`, e o exemplo do contrato é `,_jsx(_components.code,{children:`-180`}),`. O `,_jsx(_components.code,{children:`ipAddress`}),` precisa vir do seu servidor, que enxerga o IP de quem fez a requisição.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsx(ResponseField,{name:`authenticationId`,type:`string`,id:`param-authentication-id`,children:_jsxs(_components.p,{children:[`Identificador da autenticação 3DS. Guarde: ele é enviado em `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),`, `,_jsx(_components.a,{href:`/referencia/3d-secure/cancelar`,children:`cancelar`}),` e `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),`. O valor é gerado pelo provedor de 3DS e deve ser tratado como texto opaco: repasse exatamente o que recebeu, sem validar prefixo nem tamanho. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Situação atual da autenticação: `,_jsx(_components.code,{children:`requires_submission`}),`, `,_jsx(_components.code,{children:`requires_challenge`}),`, `,_jsx(_components.code,{children:`succeeded`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),`, `,_jsx(_components.code,{children:`canceled`}),` ou `,_jsx(_components.code,{children:`processing`}),`. Ex.: `,_jsx(_components.code,{children:`requires_submission`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`fingerprintingUrl`,type:`string | null`,id:`param-fingerprinting-url`,children:_jsxs(_components.p,{children:[`URL para carregar em um iframe `,_jsx(_components.strong,{children:`oculto`}),`, que coleta dados do dispositivo (fingerprinting). Ao terminar, a página envia por `,_jsx(_components.code,{children:`postMessage`}),` a mensagem `,_jsx(_components.code,{children:`{ \"type\": \"3ds-authentication-fingerprinting-complete\", \"fingerprintingResult\": \"\u003cBase64>\" }`}),`. Depois chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/submit`})}),`. Ex.: `,_jsx(_components.code,{children:`https://provedor-3ds.exemplo.com/fingerprint/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`challengeUrl`,type:`string | null`,id:`param-challenge-url`,children:_jsxs(_components.p,{children:[`URL para carregar em um iframe `,_jsx(_components.strong,{children:`visível`}),` quando o `,_jsx(_components.code,{children:`status`}),` é `,_jsx(_components.code,{children:`requires_challenge`}),`. É nesse iframe que o comprador faz o desafio do banco. Ao final, a página envia por `,_jsx(_components.code,{children:`postMessage`}),` a mensagem `,_jsx(_components.code,{children:`{ \"type\": \"3ds-authentication-challenge-complete\", \"status\": \"succeeded\" }`}),` (ou `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),`, `,_jsx(_components.code,{children:`canceled`}),`). 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. Valores: `,_jsx(_components.code,{children:`authenticated`}),`, `,_jsx(_components.code,{children:`informational`}),`, `,_jsx(_components.code,{children:`attempt_acknowledged`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`denied`}),`, `,_jsx(_components.code,{children:`abandoned`}),`, `,_jsx(_components.code,{children:`not_supported`}),`, `,_jsx(_components.code,{children:`processing_error`}),`, `,_jsx(_components.code,{children:`internal_error`}),`, `,_jsx(_components.code,{children:`canceled`}),`. Ex.: `,_jsx(_components.code,{children:`authenticated`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`As URLs de `,_jsx(_components.code,{children:`fingerprintingUrl`}),` e `,_jsx(_components.code,{children:`challengeUrl`}),` são da página do provedor de 3DS, e o host pode mudar. Não fixe o domínio no código. Ao receber uma mensagem, confira se `,_jsx(_components.code,{children:`event.source === iframe.contentWindow`}),` e se `,_jsx(_components.code,{children:`event.data.type`}),` é o tipo esperado. O fluxo completo, com exemplos, está no guia `,_jsx(_components.a,{href:`/guias/3d-secure/via-api`,children:`3DS via API`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`o-que-fazer-com-cada-status`,children:`O que fazer com cada status`}),`\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_submission`})}),_jsxs(_components.td,{children:[`Se veio `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, carregue em iframe oculto e espere a mensagem de fim, por cerca de 60 segundos. Depois chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),`, com `,_jsx(_components.code,{children:`fingerprintingResult`}),` se ele chegou e sem ele se não chegou. Sem `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, chame enviar direto`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requires_challenge`})}),_jsxs(_components.td,{children:[`Carregue `,_jsx(_components.code,{children:`challengeUrl`}),` em iframe visível. Depois da mensagem de fim do desafio, 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:`processing`})}),_jsx(_components.td,{children:`A autenticação ainda está em processamento`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`succeeded`})}),_jsxs(_components.td,{children:[`Autenticação concluída. Busque o resultado em `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),` para criar a cobrança`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`failed`}),` / `,_jsx(_components.code,{children:`error`})]}),_jsxs(_components.td,{children:[`Estado final. Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),` para obter o `,_jsx(_components.code,{children:`state`}),` e não siga com a cobrança autenticada`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`canceled`})}),_jsx(_components.td,{children:`A autenticação foi cancelada`})]})]})]}),`\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 iniciada`}),_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`,_jsx(_components.p,{children:`Trate o erro pelo código HTTP, não pelo texto da mensagem.`}),`\n`,_jsx(_components.p,{children:`O corpo de erro tem três campos:`}),`\n`,_jsx(ResponseField,{name:`statusCode`,type:`integer`,id:`param-status-code`,children:`Código HTTP.`}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:`Mensagem descritiva do erro.`}),`\n`,_jsx(ResponseField,{name:`error`,type:`string`,id:`param-error`,children:`Tipo do erro.`}),`\n`,_jsx(Heading,{level:`2`,id:`fluxo-completo-do-3ds-via-api`,children:`Fluxo completo do 3DS via API`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Inicie a autenticação`,children:_jsxs(_components.p,{children:[`Chame esta rota com o cartão, o valor e os dados do navegador. Guarde o `,_jsx(_components.code,{children:`authenticationId`}),`.`]})}),_jsx(Step,{title:`Faça o fingerprinting, se pedido`,children:_jsxs(_components.p,{children:[`Se a resposta trouxer `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, carregue a URL em um iframe oculto e espere a mensagem `,_jsx(_components.code,{children:`3ds-authentication-fingerprinting-complete`}),`, com o `,_jsx(_components.code,{children:`fingerprintingResult`}),`.`]})}),_jsx(Step,{title:`Envie a autenticação`,children:_jsxs(_components.p,{children:[`Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/submit`})}),` com o `,_jsx(_components.code,{children:`authenticationId`}),` e, se houver, o `,_jsx(_components.code,{children:`fingerprintingResult`}),`.`]})}),_jsx(Step,{title:`Mostre o desafio, se pedido`,children:_jsxs(_components.p,{children:[`Se o `,_jsx(_components.code,{children:`status`}),` for `,_jsx(_components.code,{children:`requires_challenge`}),`, carregue `,_jsx(_components.code,{children:`challengeUrl`}),` em um iframe visível para o comprador concluir o desafio e espere a mensagem `,_jsx(_components.code,{children:`3ds-authentication-challenge-complete`}),`.`]})}),_jsx(Step,{title:`Busque o resultado`,children:_jsxs(_components.p,{children:[`Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:_jsx(_components.code,{children:`POST /v1/three-ds/challenge-result`})}),` depois do fim do desafio, ou quando a autenticação já estiver em estado final. A resposta traz o criptograma e os identificadores da autenticação.`]})}),_jsx(Step,{title:`Crie a cobrança`,children:_jsxs(_components.p,{children:[`Envie o resultado no campo `,_jsx(_components.code,{children:`paymentMethod.threeDS`}),` de `,_jsx(_components.a,{href:`/referencia/cobrancas/criar`,children:_jsx(_components.code,{children:`POST /v1/charges`})}),`, chamado do seu servidor com a chave secreta.`]})})]}),`\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, de outro ambiente, ou chave secreta no lugar`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da conta`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Chave secreta exposta no navegador`}),_jsxs(_components.td,{children:[`A chamada foi feita com `,_jsx(_components.code,{children:`sk_`}),` no front-end`]}),_jsxs(_components.td,{children:[`Troque pela chave `,_jsx(_components.code,{children:`pk_`}),` e gere uma nova chave secreta`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Iframe de fingerprinting não devolve nada`}),_jsxs(_components.td,{children:[`Listener de `,_jsx(_components.code,{children:`postMessage`}),` não registrado antes de carregar o iframe`]}),_jsxs(_components.td,{children:[`Registre o listener e só depois carregue a `,_jsx(_components.code,{children:`fingerprintingUrl`})]})]})]})]}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`veja-também`,children:`Veja também`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo com as rotas de 3DS.`}),_jsx(Card,{title:`Enviar autenticação`,icon:`paper-plane`,href:`/referencia/3d-secure/enviar`,children:`Próximo passo depois do fingerprinting.`}),_jsx(Card,{title:`Visão geral do 3D Secure`,icon:`shield-halved`,href:`/guias/3d-secure/visao-geral`,children:`Gerenciado, SDK ou via API.`}),_jsx(Card,{title:`SDK de 3D Secure`,icon:`cube`,href:`/guias/3d-secure/sdk`,children:`O mesmo fluxo com o SDK no navegador.`})]})]})}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":"Iniciar autenticação 3DS","api":"POST /v1/three-ds/authenticate","authMethod":"basic","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"}}},"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,Expandable,Heading,Info,Note,ParamField,RequestExample,ResponseExample,ResponseField,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,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(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`O 3D Secure (3DS) é a verificação em que o banco emissor do cartão confirma que quem está comprando é o titular. Esta rota abre essa verificação: você envia o valor, o cartão e os dados do navegador, e a Finvia devolve um `,_jsx(_components.code,{children:`authenticationId`}),` e o próximo passo. Às vezes o banco aprova sem interagir com o comprador (fluxo sem atrito, ou frictionless). Outras vezes ele pede um desafio: o comprador se autentica diretamente no banco emissor, em uma tela exibida dentro do seu checkout.`]}),`\n`,_jsxs(_components.p,{children:[`Esta é a primeira chamada do `,_jsx(_components.strong,{children:`3DS via API`}),`, o fluxo em que você conduz cada etapa. Se prefere que a Finvia conduza tudo, use o `,_jsx(_components.a,{href:`/guias/3d-secure/gerenciado`,children:`3DS gerenciado`}),`. Se usa o SDK de segurança, ele faz estas chamadas por você (`,_jsx(_components.a,{href:`/guias/3d-secure/sdk`,children:`SDK de 3D Secure`}),`).`]}),`\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:`Caminho`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer controlar cada etapa do 3DS no seu front-end`}),_jsxs(_components.td,{children:[`Esta rota, seguida de `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),` e `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer o fluxo pronto no navegador, com modal`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guias/3d-secure/sdk`,children:`SDK de 3D Secure`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Você quer que a Finvia conduza a autenticação a partir da cobrança`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`threeDSMode`}),` `,_jsx(_components.code,{children:`managed`}),` em `,_jsx(_components.a,{href:`/referencia/cobrancas/criar`,children:_jsx(_components.code,{children:`POST /v1/charges`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pagamento com Apple Pay`}),_jsx(_components.td,{children:`Não se aplica: a autenticação já vem no token do Apple Pay`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` quando a configuração da sua conta exige 3DS, uma cobrança de cartão sem autenticação bem-sucedida é recusada. O 3DS acrescenta uma etapa ao checkout e, em alguns casos, um desafio para o comprador. Decida com o time técnico qual dos três caminhos (gerenciado, SDK ou via API) combina com o seu checkout.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\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. Esta rota foi feita para ser chamada do navegador, onde a chave secreta nunca pode aparecer.`]}),`\n`,_jsxs(_components.li,{children:[`A conta precisa ter um provedor de 3DS configurado. Sem ele, a rota responde `,_jsx(_components.code,{children:`404`}),` com a mensagem `,_jsx(_components.code,{children:`No 3DS provider configured for this gateway`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Colete os dados do navegador do comprador (objeto `,_jsx(_components.code,{children:`browser`}),`).`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Authorization: Basic base64(pk_sua_chave_publica:)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Nunca use a chave secreta (`,_jsx(_components.code,{children:`sk_`}),`) no front-end. As rotas de 3D Secure usam a chave pública.`]})}),`\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_`}),`) como usuário do Basic. 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`,_jsxs(_components.p,{children:[`Campos obrigatórios: `,_jsx(_components.code,{children:`amount`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`card`}),` e `,_jsx(_components.code,{children:`browser`}),`.`]}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`Valor da transação na moeda informada, em reais quando a moeda é `,_jsx(_components.code,{children:`BRL`}),`. Ex.: `,_jsx(_components.code,{children:`100`}),`.`]})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`Código da moeda no padrão ISO 4217. Ex.: `,_jsx(_components.code,{children:`BRL`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`card`,type:`object`,required:true,id:`param-card`,children:[_jsx(_components.p,{children:`Cartão que será autenticado.`}),_jsxs(Expandable,{title:`propriedades`,children:[_jsx(ParamField,{body:`number`,type:`string`,required:true,id:`param-number`,children:_jsxs(_components.p,{children:[`Número do cartão. Ex.: `,_jsx(_components.code,{children:`4111111111111111`}),`.`]})}),_jsx(ParamField,{body:`holderName`,type:`string`,id:`param-holder-name`,children:_jsxs(_components.p,{children:[`Nome do titular. Ex.: `,_jsx(_components.code,{children:`John Doe`}),`.`]})}),_jsx(ParamField,{body:`expirationMonth`,type:`string`,required:true,id:`param-expiration-month`,children:_jsxs(_components.p,{children:[`Mês de validade, de 1 a 12, com 1 ou 2 dígitos. Ex.: `,_jsx(_components.code,{children:`12`}),`.`]})}),_jsx(ParamField,{body:`expirationYear`,type:`string`,required:true,id:`param-expiration-year`,children:_jsxs(_components.p,{children:[`Ano de validade com 4 dígitos. Ex.: `,_jsx(_components.code,{children:`2025`}),`.`]})})]})]}),`\n`,_jsxs(ParamField,{body:`browser`,type:`object`,required:true,id:`param-browser`,children:[_jsxs(_components.p,{children:[`Dados do navegador do comprador, usados pelo banco na análise (schema `,_jsx(_components.code,{children:`BrowserInfo`}),`).`]}),_jsxs(Expandable,{title:`propriedades`,children:[_jsxs(ParamField,{body:`userAgent`,type:`string`,required:true,id:`param-user-agent`,children:[`User agent do navegador. Ex.: `,_jsx(_components.code,{children:`Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36`}),`.`]}),_jsxs(ParamField,{body:`ipAddress`,type:`string`,required:true,id:`param-ip-address`,children:[`IP do comprador. Ex.: `,_jsx(_components.code,{children:`177.128.144.97`}),`.`]}),_jsxs(ParamField,{body:`acceptHeader`,type:`string`,id:`param-accept-header`,children:[`Valor do cabeçalho Accept do navegador. Ex.: `,_jsx(_components.code,{children:`text/html,application/xhtml+xml`}),`.`]}),_jsxs(ParamField,{body:`language`,type:`string`,id:`param-language`,children:[`Idioma do navegador. Ex.: `,_jsx(_components.code,{children:`pt-BR`}),`.`]}),_jsxs(ParamField,{body:`timezoneOffset`,type:`integer`,id:`param-timezone-offset`,children:[`Diferença do fuso em minutos em relação ao UTC. Ex.: `,_jsx(_components.code,{children:`-180`}),`.`]}),_jsxs(ParamField,{body:`javascriptEnabled`,type:`boolean`,id:`param-javascript-enabled`,children:[`Se o JavaScript está habilitado. Ex.: `,_jsx(_components.code,{children:`true`}),`.`]}),_jsxs(ParamField,{body:`javaEnabled`,type:`boolean`,id:`param-java-enabled`,children:[`Se o Java está habilitado. Ex.: `,_jsx(_components.code,{children:`false`}),`.`]}),_jsxs(ParamField,{body:`screenWidth`,type:`integer`,id:`param-screen-width`,children:[`Largura da tela em pixels. Ex.: `,_jsx(_components.code,{children:`1920`}),`.`]}),_jsxs(ParamField,{body:`screenHeight`,type:`integer`,id:`param-screen-height`,children:[`Altura da tela em pixels. Ex.: `,_jsx(_components.code,{children:`1080`}),`.`]}),_jsxs(ParamField,{body:`colorDepth`,type:`integer`,id:`param-color-depth`,children:[`Profundidade de cor da tela, em bits. Ex.: `,_jsx(_components.code,{children:`24`}),`.`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o desenvolvedor:`}),` quase todos os campos de `,_jsx(_components.code,{children:`browser`}),` saem direto do JavaScript da página: `,_jsx(_components.code,{children:`navigator.userAgent`}),`, `,_jsx(_components.code,{children:`navigator.language`}),`, `,_jsx(_components.code,{children:`screen.width`}),`, `,_jsx(_components.code,{children:`screen.height`}),` e `,_jsx(_components.code,{children:`screen.colorDepth`}),`. Para `,_jsx(_components.code,{children:`timezoneOffset`}),`, inverta o sinal de `,_jsx(_components.code,{children:`new Date().getTimezoneOffset()`}),`: no horário de Brasília ele devolve `,_jsx(_components.code,{children:`180`}),`, e o exemplo do contrato é `,_jsx(_components.code,{children:`-180`}),`. O `,_jsx(_components.code,{children:`ipAddress`}),` precisa vir do seu servidor, que enxerga o IP de quem fez a requisição.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsx(ResponseField,{name:`authenticationId`,type:`string`,id:`param-authentication-id`,children:_jsxs(_components.p,{children:[`Identificador da autenticação 3DS. Guarde: ele é enviado em `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),`, `,_jsx(_components.a,{href:`/referencia/3d-secure/cancelar`,children:`cancelar`}),` e `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),`. O valor é gerado pelo provedor de 3DS e deve ser tratado como texto opaco: repasse exatamente o que recebeu, sem validar prefixo nem tamanho. Ex.: `,_jsx(_components.code,{children:`tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[`Situação atual da autenticação: `,_jsx(_components.code,{children:`requires_submission`}),`, `,_jsx(_components.code,{children:`requires_challenge`}),`, `,_jsx(_components.code,{children:`succeeded`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),`, `,_jsx(_components.code,{children:`canceled`}),` ou `,_jsx(_components.code,{children:`processing`}),`. Ex.: `,_jsx(_components.code,{children:`requires_submission`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`fingerprintingUrl`,type:`string | null`,id:`param-fingerprinting-url`,children:_jsxs(_components.p,{children:[`URL para carregar em um iframe `,_jsx(_components.strong,{children:`oculto`}),`, que coleta dados do dispositivo (fingerprinting). Ao terminar, a página envia por `,_jsx(_components.code,{children:`postMessage`}),` a mensagem `,_jsx(_components.code,{children:`{ \"type\": \"3ds-authentication-fingerprinting-complete\", \"fingerprintingResult\": \"\u003cBase64>\" }`}),`. Depois chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/submit`})}),`. Ex.: `,_jsx(_components.code,{children:`https://provedor-3ds.exemplo.com/fingerprint/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`challengeUrl`,type:`string | null`,id:`param-challenge-url`,children:_jsxs(_components.p,{children:[`URL para carregar em um iframe `,_jsx(_components.strong,{children:`visível`}),` quando o `,_jsx(_components.code,{children:`status`}),` é `,_jsx(_components.code,{children:`requires_challenge`}),`. É nesse iframe que o comprador faz o desafio do banco. Ao final, a página envia por `,_jsx(_components.code,{children:`postMessage`}),` a mensagem `,_jsx(_components.code,{children:`{ \"type\": \"3ds-authentication-challenge-complete\", \"status\": \"succeeded\" }`}),` (ou `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`error`}),`, `,_jsx(_components.code,{children:`canceled`}),`). 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. Valores: `,_jsx(_components.code,{children:`authenticated`}),`, `,_jsx(_components.code,{children:`informational`}),`, `,_jsx(_components.code,{children:`attempt_acknowledged`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`denied`}),`, `,_jsx(_components.code,{children:`abandoned`}),`, `,_jsx(_components.code,{children:`not_supported`}),`, `,_jsx(_components.code,{children:`processing_error`}),`, `,_jsx(_components.code,{children:`internal_error`}),`, `,_jsx(_components.code,{children:`canceled`}),`. Ex.: `,_jsx(_components.code,{children:`authenticated`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`As URLs de `,_jsx(_components.code,{children:`fingerprintingUrl`}),` e `,_jsx(_components.code,{children:`challengeUrl`}),` são da página do provedor de 3DS, e o host pode mudar. Não fixe o domínio no código. Ao receber uma mensagem, confira se `,_jsx(_components.code,{children:`event.source === iframe.contentWindow`}),` e se `,_jsx(_components.code,{children:`event.data.type`}),` é o tipo esperado. O fluxo completo, com exemplos, está no guia `,_jsx(_components.a,{href:`/guias/3d-secure/via-api`,children:`3DS via API`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`o-que-fazer-com-cada-status`,children:`O que fazer com cada status`}),`\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_submission`})}),_jsxs(_components.td,{children:[`Se veio `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, carregue em iframe oculto e espere a mensagem de fim, por cerca de 60 segundos. Depois chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:`enviar`}),`, com `,_jsx(_components.code,{children:`fingerprintingResult`}),` se ele chegou e sem ele se não chegou. Sem `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, chame enviar direto`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`requires_challenge`})}),_jsxs(_components.td,{children:[`Carregue `,_jsx(_components.code,{children:`challengeUrl`}),` em iframe visível. Depois da mensagem de fim do desafio, 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:`processing`})}),_jsx(_components.td,{children:`A autenticação ainda está em processamento`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`succeeded`})}),_jsxs(_components.td,{children:[`Autenticação concluída. Busque o resultado em `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),` para criar a cobrança`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`failed`}),` / `,_jsx(_components.code,{children:`error`})]}),_jsxs(_components.td,{children:[`Estado final. Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:`resultado do desafio`}),` para obter o `,_jsx(_components.code,{children:`state`}),` e não siga com a cobrança autenticada`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`canceled`})}),_jsx(_components.td,{children:`A autenticação foi cancelada`})]})]})]}),`\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 iniciada`}),_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`,_jsx(_components.p,{children:`Trate o erro pelo código HTTP, não pelo texto da mensagem.`}),`\n`,_jsx(_components.p,{children:`O corpo de erro tem três campos:`}),`\n`,_jsx(ResponseField,{name:`statusCode`,type:`integer`,id:`param-status-code`,children:`Código HTTP.`}),`\n`,_jsx(ResponseField,{name:`message`,type:`string`,id:`param-message`,children:`Mensagem descritiva do erro.`}),`\n`,_jsx(ResponseField,{name:`error`,type:`string`,id:`param-error`,children:`Tipo do erro.`}),`\n`,_jsx(Heading,{level:`2`,id:`fluxo-completo-do-3ds-via-api`,children:`Fluxo completo do 3DS via API`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Inicie a autenticação`,children:_jsxs(_components.p,{children:[`Chame esta rota com o cartão, o valor e os dados do navegador. Guarde o `,_jsx(_components.code,{children:`authenticationId`}),`.`]})}),_jsx(Step,{title:`Faça o fingerprinting, se pedido`,children:_jsxs(_components.p,{children:[`Se a resposta trouxer `,_jsx(_components.code,{children:`fingerprintingUrl`}),`, carregue a URL em um iframe oculto e espere a mensagem `,_jsx(_components.code,{children:`3ds-authentication-fingerprinting-complete`}),`, com o `,_jsx(_components.code,{children:`fingerprintingResult`}),`.`]})}),_jsx(Step,{title:`Envie a autenticação`,children:_jsxs(_components.p,{children:[`Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/enviar`,children:_jsx(_components.code,{children:`POST /v1/three-ds/submit`})}),` com o `,_jsx(_components.code,{children:`authenticationId`}),` e, se houver, o `,_jsx(_components.code,{children:`fingerprintingResult`}),`.`]})}),_jsx(Step,{title:`Mostre o desafio, se pedido`,children:_jsxs(_components.p,{children:[`Se o `,_jsx(_components.code,{children:`status`}),` for `,_jsx(_components.code,{children:`requires_challenge`}),`, carregue `,_jsx(_components.code,{children:`challengeUrl`}),` em um iframe visível para o comprador concluir o desafio e espere a mensagem `,_jsx(_components.code,{children:`3ds-authentication-challenge-complete`}),`.`]})}),_jsx(Step,{title:`Busque o resultado`,children:_jsxs(_components.p,{children:[`Chame `,_jsx(_components.a,{href:`/referencia/3d-secure/resultado-desafio`,children:_jsx(_components.code,{children:`POST /v1/three-ds/challenge-result`})}),` depois do fim do desafio, ou quando a autenticação já estiver em estado final. A resposta traz o criptograma e os identificadores da autenticação.`]})}),_jsx(Step,{title:`Crie a cobrança`,children:_jsxs(_components.p,{children:[`Envie o resultado no campo `,_jsx(_components.code,{children:`paymentMethod.threeDS`}),` de `,_jsx(_components.a,{href:`/referencia/cobrancas/criar`,children:_jsx(_components.code,{children:`POST /v1/charges`})}),`, chamado do seu servidor com a chave secreta.`]})})]}),`\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, de outro ambiente, ou chave secreta no lugar`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da conta`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Chave secreta exposta no navegador`}),_jsxs(_components.td,{children:[`A chamada foi feita com `,_jsx(_components.code,{children:`sk_`}),` no front-end`]}),_jsxs(_components.td,{children:[`Troque pela chave `,_jsx(_components.code,{children:`pk_`}),` e gere uma nova chave secreta`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Iframe de fingerprinting não devolve nada`}),_jsxs(_components.td,{children:[`Listener de `,_jsx(_components.code,{children:`postMessage`}),` não registrado antes de carregar o iframe`]}),_jsxs(_components.td,{children:[`Registre o listener e só depois carregue a `,_jsx(_components.code,{children:`fingerprintingUrl`})]})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`REST (JSON)`,numberOfLines:`27`,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:`27`,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/authenticate `}),_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:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`100`}),_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BRL\"`}),_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:` \"card\"`}),_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:` \"number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4111111111111111\"`}),_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:` \"holderName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Joao Silva\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"expirationMonth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"12\"`}),_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:` \"expirationYear\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025\"`})]}),`\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:` \"browser\"`}),_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:` \"userAgent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\"`}),_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:` \"ipAddress\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"177.128.144.97\"`}),_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:` \"acceptHeader\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"text/html,application/xhtml+xml\"`}),_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:` \"language\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pt-BR\"`}),_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:` \"timezoneOffset\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-180`}),_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:` \"javascriptEnabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"javaEnabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_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:` \"screenWidth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1920`}),_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:` \"screenHeight\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1080`}),_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:` \"colorDepth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`24`})]}),`\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`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`25`,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:`25`,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/authenticate\"`}),_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:` \"amount\": 100,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"currency\": \"BRL\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"card\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"number\": \"4111111111111111\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"holderName\": \"Joao Silva\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expirationMonth\": \"12\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"expirationYear\": \"2025\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` \"browser\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ipAddress\": \"177.128.144.97\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"acceptHeader\": \"text/html,application/xhtml+xml\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"language\": \"pt-BR\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"timezoneOffset\": -180,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"javascriptEnabled\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"javaEnabled\": false,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"screenWidth\": 1920,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"screenHeight\": 1080,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"colorDepth\": 24`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Navegador`,numberOfLines:`28`,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:`28`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Chave pública: pode ficar no front-end`})}),`\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:` 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:` 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/authenticate'`}),_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({`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` amount: 100,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` currency: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'BRL'`}),_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:` card: { number: cardNumber, holderName, expirationMonth: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'12'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, expirationYear: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'2025'`}),_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:` browser: {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` userAgent: navigator.userAgent,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ipAddress: ipDoComprador, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// obtido pelo seu servidor`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` language: navigator.language,`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` timezoneOffset: -`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`new`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Date().getTimezoneOffset(),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` javascriptEnabled: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`true`}),_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:` javaEnabled: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`false`}),_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:` screenWidth: screen.width,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` screenHeight: screen.height,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` colorDepth: screen.colorDepth,`})}),`\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`,_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:` auth = `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.json();`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200 Fingerprinting`,numberOfLines:`7`,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:`7`,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_submission\"`}),_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:` \"fingerprintingUrl\"`}),_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/fingerprint/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:` \"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:`#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 Desafio`,numberOfLines:`7`,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:`7`,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:` \"fingerprintingUrl\"`}),_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:` \"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:`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:`3DS via API`,icon:`code`,href:`/guias/3d-secure/via-api`,children:`Guia do fluxo completo com as rotas de 3DS.`}),_jsx(Card,{title:`Enviar autenticação`,icon:`paper-plane`,href:`/referencia/3d-secure/enviar`,children:`Próximo passo depois do fingerprinting.`}),_jsx(Card,{title:`Visão geral do 3D Secure`,icon:`shield-halved`,href:`/guias/3d-secure/visao-geral`,children:`Gerenciado, SDK ou via API.`}),_jsx(Card,{title:`SDK de 3D Secure`,icon:`cube`,href:`/guias/3d-secure/sdk`,children:`O mesmo fluxo com o SDK no navegador.`})]})]})}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":"Iniciar autenticação 3DS","api":"POST /v1/three-ds/authenticate","authMethod":"basic","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"}}}},"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":"O que fazer com cada status","slug":"o-que-fazer-com-cada-status","depth":3,"children":[]}]},{"title":"Fluxo completo do 3DS via API","slug":"fluxo-completo-do-3ds-via-api","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=\"27\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">POST\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> /v1/three-ds/authenticate \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\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">100\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"BRL\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"card\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"4111111111111111\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"holderName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Joao Silva\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expirationMonth\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"12\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expirationYear\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2025\"\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:#116329;--shiki-dark:#9CDCFE\"> \"browser\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"userAgent\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"ipAddress\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"177.128.144.97\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"acceptHeader\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"text/html,application/xhtml+xml\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"language\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"pt-BR\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"timezoneOffset\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">-180\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"javascriptEnabled\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"javaEnabled\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"screenWidth\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1920\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"screenHeight\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1080\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"colorDepth\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">24\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\">}\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=\"25\">\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/authenticate\"\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\"> \"amount\": 100,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"currency\": \"BRL\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"card\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"number\": \"4111111111111111\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"holderName\": \"Joao Silva\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"expirationMonth\": \"12\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"expirationYear\": \"2025\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"browser\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"userAgent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"ipAddress\": \"177.128.144.97\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"acceptHeader\": \"text/html,application/xhtml+xml\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"language\": \"pt-BR\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"timezoneOffset\": -180,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"javascriptEnabled\": true,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"javaEnabled\": false,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"screenWidth\": 1920,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"screenHeight\": 1080,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"colorDepth\": 24\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\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=\"28\">\u003cspan class=\"line\">\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\">// Chave pública: pode ficar no front-end\u003c/span>\u003c/span>\n\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\"> 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/authenticate'\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({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> amount: 100,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> currency: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'BRL'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> card: { number: cardNumber, holderName, expirationMonth: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'12'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, expirationYear: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'2025'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> browser: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> userAgent: navigator.userAgent,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ipAddress: ipDoComprador, \u003c/span>\u003cspan style=\"color:#6E7781;--shiki-dark:#6A9955\">// obtido pelo seu servidor\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> language: navigator.language,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> timezoneOffset: -\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">new\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> Date().getTimezoneOffset(),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> javascriptEnabled: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> javaEnabled: \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">false\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> screenWidth: screen.width,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> screenHeight: screen.height,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> colorDepth: screen.colorDepth,\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\"> }),\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\"> auth = \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\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200 Fingerprinting","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=\"7\">\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_submission\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"fingerprintingUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://provedor-3ds.exemplo.com/fingerprint/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\"> \"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:#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 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=\"7\">\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\"> \"fingerprintingUrl\"\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\"> \"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":"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":"Iniciar autenticação 3DS","path":"/v1/three-ds/authenticate","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":{"amount":[{"type":"number","description":"Valor da transação na moeda informada, em reais quando a moeda é `BRL` . Ex.: `100` .","required":true}],"currency":[{"type":"string","description":"Código da moeda no padrão ISO 4217. Ex.: `BRL` .","required":true}],"card":[{"type":"object","properties":{"number":[{"type":"string","description":"Número do cartão. Ex.: `4111111111111111` .","required":true}],"holderName":[{"type":"string","description":"Nome do titular. Ex.: `John Doe` ."}],"expirationMonth":[{"type":"string","description":"Mês de validade, de 1 a 12, com 1 ou 2 dígitos. Ex.: `12` .","required":true}],"expirationYear":[{"type":"string","description":"Ano de validade com 4 dígitos. Ex.: `2025` .","required":true}]},"description":"Cartão que será autenticado.","required":true}],"browser":[{"type":"object","properties":{"userAgent":[{"type":"string","description":"User agent do navegador. Ex.: `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36` .","required":true}],"ipAddress":[{"type":"string","description":"IP do comprador. Ex.: `177.128.144.97` .","required":true}],"acceptHeader":[{"type":"string","description":"Valor do cabeçalho Accept do navegador. Ex.: `text/html,application/xhtml+xml` ."}],"language":[{"type":"string","description":"Idioma do navegador. Ex.: `pt-BR` ."}],"timezoneOffset":[{"type":"integer","description":"Diferença do fuso em minutos em relação ao UTC. Ex.: `-180` ."}],"javascriptEnabled":[{"type":"boolean","description":"Se o JavaScript está habilitado. Ex.: `true` ."}],"javaEnabled":[{"type":"boolean","description":"Se o Java está habilitado. Ex.: `false` ."}],"screenWidth":[{"type":"integer","description":"Largura da tela em pixels. Ex.: `1920` ."}],"screenHeight":[{"type":"integer","description":"Altura da tela em pixels. Ex.: `1080` ."}],"colorDepth":[{"type":"integer","description":"Profundidade de cor da tela, em bits. Ex.: `24` ."}]},"description":"Dados do navegador do comprador, usados pelo banco na análise (schema `BrowserInfo` ).","required":true}]}}],"examples":{"example":{"value":{"amount":123,"currency":"\u003cstring>","card":{"number":"\u003cstring>","holderName":"\u003cstring>","expirationMonth":"\u003cstring>","expirationYear":"\u003cstring>"},"browser":{"userAgent":"\u003cstring>","ipAddress":"\u003cstring>","acceptHeader":"\u003cstring>","language":"\u003cstring>","timezoneOffset":123,"javascriptEnabled":true,"javaEnabled":true,"screenWidth":123,"screenHeight":123,"colorDepth":123}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"authenticationId":[{"type":"string","description":"Identificador da autenticação 3DS. Guarde: ele é enviado em enviar , cancelar e resultado do desafio . O valor é gerado pelo provedor de 3DS e deve ser tratado como texto opaco: repasse exatamente o que recebeu, sem validar prefixo nem tamanho. Ex.: `tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"status":[{"type":"string","description":"Situação atual da autenticação: `requires_submission` , `requires_challenge` , `succeeded` , `failed` , `error` , `canceled` ou `processing` . Ex.: `requires_submission` ."}],"fingerprintingUrl":[{"type":"object","properties":{},"description":"URL para carregar em um iframe oculto , que coleta dados do dispositivo (fingerprinting). Ao terminar, a página envia por `postMessage` a mensagem `{ \"type\": \"3ds-authentication-fingerprinting-complete\", \"fingerprintingResult\": \"\u003cBase64>\" }` . Depois chame `POST /v1/three-ds/submit` . Ex.: `https://provedor-3ds.exemplo.com/fingerprint/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"challengeUrl":[{"type":"object","properties":{},"description":"URL para carregar em um iframe visível quando o `status` é `requires_challenge` . É nesse iframe que o comprador faz o desafio do banco. Ao final, a página envia por `postMessage` a mensagem `{ \"type\": \"3ds-authentication-challenge-complete\", \"status\": \"succeeded\" }` (ou `failed` , `error` , `canceled` ). Ex.: `https://provedor-3ds.exemplo.com/challenge/tdsa_1QmCRMJM0r9zBvr4OVmMRa6X` ."}],"outcome":[{"type":"object","properties":{},"description":"Resultado da autenticação. Só vem preenchido em estados finais. Valores: `authenticated` , `informational` , `attempt_acknowledged` , `rejected` , `denied` , `abandoned` , `not_supported` , `processing_error` , `internal_error` , `canceled` . Ex.: `authenticated` ."}],"statusCode":[{"type":"integer","description":"Código HTTP."}],"message":[{"type":"string","description":"Mensagem descritiva do erro."}],"error":[{"type":"string","description":"Tipo do erro."}]}}],"examples":{"example":{"value":{"authenticationId":"\u003cstring>","status":"\u003cstring>","fingerprintingUrl":{},"challengeUrl":{},"outcome":{},"statusCode":123,"message":"\u003cstring>","error":"\u003cstring>"}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"fastpay","siteName":"Finvia API","title":"Iniciar autenticação 3DS - Finvia API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T18:26:58.878Z","originalFileLocation":"referencia/3d-secure/iniciar.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=\"Cria uma autenticação 3D Secure para um cartão e devolve o primeiro passo: coleta de dados do navegador ou desafio do banco.\">\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=\"Iniciar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cria uma autenticação 3D Secure para um cartão e devolve o primeiro passo: coleta de dados do navegador ou desafio do banco.\">\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/iniciar\">\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=Iniciar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Cria+uma+autentica%C3%A7%C3%A3o+3D+Secure+para+um+cart%C3%A3o+e+devolve+o+primeiro+passo%3A+coleta+de+dados+do+navegador+ou+desafio+do+banco.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=09c19de52bb0dc9333f715b89b7f73350f872247702895308dda961488c0de88\">\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=\"Iniciar autenticação 3DS - Finvia API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cria uma autenticação 3D Secure para um cartão e devolve o primeiro passo: coleta de dados do navegador ou desafio do banco.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fastpay.mintlify.site/_mintlify/api/og/v2?division=3D+Secure\u0026amp;title=Iniciar+autentica%C3%A7%C3%A3o+3DS\u0026amp;description=Cria+uma+autentica%C3%A7%C3%A3o+3D+Secure+para+um+cart%C3%A3o+e+devolve+o+primeiro+passo%3A+coleta+de+dados+do+navegador+ou+desafio+do+banco.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=09c19de52bb0dc9333f715b89b7f73350f872247702895308dda961488c0de88\">\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/iniciar\">\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/iniciar.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/iniciar#webpage\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar\",\"name\":\"Iniciar autenticação 3DS\",\"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.\",\"dateModified\":\"2026-11-12T18:26:58.878Z\",\"isPartOf\":{\"@id\":\"https://docs.fastpaybrasil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Finvia API\",\"item\":\"https://docs.fastpaybrasil.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Iniciar autenticação 3DS\",\"item\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar#apireference\",\"headline\":\"Iniciar autenticação 3DS\",\"name\":\"Iniciar autenticação 3DS\",\"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.\",\"url\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/3d-secure/iniciar#webpage\"},\"dateModified\":\"2026-11-12T18:26:58.878Z\",\"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/iniciar.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}","description":"Remove um cartão salvo e revoga o token no cofre da Finvia.","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","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":"Iniciar 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"]}