---
title: >-
  New pending mutation in Payments Apps API 2022-04 release - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/new-pending-mutation-in-payments-apps-api-2022-04-release
  md: >-
    https://shopify.dev/changelog/new-pending-mutation-in-payments-apps-api-2022-04-release.md
metadata:
  effectiveApiVersion: 2022-04
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: true
  createdAt: '2022-02-21T15:49:26-05:00'
  postedAt: '2022-04-01T00:00:00-04:00'
  updatedAt: '2024-12-13T17:24:33-05:00'
  effectiveAt: '2022-04-01T00:00:00-04:00'
---

April 1, 2022

Tags:

* Action Required
* API
* 2022-04

# New pending mutation in Payments Apps API 2022-04 release

In the `2022-04` release of the Payments Apps GraphQL API, we're introducing a way to mark payments as pending. To support this, a new mutation can be used in cases where a payment cannot be completed quickly.

### New pending mutation

The pending payments feature is now officially available for payments apps. You can mark a payment as pending if the payment can't be completed within a reasonable amount of time. This means buyers won't need to wait for slow transactions to finish before their order is completed. Learn more about [pending a payment](https://shopify.dev/apps/payments/processing-a-payment#pend-a-payment) on Shopify.dev.

### Updated pending behaviour in the Admin

While the payment is pending, the actions a merchant can take on the order will be restricted so as to not interfere with the payment that is pending. These restrictions are lifted as soon as the payment is completed or expires. A pending payment will expire if you fail to complete the payment within a reasonable time. Learn more about [pending payments](https://help.shopify.com/en/manual/orders/manage-orders/alt_payments_pending) in the Shopify Help Center.

### Status field deprecation

The `status` field on payment, refund, capture, and void session objects is deprecated and replaced by the `state` field introduced in the 2022-04 API release. Pending payments are not supported by the `status` field and will raise an error.