refundCreate mutation

Version 2020-01 (Release candidate)

Creates a refund.

Required access

write_orders access scope

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

input ( RefundInput! ) required

The input fields for the mutation.

RefundInput 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.

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 (Latest)

Creates a refund.

Required access

write_orders access scope

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

input ( RefundInput! ) required

The input fields for the mutation.

RefundInput 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.

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

Creates a refund.

Required access

write_orders access scope

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

input ( RefundInput! ) required

The input fields for the mutation.

RefundInput 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-04

Creates a refund.

Required access

write_orders access scope

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.


Arguments

input ( RefundInput! ) required

The input fields for the mutation.

RefundInput 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