Refund reason selector missing from balance settlement refund form
Description
The Medusa Admin “Create Refund” form does not render the Refund Reason selector when refunding through the payment method.
The form shown on the order page is the newer “Balance settlement” form, which includes Settlement type, Payment method / Store credit, Select payment to refund, Amount, and Note. It omits the Refund Reason field entirely.
Expected behavior
The payment-method refund form should render:
- Amount
- Refund Reason
- Note
This matches the Refund Reason selector shown in Medusa’s documentation.
Actual behavior
The form renders Amount followed immediately by Note. Creating refund reasons under Settings → Refund Reasons does not help because the field itself is not rendered.
Technical details
The issue appears in:
packages/admin/dashboard/src/routes/orders/order-balance-settlement/components/order-balance-settlement-form/order-balance-settlement-form.tsx
The settlementType === "refund" branch renders refund.amount and refund.note, but does not define or render refund_reason_id.
The older refund form does support this field:
packages/admin/dashboard/src/routes/orders/order-create-refund/components/create-refund-form/create-refund-form.tsx
The refund API already supports refund_reason_id.
References
Balance settlement form: https://github.com/medusajs/medusa/blob/develop/packages/admin/dashboard/src/routes/orders/order-balance-settlement/components/order-balance-settlement-form/order-balance-settlement-form.tsx
Working refund form with reason selector: https://github.com/medusajs/medusa/blob/develop/packages/admin/dashboard/src/routes/orders/order-create-refund/components/create-refund-form/create-refund-form.tsx
Refund reasons documentation: https://docs.medusajs.com/user-guide/settings/refund-reasons
Version
Medusa 2.18.0
field screenshot in medusa docs
no field on my version
Source: medusajs/medusa