Skip to main content
Anchor to refund

refund

query

Requires read_orders access scope or read_marketplace_orders access scope.

Retrieves a refund by its ID. A refund represents a financial record of money returned to a customer from an order. It provides a comprehensive view of all refunded amounts, transactions, and restocking instructions associated with returning products or correcting order issues.

Use the refund query to retrieve information associated with the following workflows:

  • Displaying refund details in order management interfaces
  • Building customer service tools for reviewing refund history
  • Creating reports on refunded amounts and reasons
  • Auditing refund transactions and payment gateway records
  • Tracking inventory impacts from refunded items

A refund is associated with an order and includes refund line items that specify which items were refunded. Each refund processes through order transactions that handle the actual money transfer back to the customer.

Anchor to Arguments

Arguments

Anchor to idid
•ID!
required

The ID of the Refund to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to RefundRefund
•Refund

The Refund object represents a financial record of money returned to a customer from an order. It provides a comprehensive view of all refunded amounts, transactions, and restocking instructions associated with returning products or correcting order issues.

The Refund object provides information to:

  • Process customer returns and issue payments back to customers
  • Handle partial or full refunds for line items with optional inventory restocking
  • Refund shipping costs, duties, and additional fees
  • Issue store credit refunds as an alternative to original payment method returns
  • Track and reconcile all financial transactions related to refunds

Each Refund object maintains detailed records of what was refunded, how much was refunded, which payment transactions were involved, and any inventory restocking that occurred. The refund can include multiple components such as product line items, shipping charges, taxes, duties, and additional fees, all calculated with proper currency handling for international orders.

Refunds are always associated with an order and can optionally be linked to a return if the refund was initiated through the returns process. The refund tracks both the presentment currency (what the customer sees) and the shop currency for accurate financial reporting.

Note

The existence of a Refund object doesn't guarantee that the money has been returned to the customer. The actual financial processing happens through associated OrderTransaction objects, which can be in various states, such as pending, processing, success, or failure. To determine if money has actually been refunded, check the status of the associated transactions.

Learn more about managing returns, refunding duties, and processing refunds.

Was this section helpful?