---
title: PaymentSessionNextAction - Payments Apps API
description: >-
  The next action that is expected of the Partner after the payment is
  finalized.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionNextAction
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionNextAction.md
api_name: payments-apps
api_type: graphql
type: object
---

# Payment​Session​Next​Action

object

Requires `read_payment_sessions` access scope.

The next action that is expected of the Partner after the payment is finalized.

## Fields

* action

  [Payment​Session​Next​Action​Action!](https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionNextActionAction)

  non-null

  The action expected by the partner.

* context

  [Payment​Session​Next​Action​Context!](https://shopify.dev/docs/api/payments-apps/latest/unions/PaymentSessionNextActionContext)

  non-null

  The context required to perform an action.

***

## Map

### Fields with this object

* [PaymentSession.nextAction](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSession#field-PaymentSession.fields.nextAction)