---
title: PaymentSessionModalUserErrorCode - Payments Apps API
description: Possible error codes that can be returned by `PaymentSessionModalUserError`.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionModalUserErrorCode
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionModalUserErrorCode.md
api_name: payments-apps
api_type: graphql
type: enum
---

# Payment​Session​Modal​User​Error​Code

enum

Possible error codes that can be returned by `PaymentSessionModalUserError`.

## Valid values

* EXPIRED\_​MODAL\_​EXPIRES\_​AT

  Modal expiry date can't be a time in the past.

* INVALID\_​STATE\_​TRANSITION

  The state transition is invalid.

* OUT\_​OF\_​RANGE\_​MODAL\_​EXPIRES\_​AT

  Modal expiry date has exceeded the limit.

* PAYMENT\_​SESSION\_​NOT\_​FOUND

  Payment session not found.

* UNSUPPORTED\_​PAYMENT\_​METHOD\_​FOR\_​MODAL

  Modal is not supported for this payment method.

***

## Fields

* [Payment​Session​Modal​User​Error.code](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionModalUserError#field-PaymentSessionModalUserError.fields.code)

  OBJECT

  An error that occurs during the execution of `PaymentSessionModal`.

***

## Map

### Fields with this enum

* [Payment​Session​Modal​User​Error.code](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionModalUserError#field-PaymentSessionModalUserError.fields.code)