---
title: PaymentSchedule - Customer API
description: A single payment schedule defined in the payment terms.
api_version: 2025-10
api_name: customer
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/objects/paymentschedule
  md: https://shopify.dev/docs/api/customer/latest/objects/paymentschedule.md
---

# Payment​Schedule

object

A single payment schedule defined in the payment terms.

## Fields

* completed

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  Whether the payment has been completed.

* completed​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  The date and time when the payment schedule was paid or fulfilled.

* due​At

  [Date​Time](https://shopify.dev/docs/api/customer/latest/scalars/DateTime)

  [Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The date and time when the payment schedule is due.

* id

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

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A globally-unique ID.

* total​Balance

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  Remaining balance to be paid or authorized by the customer for this payment schedule.

* amount

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-nullDeprecated[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

***

## Map

### Fields and connections with this object

* <->[PaymentScheduleConnection.nodes](https://shopify.dev/docs/api/customer/latest/connections/PaymentScheduleConnection#field-nodes)
* {}[PaymentScheduleEdge.node](https://shopify.dev/docs/api/customer/latest/objects/PaymentScheduleEdge#field-node)
* {}[PaymentTerms.paymentSchedules](https://shopify.dev/docs/api/customer/latest/objects/PaymentTerms#field-paymentSchedules)

***

## Interfaces

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

  interface

***

## ||-PaymentSchedule Implements

### Implements

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