refundCreate

Version 2019-04

Creates a refund.

Required access

write_orders access scope

Arguments

input ( RefundInput! ) required

The input fields for the mutation.

Input Fields

currency (CurrencyCode)

The currency (in ISO format) that is used to refund the order. This must be the presentment currency (the currency used by the customer) and is a required field for orders where the currency and presentment currency differ.

note (String)

An optional note attached to a refund.

notify (Boolean)

Whether to send a refund notification to the customer.

orderId (ID!) Required

Order ID for which the refund is created.

refundLineItems ([RefundLineItemInput!])

A list of line items to refund.

restock (Boolean)

Whether to add the line items back to the store's inventory. This argument is deprecated: Use restockType on RefundLineItemInput on field refundLineItems instead.

shipping (ShippingRefundInput)

Specifies how much of the shipping cost to refund.

transactions ([OrderTransactionInput!])

A list of transactions involved in the refund.

Return Fields

order (Order)

The order associated with the created refund.

refund (Refund)

The created refund.

userErrors ([UserError!]!)

List of errors that occurred executing the mutation.

Version 2019-07 (Latest)

Creates a refund.

Required access

write_orders access scope

Arguments

input ( RefundInput! ) required

The input fields for the mutation.

Input Fields

currency (CurrencyCode)

The currency (in ISO format) that is used to refund the order. This must be the presentment currency (the currency used by the customer) and is a required field for orders where the currency and presentment currency differ.

note (String)

An optional note attached to a refund.

notify (Boolean)

Whether to send a refund notification to the customer.

orderId (ID!) Required

Order ID for which the refund is created.

refundLineItems ([RefundLineItemInput!])

A list of line items to refund.

restock (Boolean)

Whether to add the line items back to the store's inventory. This argument is deprecated: Use restockType on RefundLineItemInput on field refundLineItems instead.

shipping (ShippingRefundInput)

Specifies how much of the shipping cost to refund.

transactions ([OrderTransactionInput!])

A list of transactions involved in the refund.

Return Fields

order (Order)

The order associated with the created refund.

refund (Refund)

The created refund.

userErrors ([UserError!]!)

List of errors that occurred executing the mutation.

Version 2019-10 (Release candidate)

Creates a refund.

Required access

write_orders access scope

Arguments

input ( RefundInput! ) required

The input fields for the mutation.

Input Fields

currency (CurrencyCode)

The currency (in ISO format) that is used to refund the order. This must be the presentment currency (the currency used by the customer) and is a required field for orders where the currency and presentment currency differ.

note (String)

An optional note attached to a refund.

notify (Boolean)

Whether to send a refund notification to the customer.

orderId (ID!) Required

Order ID for which the refund is created.

refundLineItems ([RefundLineItemInput!])

A list of line items to refund.

restock (Boolean)

Whether to add the line items back to the store's inventory. This argument is deprecated: Use restockType on RefundLineItemInput on field refundLineItems instead.

shipping (ShippingRefundInput)

Specifies how much of the shipping cost to refund.

transactions ([OrderTransactionInput!])

A list of transactions involved in the refund.

Return Fields

order (Order)

The order associated with the created refund.

refund (Refund)

The created refund.

userErrors ([UserError!]!)

List of errors that occurred executing the mutation.

Sign up for a Partner account to get started.

Sign up