---
title: PaymentTerms - GraphQL Admin
description: Represents the payment terms for an order or draft order.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms.md
---

# Payment​Terms

object

Requires `read_payment_terms` access scope.

Represents the payment terms for an order or draft order.

## Fields

* draft​Order

  [Draft​Order](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder)

  The draft order associated with the payment terms.

* due

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

  non-null

  Whether payment terms have a payment schedule that's due.

* due​In​Days

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

  Duration of payment terms in days based on the payment terms template used to create the payment terms.

* id

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

  non-null

  A globally-unique ID.

* order

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

  The order associated with the payment terms.

* overdue

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

  non-null

  Whether the payment terms have overdue payment schedules.

* payment​Schedules

  [Payment​Schedule​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/PaymentScheduleConnection)

  non-null

  List of schedules for the payment terms.

* payment​Terms​Name

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

  non-null

  The name of the payment terms template used to create the payment terms.

* payment​Terms​Type

  [Payment​Terms​Type!](https://shopify.dev/docs/api/admin-graphql/latest/enums/PaymentTermsType)

  non-null

  The payment terms template type used to create the payment terms.

* translated​Name

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

  non-null

  The payment terms name, translated into the shop admin's preferred language.

***

## Map

### Fields with this object

* {}[DraftOrder.paymentTerms](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder#field-DraftOrder.fields.paymentTerms)
* {}[Order.paymentTerms](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order#field-Order.fields.paymentTerms)
* {}[PaymentSchedule.paymentTerms](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentSchedule#field-PaymentSchedule.fields.paymentTerms)

***

## Mutations

* [payment​Terms​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentTermsCreate)

  mutation

  Create payment terms on an order. To create payment terms on a draft order, use a draft order mutation and include the request with the `DraftOrderInput`.

* [payment​Terms​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentTermsUpdate)

  mutation

  Update payment terms on an order. To update payment terms on a draft order, use a draft order mutation and include the request with the `DraftOrderInput`.

***

## <\~> PaymentTerms Mutations

### Mutated by

* <\~>[payment​Terms​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentTermsCreate)
* <\~>[payment​Terms​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/paymentTermsUpdate)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-PaymentTerms Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)