A cada compra, quando o cliente toca no botão Apple Pay, o Apple Pay JS dispara o evento onvalidatemerchant e pede uma sessão de merchant. O seu front-end chama esta rota com a validationURL recebida da Apple e o hostname da página, e repassa a resposta para session.completeMerchantValidation(). Sem esse passo, a folha de pagamento não abre.
Para o negócio: esta é a única chamada do fluxo feita pelo navegador do cliente. Ela usa a chave pública, que pode ficar no código do site. A cobrança continua sendo criada pelo seu backend, com a chave secreta.
Autenticação com a chave pública
Esta rota usa Basic com a chave pública (pk_ em produção ou pk_test_ no Modo Teste) como usuário e senha vazia: Authorization: Basic base64("pk_...:"). A chave secreta (sk_) não deve ir para o navegador.
A conta dona da chave pública precisa estar ativa.
A sessão é sempre validada no provedor real, mesmo com pk_test_, porque a folha do Safari só abre com uma sessão real. A cobrança feita depois com a chave de teste cai no ambiente de teste.
Quando usar
Situação
O que fazer
Evento onvalidatemerchant disparado
Chame esta rota uma vez e repasse a resposta à Apple
Cliente fechou e abriu a folha de novo
Uma nova sessão gera um novo onvalidatemerchant: chame de novo
A conta já registrou pelo menos um domínio. Sem nenhum, a API responde 422APPLE_PAY_PROVIDER_NOT_ENABLED.
Corpo da requisição
string
required
O valor de event.validationURL recebido no onvalidatemerchant. Precisa ser https, com host apple.com ou um subdomínio dele, sem porta e com até 2048 caracteres. Repasse sem alterar.
string
required
O hostname da página, window.location.hostname, com até 255 caracteres. Precisa ser um domínio registrado e verificado na conta da chave pública. Ex.: checkout.minhaloja.com.br.
Respostas
A resposta 200 é o objeto de sessão de merchant da Apple. Ele é opaco: não leia nem altere os campos. Repasse o objeto inteiro, como veio, para session.completeMerchantValidation().
HTTP
Significado
Código ou mensagem
200
Sessão criada
Objeto de sessão da Apple
400
validationUrl fora das regras (não https, host fora de apple.com, com porta ou longa demais)
APPLE_PAY_INVALID_VALIDATION_URL
400
domain inválido
APPLE_PAY_INVALID_DOMAIN
400
Domínio de outra conta, não registrado ou ainda não verificado
APPLE_PAY_DOMAIN_NOT_VERIFIED
401
Chave pública inválida
Unauthorized
422
A conta ainda não registrou nenhum domínio
APPLE_PAY_PROVIDER_NOT_ENABLED
422
Processador de Apple Pay não configurado para a sua conta
APPLE_PAY_PROCESSOR_NOT_CONFIGURED
429
Limite de tentativas atingido: 20 por IP a cada 5 minutos, além de um teto global da plataforma
APPLE_PAY_RATE_LIMITED
500
Falha de autenticação entre a Finvia e o processador
APPLE_PAY_PROVIDER_AUTH_FAILED
503
Processador indisponível
APPLE_PAY_PROVIDER_UNAVAILABLE
Os erros APPLE_PAY_* vêm no formato { "code": "...", "message": "..." }, sem statusCode. Erros de validação de campo vêm como { "statusCode": 400, "message": [...], "error": "Bad Request" }. Em qualquer erro, chame session.abort() e ofereça outra forma de pagamento.
Erros comuns
Sintoma
Causa
Como resolver
400APPLE_PAY_DOMAIN_NOT_VERIFIED
O domain enviado é diferente do registrado (ex.: www), é de outra conta ou ainda não está verified
O exemplo 200 mostra a forma usual da sessão da Apple, com valores omitidos. O conteúdo é definido pela Apple e pode mudar: trate o objeto como opaco.
Veja também
Guia de Apple Pay
Fluxo completo no navegador e no backend.
Criar uma cobrança
Envio do token em paymentMethod.wallet.
Credenciais e ambientes
Onde obter a chave pública.
Listar domínios
Confira os domínios verificados.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finvia API","colors":{"primary":"#017AFF","light":"#4DA3FF","dark":"#0060CC"},"logo":{"light":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/logo-light.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=bfbd4f1bf8f8d6b73724e72ebba0ba64","dark":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/logo-dark.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=1a10605df3e53d5d16ec8b1c0a9a7825","href":"https://www.finvia.com.br"},"favicon":{"light":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/favicon.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=6111b3cd8adc2008cdbcb57057e2e341","dark":"https://mintcdn.com/fastpay/UVYyZPiX-wuJ8Tcd/images/favicon.png?fit=max\u0026auto=format\u0026n=UVYyZPiX-wuJ8Tcd\u0026q=85\u0026s=6111b3cd8adc2008cdbcb57057e2e341"},"api":{"mdx":{"auth":{"method":"basic"},"server":"https://api-global.fastpaybrasil.com"}},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#070D15"}},"navbar":{"links":[{"href":"https://wa.me/5531998560666","label":"Suporte"}],"primary":{"type":"button","label":"Acessar painel","href":"https://app.finvia.com.br"}},"footer":{"socials":{"website":"https://www.finvia.com.br","instagram":"https://www.instagram.com/finvia.br"}},"contextual":{"options":["copy","view","chatgpt","claude","aistudio","perplexity","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fastpay","hasAudioNarration":false,"actualSubdomain":"fastpay","customDomains":["docs.fastpaybrasil.com"],"gitSource":{"type":"github","owner":"fastsoftbrasil","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af6094a3ff3f2c220966cc1","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Referência da API","count":55},{"language":"default","tag":"Guias","count":30},{"language":"default","tag":"Casos de uso","count":18},{"language":"default","tag":"Connect","count":18},{"language":"default","tag":"Documentação","count":12},{"language":"default","tag":"Cobranças","count":10},{"language":"default","tag":"3D Secure","count":9},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Assinaturas","count":8},{"language":"default","tag":"Planos de assinatura","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"referencia/apple-pay/validar-sessao","slug":"/referencia/apple-pay/validar-sessao","pageMetadata":{"title":"Validar sessão Apple Pay","api":"POST /v1/apple-pay/validate-merchant","authMethod":"basic","description":"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.","href":"/referencia/apple-pay/validar-sessao"},"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: \"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\"\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`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Heading,Info,Note,ParamField,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A cada compra, quando o cliente toca no botão Apple Pay, o Apple Pay JS dispara o evento `,_jsx(_components.code,{children:`onvalidatemerchant`}),` e pede uma sessão de merchant. O seu front-end chama esta rota com a `,_jsx(_components.code,{children:`validationURL`}),` recebida da Apple e o hostname da página, e repassa a resposta para `,_jsx(_components.code,{children:`session.completeMerchantValidation()`}),`. Sem esse passo, a folha de pagamento não abre.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` esta é a única chamada do fluxo feita pelo navegador do cliente. Ela usa a chave pública, que pode ficar no código do site. A cobrança continua sendo criada pelo seu backend, com a chave secreta.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`autenticação-com-a-chave-pública`,children:`Autenticação com a chave pública`}),`\n`,_jsxs(_components.p,{children:[`Esta rota usa `,_jsx(_components.strong,{children:`Basic com a chave pública`}),` (`,_jsx(_components.code,{children:`pk_`}),` em produção ou `,_jsx(_components.code,{children:`pk_test_`}),` no Modo Teste) como usuário e senha vazia: `,_jsx(_components.code,{children:`Authorization: Basic base64(\"pk_...:\")`}),`. A chave secreta (`,_jsx(_components.code,{children:`sk_`}),`) não deve ir para o navegador.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A conta dona da chave pública precisa estar ativa.`}),`\n`,_jsxs(_components.li,{children:[`A sessão é sempre validada no provedor real, mesmo com `,_jsx(_components.code,{children:`pk_test_`}),`, porque a folha do Safari só abre com uma sessão real. A cobrança feita depois com a chave de teste cai no ambiente de teste.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`quando-usar`,children:`Quando usar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situação`}),_jsx(_components.th,{children:`O que fazer`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Evento `,_jsx(_components.code,{children:`onvalidatemerchant`}),` disparado`]}),_jsx(_components.td,{children:`Chame esta rota uma vez e repasse a resposta à Apple`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cliente fechou e abriu a folha de novo`}),_jsxs(_components.td,{children:[`Uma nova sessão gera um novo `,_jsx(_components.code,{children:`onvalidatemerchant`}),`: chame de novo`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Teste em laço ou várias chamadas por clique`}),_jsx(_components.td,{children:`Evite: há limite de tentativas por IP`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`O hostname da página está registrado e `,_jsx(_components.code,{children:`verified`}),` na conta da chave pública (`,_jsx(_components.a,{href:`/referencia/apple-pay/registrar-dominio`,children:`Registrar domínio`}),` e `,_jsx(_components.a,{href:`/referencia/apple-pay/validar-dominio`,children:`Validar domínio`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`A conta já registrou pelo menos um domínio. Sem nenhum, a API responde `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`validationUrl`,type:`string`,required:true,id:`param-validation-url`,children:_jsxs(_components.p,{children:[`O valor de `,_jsx(_components.code,{children:`event.validationURL`}),` recebido no `,_jsx(_components.code,{children:`onvalidatemerchant`}),`. Precisa ser `,_jsx(_components.code,{children:`https`}),`, com host `,_jsx(_components.code,{children:`apple.com`}),` ou um subdomínio dele, sem porta e com até 2048 caracteres. Repasse sem alterar.`]})}),`\n`,_jsx(ParamField,{body:`domain`,type:`string`,required:true,id:`param-domain`,children:_jsxs(_components.p,{children:[`O hostname da página, `,_jsx(_components.code,{children:`window.location.hostname`}),`, com até 255 caracteres. Precisa ser um domínio registrado e verificado na conta da chave pública. Ex.: `,_jsx(_components.code,{children:`checkout.minhaloja.com.br`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsxs(_components.p,{children:[`A resposta `,_jsx(_components.code,{children:`200`}),` é o objeto de sessão de merchant da Apple. Ele é `,_jsx(_components.strong,{children:`opaco`}),`: não leia nem altere os campos. Repasse o objeto inteiro, como veio, para `,_jsx(_components.code,{children:`session.completeMerchantValidation()`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Significado`}),_jsx(_components.th,{children:`Código ou mensagem`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Sessão criada`}),_jsx(_components.td,{children:`Objeto de sessão da Apple`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`validationUrl`}),` fora das regras (não `,_jsx(_components.code,{children:`https`}),`, host fora de `,_jsx(_components.code,{children:`apple.com`}),`, com porta ou longa demais)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_INVALID_VALIDATION_URL`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`domain`}),` inválido`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_INVALID_DOMAIN`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Domínio de outra conta, não registrado ou ainda não verificado`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_DOMAIN_NOT_VERIFIED`})})]}),_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:`422`})}),_jsx(_components.td,{children:`A conta ainda não registrou nenhum domínio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:`Processador de Apple Pay não configurado para a sua conta`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROCESSOR_NOT_CONFIGURED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`Limite de tentativas atingido: 20 por IP a cada 5 minutos, além de um teto global da plataforma`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_RATE_LIMITED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Falha de autenticação entre a Finvia e o processador`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_AUTH_FAILED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:`Processador indisponível`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_UNAVAILABLE`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Os erros `,_jsx(_components.code,{children:`APPLE_PAY_*`}),` vêm no formato `,_jsx(_components.code,{children:`{ \"code\": \"...\", \"message\": \"...\" }`}),`, sem `,_jsx(_components.code,{children:`statusCode`}),`. Erros de validação de campo vêm como `,_jsx(_components.code,{children:`{ \"statusCode\": 400, \"message\": [...], \"error\": \"Bad Request\" }`}),`. Em qualquer erro, chame `,_jsx(_components.code,{children:`session.abort()`}),` e ofereça outra forma de pagamento.`]}),`\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:`400`}),` `,_jsx(_components.code,{children:`APPLE_PAY_DOMAIN_NOT_VERIFIED`})]}),_jsxs(_components.td,{children:[`O `,_jsx(_components.code,{children:`domain`}),` enviado é diferente do registrado (ex.: `,_jsx(_components.code,{children:`www`}),`), é de outra conta ou ainda não está `,_jsx(_components.code,{children:`verified`})]}),_jsxs(_components.td,{children:[`Confira com `,_jsx(_components.a,{href:`/referencia/apple-pay/listar-dominios`,children:_jsx(_components.code,{children:`GET /v1/apple-pay/domains`})}),` e valide o domínio`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`})]}),_jsx(_components.td,{children:`Nenhum domínio registrado na conta`}),_jsx(_components.td,{children:`Registre o primeiro domínio: é o registro que habilita o fluxo`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`429`}),` `,_jsx(_components.code,{children:`APPLE_PAY_RATE_LIMITED`})]}),_jsx(_components.td,{children:`Mais de 20 tentativas do mesmo IP em 5 minutos`}),_jsxs(_components.td,{children:[`Chame uma vez por `,_jsx(_components.code,{children:`onvalidatemerchant`}),`, sem repetir em laço`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Chave pública errada ou com a chave secreta no lugar`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da mesma conta que registrou o domínio`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A folha abre e fecha em seguida`}),_jsx(_components.td,{children:`A resposta foi alterada antes de chegar à Apple`}),_jsxs(_components.td,{children:[`Passe o JSON recebido direto para `,_jsx(_components.code,{children:`completeMerchantValidation()`})]})]})]})]}),`\n`,`\n`,`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O exemplo `,_jsx(_components.code,{children:`200`}),` mostra a forma usual da sessão da Apple, com valores omitidos. O conteúdo é definido pela Apple e pode mudar: trate o objeto como opaco.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`veja-também`,children:`Veja também`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Guia de Apple Pay`,icon:`apple`,href:`/guias/cobrancas/apple-pay`,children:`Fluxo completo no navegador e no backend.`}),_jsxs(Card,{title:`Criar uma cobrança`,icon:`credit-card`,href:`/referencia/cobrancas/criar`,children:[`Envio do token em `,_jsx(_components.code,{children:`paymentMethod.wallet`}),`.`]}),_jsx(Card,{title:`Credenciais e ambientes`,icon:`key`,href:`/primeiros-passos/credenciais-e-ambientes`,children:`Onde obter a chave pública.`}),_jsx(Card,{title:`Listar domínios`,icon:`list`,href:`/referencia/apple-pay/listar-dominios`,children:`Confira os domínios verificados.`})]})]})}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":"Validar sessão Apple Pay","api":"POST /v1/apple-pay/validate-merchant","authMethod":"basic","description":"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.","href":"/referencia/apple-pay/validar-sessao"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Note,ParamField,RequestExample,ResponseExample,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A cada compra, quando o cliente toca no botão Apple Pay, o Apple Pay JS dispara o evento `,_jsx(_components.code,{children:`onvalidatemerchant`}),` e pede uma sessão de merchant. O seu front-end chama esta rota com a `,_jsx(_components.code,{children:`validationURL`}),` recebida da Apple e o hostname da página, e repassa a resposta para `,_jsx(_components.code,{children:`session.completeMerchantValidation()`}),`. Sem esse passo, a folha de pagamento não abre.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Para o negócio:`}),` esta é a única chamada do fluxo feita pelo navegador do cliente. Ela usa a chave pública, que pode ficar no código do site. A cobrança continua sendo criada pelo seu backend, com a chave secreta.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`autenticação-com-a-chave-pública`,children:`Autenticação com a chave pública`}),`\n`,_jsxs(_components.p,{children:[`Esta rota usa `,_jsx(_components.strong,{children:`Basic com a chave pública`}),` (`,_jsx(_components.code,{children:`pk_`}),` em produção ou `,_jsx(_components.code,{children:`pk_test_`}),` no Modo Teste) como usuário e senha vazia: `,_jsx(_components.code,{children:`Authorization: Basic base64(\"pk_...:\")`}),`. A chave secreta (`,_jsx(_components.code,{children:`sk_`}),`) não deve ir para o navegador.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A conta dona da chave pública precisa estar ativa.`}),`\n`,_jsxs(_components.li,{children:[`A sessão é sempre validada no provedor real, mesmo com `,_jsx(_components.code,{children:`pk_test_`}),`, porque a folha do Safari só abre com uma sessão real. A cobrança feita depois com a chave de teste cai no ambiente de teste.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`quando-usar`,children:`Quando usar`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situação`}),_jsx(_components.th,{children:`O que fazer`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Evento `,_jsx(_components.code,{children:`onvalidatemerchant`}),` disparado`]}),_jsx(_components.td,{children:`Chame esta rota uma vez e repasse a resposta à Apple`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cliente fechou e abriu a folha de novo`}),_jsxs(_components.td,{children:[`Uma nova sessão gera um novo `,_jsx(_components.code,{children:`onvalidatemerchant`}),`: chame de novo`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Teste em laço ou várias chamadas por clique`}),_jsx(_components.td,{children:`Evite: há limite de tentativas por IP`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`antes-de-chamar`,children:`Antes de chamar`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`O hostname da página está registrado e `,_jsx(_components.code,{children:`verified`}),` na conta da chave pública (`,_jsx(_components.a,{href:`/referencia/apple-pay/registrar-dominio`,children:`Registrar domínio`}),` e `,_jsx(_components.a,{href:`/referencia/apple-pay/validar-dominio`,children:`Validar domínio`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`A conta já registrou pelo menos um domínio. Sem nenhum, a API responde `,_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`corpo-da-requisição`,children:`Corpo da requisição`}),`\n`,_jsx(ParamField,{body:`validationUrl`,type:`string`,required:true,id:`param-validation-url`,children:_jsxs(_components.p,{children:[`O valor de `,_jsx(_components.code,{children:`event.validationURL`}),` recebido no `,_jsx(_components.code,{children:`onvalidatemerchant`}),`. Precisa ser `,_jsx(_components.code,{children:`https`}),`, com host `,_jsx(_components.code,{children:`apple.com`}),` ou um subdomínio dele, sem porta e com até 2048 caracteres. Repasse sem alterar.`]})}),`\n`,_jsx(ParamField,{body:`domain`,type:`string`,required:true,id:`param-domain`,children:_jsxs(_components.p,{children:[`O hostname da página, `,_jsx(_components.code,{children:`window.location.hostname`}),`, com até 255 caracteres. Precisa ser um domínio registrado e verificado na conta da chave pública. Ex.: `,_jsx(_components.code,{children:`checkout.minhaloja.com.br`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`respostas`,children:`Respostas`}),`\n`,_jsxs(_components.p,{children:[`A resposta `,_jsx(_components.code,{children:`200`}),` é o objeto de sessão de merchant da Apple. Ele é `,_jsx(_components.strong,{children:`opaco`}),`: não leia nem altere os campos. Repasse o objeto inteiro, como veio, para `,_jsx(_components.code,{children:`session.completeMerchantValidation()`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Significado`}),_jsx(_components.th,{children:`Código ou mensagem`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`200`})}),_jsx(_components.td,{children:`Sessão criada`}),_jsx(_components.td,{children:`Objeto de sessão da Apple`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`validationUrl`}),` fora das regras (não `,_jsx(_components.code,{children:`https`}),`, host fora de `,_jsx(_components.code,{children:`apple.com`}),`, com porta ou longa demais)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_INVALID_VALIDATION_URL`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`domain`}),` inválido`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_INVALID_DOMAIN`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:`Domínio de outra conta, não registrado ou ainda não verificado`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_DOMAIN_NOT_VERIFIED`})})]}),_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:`422`})}),_jsx(_components.td,{children:`A conta ainda não registrou nenhum domínio`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsx(_components.td,{children:`Processador de Apple Pay não configurado para a sua conta`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROCESSOR_NOT_CONFIGURED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:`Limite de tentativas atingido: 20 por IP a cada 5 minutos, além de um teto global da plataforma`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_RATE_LIMITED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`500`})}),_jsx(_components.td,{children:`Falha de autenticação entre a Finvia e o processador`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_AUTH_FAILED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:`Processador indisponível`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_UNAVAILABLE`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Os erros `,_jsx(_components.code,{children:`APPLE_PAY_*`}),` vêm no formato `,_jsx(_components.code,{children:`{ \"code\": \"...\", \"message\": \"...\" }`}),`, sem `,_jsx(_components.code,{children:`statusCode`}),`. Erros de validação de campo vêm como `,_jsx(_components.code,{children:`{ \"statusCode\": 400, \"message\": [...], \"error\": \"Bad Request\" }`}),`. Em qualquer erro, chame `,_jsx(_components.code,{children:`session.abort()`}),` e ofereça outra forma de pagamento.`]}),`\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:`400`}),` `,_jsx(_components.code,{children:`APPLE_PAY_DOMAIN_NOT_VERIFIED`})]}),_jsxs(_components.td,{children:[`O `,_jsx(_components.code,{children:`domain`}),` enviado é diferente do registrado (ex.: `,_jsx(_components.code,{children:`www`}),`), é de outra conta ou ainda não está `,_jsx(_components.code,{children:`verified`})]}),_jsxs(_components.td,{children:[`Confira com `,_jsx(_components.a,{href:`/referencia/apple-pay/listar-dominios`,children:_jsx(_components.code,{children:`GET /v1/apple-pay/domains`})}),` e valide o domínio`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`422`}),` `,_jsx(_components.code,{children:`APPLE_PAY_PROVIDER_NOT_ENABLED`})]}),_jsx(_components.td,{children:`Nenhum domínio registrado na conta`}),_jsx(_components.td,{children:`Registre o primeiro domínio: é o registro que habilita o fluxo`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`429`}),` `,_jsx(_components.code,{children:`APPLE_PAY_RATE_LIMITED`})]}),_jsx(_components.td,{children:`Mais de 20 tentativas do mesmo IP em 5 minutos`}),_jsxs(_components.td,{children:[`Chame uma vez por `,_jsx(_components.code,{children:`onvalidatemerchant`}),`, sem repetir em laço`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:`Chave pública errada ou com a chave secreta no lugar`}),_jsxs(_components.td,{children:[`Use a `,_jsx(_components.code,{children:`pk_`}),` (ou `,_jsx(_components.code,{children:`pk_test_`}),`) da mesma conta que registrou o domínio`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A folha abre e fecha em seguida`}),_jsx(_components.td,{children:`A resposta foi alterada antes de chegar à Apple`}),_jsxs(_components.td,{children:[`Passe o JSON recebido direto para `,_jsx(_components.code,{children:`completeMerchantValidation()`})]})]})]})]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`Navegador`,numberOfLines:`19`,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:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`session`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onvalidatemerchant`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` async`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`event`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api-global.fastpaybrasil.com/v1/apple-pay/validate-merchant'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Basic '`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` btoa`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'pk_SUA_CHAVE_PUBLICA:'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` validationUrl:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` event`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`validationURL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` domain:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` window`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`location`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`hostname`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ok`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`throw`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'validate-merchant falhou'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` session`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`completeMerchantValidation`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` response`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`error`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` session`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`abort`}),_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(CodeBlock,{filename:`REST (JSON)`,numberOfLines:`9`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/apple-pay/validate-merchant `}),_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:` \"validationUrl\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://apple-pay-gateway.apple.com/paymentservices/startSession\"`}),_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:` \"domain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"checkout.minhaloja.com.br\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api-global.fastpaybrasil.com/v1/apple-pay/validate-merchant\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -u`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FINVIA_PUBLIC_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`:\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"validationUrl\": \"https://apple-pay-gateway.apple.com/paymentservices/startSession\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"domain\": \"checkout.minhaloja.com.br\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`10`,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:`10`,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:` \"epochTimestamp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1761588000000`}),_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:` \"expiresAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1761591600000`}),_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:` \"merchantSessionIdentifier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"nonce\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchantIdentifier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"domainName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"checkout.minhaloja.com.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:` \"displayName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"signature\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"APPLE_PAY_DOMAIN_NOT_VERIFIED\"`}),_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:`\"...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`O exemplo `,_jsx(_components.code,{children:`200`}),` mostra a forma usual da sessão da Apple, com valores omitidos. O conteúdo é definido pela Apple e pode mudar: trate o objeto como opaco.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`veja-também`,children:`Veja também`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Guia de Apple Pay`,icon:`apple`,href:`/guias/cobrancas/apple-pay`,children:`Fluxo completo no navegador e no backend.`}),_jsxs(Card,{title:`Criar uma cobrança`,icon:`credit-card`,href:`/referencia/cobrancas/criar`,children:[`Envio do token em `,_jsx(_components.code,{children:`paymentMethod.wallet`}),`.`]}),_jsx(Card,{title:`Credenciais e ambientes`,icon:`key`,href:`/primeiros-passos/credenciais-e-ambientes`,children:`Onde obter a chave pública.`}),_jsx(Card,{title:`Listar domínios`,icon:`list`,href:`/referencia/apple-pay/listar-dominios`,children:`Confira os domínios verificados.`})]})]})}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":"Validar sessão Apple Pay","api":"POST /v1/apple-pay/validate-merchant","authMethod":"basic","description":"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.","href":"/referencia/apple-pay/validar-sessao"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Autenticação com a chave pública","slug":"autenticação-com-a-chave-pública","depth":2,"children":[]},{"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":"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":"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=\"19\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">session\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">onvalidatemerchant\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> async\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#9CDCFE\">event\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\">=>\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> try\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> const\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> response\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> =\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> await\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> fetch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'https://api-global.fastpaybrasil.com/v1/apple-pay/validate-merchant'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> method:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'POST'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> headers:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Content-Type'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'application/json'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> Authorization:\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> 'Basic '\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\"> +\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> btoa\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'pk_SUA_CHAVE_PUBLICA:'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">),\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> body:\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#4FC1FF\"> JSON\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">stringify\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">({\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> validationUrl:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> event\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">validationURL\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> domain:\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> window\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">location\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">hostname\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\"> });\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\"> if\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D4D4D4\">!\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">ok\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">throw\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#569CD6\"> new\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\"> Error\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">'validate-merchant falhou'\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">);\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> session\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">completeMerchantValidation\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">(\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> response\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">json\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">());\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> } \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">catch\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> (\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">error\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">) {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\"> session\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">.\u003c/span>\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">abort\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\">};\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"REST (JSON)","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"http\">\u003ccode language=\"http\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#C586C0\">POST\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> /v1/apple-pay/validate-merchant \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\"> \"validationUrl\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"https://apple-pay-gateway.apple.com/paymentservices/startSession\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"domain\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"checkout.minhaloja.com.br\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api-global.fastpaybrasil.com/v1/apple-pay/validate-merchant\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -u\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$FINVIA_PUBLIC_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">:\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"validationUrl\": \"https://apple-pay-gateway.apple.com/paymentservices/startSession\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"domain\": \"checkout.minhaloja.com.br\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"10\">\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\"> \"epochTimestamp\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1761588000000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"expiresAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1761591600000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchantSessionIdentifier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"nonce\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"merchantIdentifier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"domainName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"checkout.minhaloja.com.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\"> \"displayName\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"signature\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"...\"\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":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"APPLE_PAY_DOMAIN_NOT_VERIFIED\"\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\">\"...\"\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":"Validar sessão Apple Pay","path":"/v1/apple-pay/validate-merchant","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":{"validationUrl":[{"type":"string","description":"O valor de `event.validationURL` recebido no `onvalidatemerchant` . Precisa ser `https` , com host `apple.com` ou um subdomínio dele, sem porta e com até 2048 caracteres. Repasse sem alterar.","required":true}],"domain":[{"type":"string","description":"O hostname da página, `window.location.hostname` , com até 255 caracteres. Precisa ser um domínio registrado e verificado na conta da chave pública. Ex.: `checkout.minhaloja.com.br` .","required":true}]}}],"examples":{"example":{"value":{"validationUrl":"\u003cstring>","domain":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"fastpay","siteName":"Finvia API","title":"Validar sessão Apple Pay - Finvia API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T18:26:50.827Z","originalFileLocation":"referencia/apple-pay/validar-sessao.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=\"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\">\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=\"Validar sessão Apple Pay - Finvia API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finvia API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao\">\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=Apple+Pay\u0026amp;title=Validar+sess%C3%A3o+Apple+Pay\u0026amp;description=Chamada+feita+pelo+navegador+no+evento+onvalidatemerchant%3A+devolve+a+sess%C3%A3o+de+merchant+da+Apple+que+abre+a+folha+de+pagamento.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=a1cd40a894b009592fe8a2082df80dfb14de7f7bd643e83a9c39e91aa66721ce\">\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=\"Validar sessão Apple Pay - Finvia API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fastpay.mintlify.site/_mintlify/api/og/v2?division=Apple+Pay\u0026amp;title=Validar+sess%C3%A3o+Apple+Pay\u0026amp;description=Chamada+feita+pelo+navegador+no+evento+onvalidatemerchant%3A+devolve+a+sess%C3%A3o+de+merchant+da+Apple+que+abre+a+folha+de+pagamento.\u0026amp;theme=00238d697dd6a7b6c3df0175\u0026amp;signature=a1cd40a894b009592fe8a2082df80dfb14de7f7bd643e83a9c39e91aa66721ce\">\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/apple-pay/validar-sessao\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/referencia/apple-pay/validar-sessao.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/apple-pay/validar-sessao#webpage\",\"url\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao\",\"name\":\"Validar sessão Apple Pay\",\"description\":\"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\",\"dateModified\":\"2026-11-12T18:26:50.827Z\",\"isPartOf\":{\"@id\":\"https://docs.fastpaybrasil.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Apple Pay\",\"item\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/registrar-dominio\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Validar sessão Apple Pay\",\"item\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao#apireference\",\"headline\":\"Validar sessão Apple Pay\",\"name\":\"Validar sessão Apple Pay\",\"description\":\"Chamada feita pelo navegador no evento onvalidatemerchant: devolve a sessão de merchant da Apple que abre a folha de pagamento.\",\"url\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fastpaybrasil.com/referencia/apple-pay/validar-sessao#webpage\"},\"dateModified\":\"2026-11-12T18:26:50.827Z\",\"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/apple-pay/validar-sessao.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","description":"Confere o arquivo de verificação hospedado no seu domínio e, se estiver correto, deixa o domínio pronto para o Apple Pay.","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","description":"Devolve as carteiras de um merchant, uma por moeda, com saldo disponível, pendente e reservado e o equivalente em dólar.","href":"/referencia/carteiras/listar"},{"title":"Solicitar saque","api":"POST /v1/payout-requests","href":"/referencia/saques/criar"},{"title":"Listar saques","api":"GET /v1/payout-requests","href":"/referencia/saques/listar"},{"title":"Listar meios de pagamento","api":"GET /v1/payment-methods","href":"/referencia/meios-de-pagamento/listar"}]},{"group":"Clientes","pages":[{"title":"Listar clientes","api":"GET /v1/customers","href":"/referencia/clientes/listar"},{"title":"Criar um cliente","api":"POST /v1/customers","href":"/referencia/clientes/criar"},{"title":"Consultar um cliente","api":"GET /v1/customers/{id}","href":"/referencia/clientes/consultar"},{"title":"Atualizar um cliente","api":"PUT /v1/customers/{id}","href":"/referencia/clientes/atualizar"},{"title":"Excluir um cliente","api":"DELETE /v1/customers/{id}","href":"/referencia/clientes/excluir"}]},{"group":"Cartões","pages":[{"title":"Listar cartões","api":"GET /v1/cards","href":"/referencia/cartoes/listar"},{"title":"Registrar um cartão","api":"POST /v1/cards","href":"/referencia/cartoes/registrar"},{"title":"Consultar um cartão","api":"GET /v1/cards/{id}","href":"/referencia/cartoes/consultar"},{"title":"Excluir um cartão","api":"DELETE /v1/cards/{id}","href":"/referencia/cartoes/excluir"}]},{"group":"3D Secure","pages":[{"title":"Iniciar autenticação 3DS","api":"POST /v1/three-ds/authenticate","href":"/referencia/3d-secure/iniciar"},{"title":"Enviar autenticação 3DS","api":"POST /v1/three-ds/submit","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":"Validar sessão Apple Pay - 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"]}