---
title: RefundAgreement - Customer API
description: >-
  An agreement for refunding all or a portion of the order between the merchant
  and the customer.
api_version: 2025-07
api_name: customer
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/2025-07/objects/RefundAgreement'
  md: 'https://shopify.dev/docs/api/customer/2025-07/objects/RefundAgreement.md'
---

# Refund​Agreement

object

An agreement for refunding all or a portion of the order between the merchant and the customer.

## Fields

* happened​At

  [Date​Time!](https://shopify.dev/docs/api/customer/2025-07/scalars/DateTime)

  non-null

  The date and time when the agreement occurred.

* id

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

  non-null

  The unique ID for the agreement.

* reason

  [Order​Action​Type!](https://shopify.dev/docs/api/customer/2025-07/enums/OrderActionType)

  non-null

  The reason the agreement was created.

* refund

  [Refund!](https://shopify.dev/docs/api/customer/2025-07/objects/Refund)

  non-null

  The refund that's associated with the agreement.

* sales

  [Sale​Connection!](https://shopify.dev/docs/api/customer/2025-07/connections/SaleConnection)

  non-null

  The sales associated with the agreement.

  * first

    [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int)

    ### Arguments

    The first `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * after

    [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

    The elements that come after the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * last

    [Int](https://shopify.dev/docs/api/customer/2025-07/scalars/Int)

    The last `n` elements from the [paginated list](https://shopify.dev/api/usage/pagination-graphql).

  * before

    [String](https://shopify.dev/docs/api/customer/2025-07/scalars/String)

    The elements that come before the specified [cursor](https://shopify.dev/api/usage/pagination-graphql).

  * reverse

    [Boolean](https://shopify.dev/docs/api/customer/2025-07/scalars/Boolean)

    Default:false

    Reverse the order of the underlying list.

  ***

***

## Map

No referencing types

***

## Interfaces

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

    interface

  * [Sales​Agreement](https://shopify.dev/docs/api/customer/2025-07/interfaces/SalesAgreement)

    interface

***

## RefundAgreement Implements

### Implements

* [Node](https://shopify.dev/docs/api/customer/2025-07/interfaces/Node)
* [Sales​Agreement](https://shopify.dev/docs/api/customer/2025-07/interfaces/SalesAgreement)