Close a Return

About

The closeCustomerReturn mutation marks the customer's own return (RMA) request as Solved and adds a note to the conversation thread. The result carries the updated return. A return can only be closed when its canClose flag is true.

Authentication

This mutation requires an authenticated customer — send the storefront key and a customer Bearer token. See the Authentication page.

Input Fields

Field	Type	Required	Description
id	ID!	✅ Yes	The return IRI, e.g. /api/shop/returns/12.

Possible Returns

Field	Type	Description
customerReturn._id	Int!	Numeric return ID.
customerReturn.orderId	Int!	Id of the order the item belongs to.
customerReturn.orderIncrementId	String!	Human-readable order number.
customerReturn.statusId	Int!	Numeric status id after closing — 3 (Solved).
customerReturn.statusTitle	String!	Status label, e.g. Solved.
customerReturn.statusColor	String!	Hex color for the status badge.
customerReturn.canClose	Boolean	Whether the return can be closed.
customerReturn.canReopen	Boolean	Whether the return can be reopened.
customerReturn.isExpired	Boolean	Whether the return is past its action window.
customerReturn.messagesCount	Int!	Number of conversation messages — incremented by the close note.
customerReturn.updatedAt	DateTime!	Return last update timestamp.

Related Resources

• Reopen a Return
• View Return
• Returns Overview