---
title: PaymentSessionPendingUserError - Payments Apps API
description: Represents a payment session custom error.
api_version: 2026-04
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.

  * id

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

    required

    ### Arguments

    The payment session ID.

  * pending​Expires​At

    [Date​Time!](https://shopify.dev/docs/api/payments-apps/latest/scalars/DateTime)

    required

    The date and time when the pending payment expires, recommended to be within 3 days.

  * reason

    [Payment​Session​State​Pending​Reason!](https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionStatePendingReason)

    required

    The reason the payment is 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)