> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crossmint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Error Codes

> Reference of the normalized error categories and codes returned in the order's payment.failureReason

<Snippet file="payment-error-codes.mdx" />

## See Also

<CardGroup cols={2}>
  <Card title="Display Payment Error Messages" icon="message-exclamation" href="/payments/embedded/guides/display-payment-errors">
    Surface the decline reason in Embedded Checkout, including after the Apple Pay or Google Pay sheet closes
  </Card>

  <Card title="Supporting Your Customers" icon="headset" href="/payments/headless/guides/supporting-your-customers">
    What to collect from a buyer before escalating a checkout issue to Crossmint
  </Card>

  <Card title="Status Codes" icon="list-check" href="/payments/headless/guides/status-codes">
    Order, quote, payment, and delivery statuses, which are distinct from payment error codes
  </Card>

  <Card title="Pay with Card" icon="credit-card" href="/payments/headless/guides/order-lifecycle/credit-card-payment-phase">
    The payment phase of the Headless Checkout order lifecycle, including handling declined payments
  </Card>

  <Card title="Get Order" icon="brackets-curly" href="/api-reference/headless/get-order">
    REST endpoint that returns the order, including `payment.failureReason`
  </Card>

  <Card title="Webhooks" icon="webhook" href="/payments/advanced/webhooks">
    Receive order updates, including declines, server-side
  </Card>
</CardGroup>