# Payment Errors

Payment errors occur during checkout and payment processing. These errors are prefixed with `PY` and relate to issues with payment cards, gateways, and transactions.

## Categories[​](#categories "Direct link to Categories")

| Category                   | Code Range | Description                          |
| -------------------------- | ---------- | ------------------------------------ |
| [Card](#card-errors)       | PY01xxx    | Issues with the payment card         |
| [Gateway](#gateway-errors) | PY02xxx    | Payment gateway communication issues |

***

## Card Errors[​](#card-errors "Direct link to Card Errors")

Issues related to the customer's payment card.

| Code                               | Name                | Description                      |
| ---------------------------------- | ------------------- | -------------------------------- |
| [PY01001](/error-codes/PY01001.md) | Payment Declined    | The payment was declined         |
| [PY01002](/error-codes/PY01002.md) | Insufficient Funds  | Not enough funds for the payment |
| [PY01003](/error-codes/PY01003.md) | Card Expired        | The payment card has expired     |
| [PY01004](/error-codes/PY01004.md) | Invalid Card Number | The card number is not valid     |

## Gateway Errors[​](#gateway-errors "Direct link to Gateway Errors")

Issues communicating with the payment gateway.

| Code                               | Name                  | Description                              |
| ---------------------------------- | --------------------- | ---------------------------------------- |
| [PY02001](/error-codes/PY02001.md) | Payment Gateway Error | Error communicating with payment gateway |
| [PY02002](/error-codes/PY02002.md) | Payment Timeout       | Payment processing timed out             |