There are several reasons as to why an error may occur on your Shopify stores checkout page when Afterpay as the payment method is attempted.
Please refer to the Action section to further understand and resolve the challenge.
Action:
Please review and follow the various reasons and solutions below:
Order Not Processed
Cause: After a customer attempts to checkout with Afterpay, the order may fail, with the customer being presented with a message noting that the payment couldn't be processed. The unsuccessful order may show as "Pending" or "Unpaid" in your Shopify admin.
Solution: Ensure your Afterpay integration in Shopify is active and functioning. Simply retrying the payment or having the customer attempt it again can resolve temporary issues. Also, please keep in mind that Afterpay may not be supported in all regions.
Error Messages in the Checkout
Cause: Customers attempting to checkout with Afterpay may encounter a message during checkout such as:
"Payment could not be processed. Please try again later." or "There was an error with Afterpay. Please select another payment method."
Solution: Advise the customer to clear their browser cache and cookies and retry. In your Shopify admin, ensure Afterpay is enabled under your payment settings. If there was a temporary issue, toggling the payment method off and on can sometimes help reset the integration.
Payment Gateway Configuration Errors
Cause: If there is an issue with your Afterpay integration, you might see error messages such as:
"Payment gateway could not be connected." or"Afterpay service is temporarily unavailable. Please try again later."
Solution: Double-check that your Afterpay keys are correctly entered in the Shopify Payments settings (under Settings > Payments).
If the Afterpay keys are outdated or incorrect, Afterpay will not process payments. You may need to remove and then re-add the Afterpay payment method in Shopify’s payment settings. This will refresh the connection between Afterpay and Shopify..
Afterpay-specific Error Codes
Cause: Technical issues may result in specific error codes displayed in the Shopify admin or in API logs, such as:"503 Service Unavailable" or "400 Bad Request" or "401 Unauthorised"
Solution:
- 503 Service Unavailable: This usually means our servers are temporarily down. Wait for a short period and try again.
- 400 Bad Request: This indicates that there’s an issue with the data being sent to our API. Verify the information you’re sending through Shopify’s integration and ensure it meets our format and validation rules.
-
401 Unauthorised: This usually means that there is a mismatch between your Shopify’s store currency and the address linked to your Shopify account (e.g Your Shopify’s store currency is set as AUD, however the address on the account is a US address.
- Solution: In your Shopify account, ensure that your store currency is set to the currency of your store address.
Important Notes:
Afterpay is available for Shopify merchants with a store address in select countries. Please see here for more details.