AI resources
Possible errors
Below are the most common errors when integrating Apple Pay, their causes, and how to resolve them.
Errors due to Apple requirements
| Scenario | Error message | Apple requirements |
| Incompatible device | Apple Pay not available or the button does not appear | Devices: iPhone or iPad with iOS 10.1 or later, Mac with macOS Sierra or later and Touch ID or Face ID. Browser: Safari primarily; other browsers have limited support. Configuration: Wallet configured with at least one valid card. |
| Unverified domain | Merchant validation failed or Domain not verified | The domain must be registered and verified in the Apple Developer Portal. The verification file .well-known/apple-developer-merchantid-domain-association must be accessible.HTTPS is required; Apple Pay does not work over HTTP. |
| Invalid or expired certificates | Merchant validation failed or Certificate error | Valid, non-expired Merchant Identity Certificate. Payment Processing Certificate configured correctly. Certificates must be associated with the correct Merchant ID. |
Orders API errors
Apple Pay processes payments with the Orders API, so the errors returned when creating the order or the card token are the same as in Checkout API. Check the full list of codes, messages, and possible solutions in Possible errors of Checkout API.