Recursos para IA

Possíveis erros

A seguir são descritos os erros mais frequentes ao integrar Apple Pay, suas causas e como resolvê-los.

Erros por requisitos da Apple

CenárioMensagem de erroRequisitos da Apple
Dispositivo não compatívelApple Pay não disponível ou o botão não apareceDispositivos: iPhone ou iPad com iOS 10.1 ou superior, Mac com macOS Sierra ou superior e Touch ID ou Face ID.

Navegador: Safari principalmente; outros navegadores têm suporte limitado.

Configuração: Carteira configurada com pelo menos um cartão válido.
Domínio não verificadoMerchant validation failed ou Domain not verifiedO domínio deve estar registrado e verificado no Portal Apple Developer.

O arquivo de verificação .well-known/apple-developer-merchantid-domain-association deve estar acessível.

HTTPS é obrigatório; o Apple Pay não funciona em HTTP.
Certificados inválidos ou expiradosMerchant validation failed ou Certificate errorMerchant Identity Certificate válido e não expirado.

Payment Processing Certificate configurado corretamente.

Os certificados devem estar associados ao Merchant ID correto.

Erros da Orders API

O Apple Pay processa os pagamentos com a Orders API, portanto os erros retornados ao criar a order ou o token do cartão são os mesmos do Checkout API. Veja a lista completa de códigos, mensagens e soluções possíveis em Possíveis erros do Checkout API .