---
title: orderPaymentStatus - GraphQL Admin
description: Returns a payment status by payment reference ID. Used to check the status of a deferred payment.
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/queries/orderpaymentstatus
  md: https://shopify.dev/docs/api/admin-graphql/latest/queries/orderpaymentstatus.md
---

# order​Payment​Status

query

Returns a payment status by payment reference ID. Used to check the status of a deferred payment.

## Arguments

* order​Id

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

  required

  ID of the order for which the payment was initiated.

* payment​Reference​Id

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

  required

  Unique identifier returned by orderCreatePayment.

***

## Possible returns

* Order​Payment​Status

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

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

***

## Examples

* ### orderPaymentStatus reference

## Query Reference

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