Payment Errors

This page documents the payment processor errors that FaxStore handles internally and may display during checkout or payment processing. These errors occur when FaxStore sends a payment request to a supported payment gateway and the processor returns a failure response.

Each error is identified by an error code and includes an explanation along with recommended troubleshooting steps.

Table of Contents

How Payment Errors Work in FaxStore

When a customer makes a payment:

1. FaxStore sends a secure request to the configured payment processor.

2. The processor validates the request and payment details.

3. If a problem occurs, the processor returns an error response.

4. FaxStore interprets the response and displays a user-friendly message.

Some errors are shown directly to customers, while others are primarily intended for store administrators.

PayPal Errors

400 - PayPal Internal Error

An internal PayPal error occurred while processing the payment request. This typically comes from; PayPal token issues, or the line items are not correct in FaxStore's request.

Stripe Errors

Card Errors (Customer-Facing)

Card-related failures are automatically translated into Stripe’s provided card error messages.

Examples include:

• Insufficient funds

• Incorrect CVC

• Expired card

• Card declined by issuer

These errors are displayed directly to the customer during checkout and are not considered an issue with FaxStore.

429 - Rate Limited

Stripe has temporarily limited requests from the store due to high request volume. This is more rare but possible. Contact Stripe in regards to this if the traffic is all genuine.

400 - Invalid Request

Stripe rejected the payment request because the request format was invalid, generally caused by line items in the request being incorrect in formatting or currency value.

401 - Invalid Authentication

Stripe rejected the request due to invalid or missing API credentials. Check the tokens via the configuration file or staff panel.

500 - Stripe Internal Error

A server-side error occurred within Stripe’s infrastructure. The best option is to wait and retry the request.

502 - Stripe Network Error

A networking issue occurred between FaxStore and Stripe. As FaxStore is self hosted this can be due to firewall rules or other network blockage.

000 — Unknown Error

An unidentified error occurred that FaxStore could not classify from Stripe. Escalate this to Weblutions by contacting us.

Square Errors

At this time, Square does not yet have internal error mapping support within FaxStore and will produce errors directly from the Stripe API.

Troubleshooting Checklist

If errors are repeating contact Weblutions for further troubleshooting if the below steps don't resolve the errors.

• Verify payment processor API keys

• Confirm environment mode (Test vs Live)

• Check FaxStore console logs

• Retry the payment after several minutes

• Review processor dashboards (Stripe/PayPal) for any alerts