---
title: orderPaymentStatus - GraphQL Admin
description: |-
  Retrieves the status of a deferred payment by its payment reference ID. Use this query to monitor the processing status of payments that are initiated through payment mutations. Deferred payments are called [payment terms](https://shopify.dev/docs/apps/build/checkout/payments/payment-terms) in the API.

  The query returns an [`OrderPaymentStatus`](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderPaymentStatus) object that includes the current payment status, any error messages, and associated transactions. Poll this query to track [asynchronous payment processing](https://shopify.dev/docs/apps/build/payments/processing) after initiating a deferred payment.
api_version: 2025-01
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/queries/OrderPaymentStatus
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/queries/OrderPaymentStatus.md
---

# order​Payment​Status

query

Retrieves the status of a deferred payment by its payment reference ID. Use this query to monitor the processing status of payments that are initiated through payment mutations. Deferred payments are called [payment terms](https://shopify.dev/docs/apps/build/checkout/payments/payment-terms) in the API.

The query returns an [`OrderPaymentStatus`](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderPaymentStatus) object that includes the current payment status, any error messages, and associated transactions. Poll this query to track [asynchronous payment processing](https://shopify.dev/docs/apps/build/payments/processing) after initiating a deferred payment.

## Arguments

* order​Id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/ID)

  required

  ID of the order for which the payment was initiated.

* payment​Reference​Id

  [String!](https://shopify.dev/docs/api/admin-graphql/2025-01/scalars/String)

  required

  Unique identifier returned by orderCreatePayment.

***

## Possible returns

* Order​Payment​Status

  [Order​Payment​Status](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/OrderPaymentStatus)

  The status of a customer's payment for an order.

***

## Examples

* ### orderPaymentStatus reference

## Query Reference

```graphql
{
  orderPaymentStatus(paymentReferenceId, orderId) {
    # orderPaymentStatus fields
  }
}
```