---
title: returnRefund - GraphQL Admin
description: Refunds a return when its status is `OPEN` or `CLOSED` and associates it with the related return request.
api_version: 2025-10
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRefund
  md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnRefund.md
---

# return​Refund

mutation

Requires `write_returns` access scope or `write_marketplace_returns` access scope. Also: The user must have `refund_orders` permission.

Deprecated. Use [returnProcess](https://shopify.dev/docs/api/admin-graphql/latest/mutations/returnProcess) instead.

Refunds a return when its status is `OPEN` or `CLOSED` and associates it with the related return request.

## Arguments

* return​Refund​Input

  [Return​Refund​Input!](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ReturnRefundInput)

  required

  The input fields to refund a return.

***

## Return​Refund​Payload returns

* refund

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

  The created refund.

* user​Errors

  [\[Return​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ReturnUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### returnRefund reference

## Mutation Reference

```graphql
mutation returnRefund($returnRefundInput: ReturnRefundInput!) {
  returnRefund(returnRefundInput: $returnRefundInput) {
    refund {
      # Refund fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "returnRefundInput": {
    "returnId": "gid://shopify/<objectName>/10079785100",
    "returnRefundLineItems": [
      {
        "returnLineItemId": "gid://shopify/<objectName>/10079785100",
        "quantity": 1
      }
    ],
    "refundShipping": {
      "shippingRefundAmount": {},
      "fullRefund": true
    },
    "refundDuties": [
      {
        "dutyId": "gid://shopify/<objectName>/10079785100",
        "refundType": "PROPORTIONAL"
      }
    ],
    "orderTransactions": [
      {
        "transactionAmount": {},
        "parentId": "gid://shopify/<objectName>/10079785100"
      }
    ],
    "notifyCustomer": true
  }
}
```

##### Variables

```
{
  "returnRefundInput": {
    "returnId": "gid://shopify/<objectName>/10079785100",
    "returnRefundLineItems": [
      {
        "returnLineItemId": "gid://shopify/<objectName>/10079785100",
        "quantity": 1
      }
    ],
    "refundShipping": {
      "shippingRefundAmount": {},
      "fullRefund": true
    },
    "refundDuties": [
      {
        "dutyId": "gid://shopify/<objectName>/10079785100",
        "refundType": "PROPORTIONAL"
      }
    ],
    "orderTransactions": [
      {
        "transactionAmount": {},
        "parentId": "gid://shopify/<objectName>/10079785100"
      }
    ],
    "notifyCustomer": true
  }
}
```

##### Schema

```
input ReturnRefundInput {
  returnId: ID!
  returnRefundLineItems: [ReturnRefundLineItemInput!]!
  refundShipping: RefundShippingInput
  refundDuties: [RefundDutyInput!]
  orderTransactions: [ReturnRefundOrderTransactionInput!]
  notifyCustomer: Boolean
}

input ReturnRefundLineItemInput {
  returnLineItemId: ID!
  quantity: Int!
}

input RefundShippingInput {
  shippingRefundAmount: MoneyInput
  fullRefund: Boolean
}

input RefundDutyInput {
  dutyId: ID!
  refundType: RefundDutyRefundType
}

input ReturnRefundOrderTransactionInput {
  transactionAmount: MoneyInput!
  parentId: ID!
}
```