---
title: PaymentTerms - GraphQL Admin
description: >-
  Payment conditions for an
  [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) or
  [`DraftOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder),
  including when payment is due and how it's scheduled. Payment terms are
  created from templates that specify net terms (payment due after a certain
  number of days) or fixed schedules with specific due dates. You can optionally
  provide custom payment schedules using
  [`PaymentScheduleInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PaymentScheduleInput).


  Each payment term contains one or more
  [`PaymentSchedule`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentSchedule),
  which you can access through the
  [`paymentSchedules`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms#field-PaymentTerms.fields.paymentSchedules)
  field. Payment schedules contain detailed information for each payment
  installment.


  Learn more about [payment
  terms](https://shopify.dev/docs/apps/build/checkout/payments/payment-terms).
api_version: 2026-01
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.

Payment conditions for an [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) or [`DraftOrder`](https://shopify.dev/docs/api/admin-graphql/latest/objects/DraftOrder), including when payment is due and how it's scheduled. Payment terms are created from templates that specify net terms (payment due after a certain number of days) or fixed schedules with specific due dates. You can optionally provide custom payment schedules using [`PaymentScheduleInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/PaymentScheduleInput).

Each payment term contains one or more [`PaymentSchedule`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentSchedule), which you can access through the [`paymentSchedules`](https://shopify.dev/docs/api/admin-graphql/latest/objects/PaymentTerms#field-PaymentTerms.fields.paymentSchedules) field. Payment schedules contain detailed information for each payment installment.

Learn more about [payment terms](https://shopify.dev/docs/apps/build/checkout/payments/payment-terms).

## Fields

* draftOrder
* due
* dueInDays
* id
* order
* overdue
* paymentSchedules
* paymentTermsName
* paymentTermsType
* translatedName

***

## 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

* paymentTermsCreate
* paymentTermsUpdate

***

## 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

***

## PaymentTerms Implements

### Implements

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