EU Withdrawal

The EU Withdrawal menu is the store-wide queue of every right-of-withdrawal declaration a customer has filed against an order — the EU consumer's statutory right to withdraw from a distance purchase. It mirrors the admin Sales → EU Withdrawal screen: browse declarations, open one for its full evidence timeline, and act on it (decline, mark refunded, or resend the confirmation email).

When a row appears here

A row exists once a customer has submitted a withdrawal declaration for an order from the storefront. Each declaration captures who filed it (the customer or a guest), against which order, in which channel and locale, the free-text reason, and the moment it was received.

The evidence timeline

Every declaration keeps a durable, ordered record of what happened and when — this is the compliance evidence a merchant must retain:

1. Received — the customer submits the declaration (receivedAt, status: received).
2. Confirmation email — the storefront sends a durable-medium acknowledgement to the customer (confirmationSentAt). If sending failed, the reason is recorded in confirmationError; finalConfirmationSentAt records a later re-send.
3. Outcome — the merchant either:
   • Declines the declaration when the purchase is exempt from withdrawal (status: declined, declinedAt, declinedReason, declinedByUserId, declinedByName), or
   • Marks it refunded once the money has been returned out-of-band (status: refunded, refundedAt, refundedByUserId, refundedByName, refundNote).

The two outcomes are mutually exclusive: declining clears any prior refund metadata, and marking refunded clears any prior decline metadata, so a declaration always reflects a single, current outcome.

Resend confirmation re-sends the durable-medium acknowledgement email in the declaration's locale and refreshes confirmationSentAt — used when the original email bounced or the customer asks for another copy.

Operations in this menu

Action	Operation
List declarations	adminEuWithdrawals query
Get a single declaration	adminEuWithdrawal(id:) query
Decline a declaration	declineAdminEuWithdrawal mutation
Mark refunded	markRefundedAdminEuWithdrawal mutation
Resend confirmation	resendConfirmationAdminEuWithdrawal mutation

All EU Withdrawal operations run against the admin GraphQL endpoint POST /api/admin/graphql and require an admin Bearer token — see Authentication. The list and view queries require the sales.eu_withdrawals permission; each mutation requires its own permission (noted on its page).