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ário | Mensagem de erro | Requisitos da Apple |
| Dispositivo não compatível | Apple Pay não disponível ou o botão não aparece | Dispositivos: 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 verificado | Merchant validation failed ou Domain not verified | O 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 expirados | Merchant validation failed ou Certificate error | Merchant 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 Transparente.