Apple Pay—Troubleshooting & Error Codes

This section provides a comprehensive guide to common issues and error codes encountered during Apple Pay integration (Server-to-Server). For unlisted issues, please contact EdfaPay Integration Support.

Common Troubleshooting Scenarios

The table below outlines frequent integration challenges, their potential causes, and actionable solutions.

Issue	Possible Cause	Solution
Apple Pay button not visible	Apple Pay JS API not loaded Merchant domain not verified with Apple Device/browser not supporting Apple Pay	Verify Apple Pay support on the test device (Safari, iOS/macOS). Ensure domain verification with Apple is complete. Confirm correct loading of the Apple Pay JS script.
Payment not completed error	Payment token not generated Apple Merchant ID mismatch Frontend not sending correct token	Ensure `merchantIdentifier` accurately matches your Apple Merchant ID. Thoroughly debug the `onpaymentauthorized` event. Log and verify the token object before transmitting it to the backend.
Hash Mismatch / Invalid Hash	Incorrect parameters used in hash generation Incorrect parameter order Password/key mismatch	Adhere strictly to the hash generation formula. Verify no extra spaces or encoding issues are present. Use the same `password` and `identifier` configured in EdfaPay.
400 Bad Request API status	Missing required parameters Incorrect parameter name or format	Cross-reference the request body against the official documentation. Ensure the JSON object is valid and properly escaped.
500 Internal Server Error API status	Invalid Apple Pay payment token structure Gateway processing error	Verify that `parameters` contains a valid Apple Pay token object. Contact EdfaPay support with the complete request/response log.

Apple Pay Error Codes

This table lists common Apple Pay error codes, their meanings, and recommended actions.

Error Code	Meaning	Suggested Action
`ERR_INVALID_HASH`	Generated hash does not match server calculation	Recheck hash generation logic and parameter order.
`ERR_INVALID_IDENTIFIER`	Apple Merchant Identifier is invalid or unregistered	Use the correct Apple Merchant ID configured in your Apple Developer account.
`ERR_PAYMENT_TOKEN_INVALID`	Apple Pay token is malformed or expired	Ensure the token is freshly captured from the frontend and passed as a JSON string.
`ERR_UNSUPPORTED_CURRENCY`	Currency is not supported for Apple Pay	Use a supported currency (e.g., SAR).
`ERR_TRANSACTION_DECLINED`	Issuer declined the transaction	Suggest the customer try another card or payment method.
`ERR_PARAMETER_MISSING`	A required parameter is missing from the request	Review the request body and include all necessary fields.
`ERR_APPLE_PAY_NOT_ENABLED`	Apple Pay is not activated for this merchant	Contact EdfaPay to enable Apple Pay on your account.

💡
Important Notes:

Always log the error code and message for support reference.

A "pending" status does not guarantee success; confirm via the Status API.

Token-related errors (e.g., 200.300.xxx) often indicate an expired Apple Pay session.