---
title: PaymentSessionPendingUserError - Payments Apps API
description: Represents a payment session custom error.
api_version: 2025-10
api_name: payments-apps
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionPendingUserError
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionPendingUserError.md
---

# Payment​Session​Pending​User​Error

object

Requires `read_payment_sessions` access scope.

Represents a payment session custom error.

## Fields

* code

  [Payment​Session​Pending​User​Error​Code](https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionPendingUserErrorCode)

  The error code.

* field

  [\[String!\]](https://shopify.dev/docs/api/payments-apps/latest/scalars/String)

  The path to the input field that caused the error.

* message

  [String!](https://shopify.dev/docs/api/payments-apps/latest/scalars/String)

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [payment​Session​Pending](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending)

  mutation

  Change a payment session status to pending.

  Upon receiving the response from the `PaymentSessionPending` mutation, you must redirect the customer back to Shopify, using `redirectUrl` in `nextAction`.

  Upon completion, pending payments must be finalized into either a successful or failed state using the `paymentSessionResolve` or `paymentSessionReject` mutations. Both `sale` and `authorization` payments can be marked as pending.

***

## <\~> PaymentSessionPendingUserError Mutations

### Mutated by

* <\~>[payment​Session​Pending](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/payments-apps/latest/interfaces/DisplayableError)

  interface

***

## ||-PaymentSessionPendingUserError Implements

### Implements

* ||-[Displayable​Error](https://shopify.dev/docs/api/payments-apps/latest/interfaces/DisplayableError)