docs: docs for next release (#13621)

* docs: docs for next release

* changes to opentelemetry dependencies

* document plugin env variables

* document admin changes

* fix vale error

* add version notes

* document campaign budget updates

* document campaign changes in user guide

* document chages in cluster mode cli

* documented once promotion allocation

* document multiple API keys support

www/apps/user-guide/app/orders/payments/page.mdx

@@ -93,7 +93,13 @@ To capture an order’s payment:
 
 ## Refund Payment
 
-If you've made changes to an order, such as return or exchange items, that resulted in a negative outstanding amount, you can refund a previously-captured payment.
+You can refund a payment either partially or in full. This can be done for various reasons, such as when a customer returns an item or if there was an error in the order.
+
+<Note>
+
+Prior to [Medusa v2.11.0](https://github.com/medusajs/medusa/releases/tag/v2.11.0), you were only able to refund a payment after creating a return or making an order change. From Medusa v2.11.0 onwards, you can refund a payment directly from the order details page without needing to create a return or make an order change. If you're unable to refund a payment, contact your technical team to [update your Medusa application](!docs!/learn/update).
+
+</Note>
 
 Refunding the payment triggers its processing with the chosen payment provider, such as Stripe.
 
@@ -103,21 +109,21 @@ Refunding payments is irreversible.
 
 </Note>
 
-To refund an order’s negative outstanding amount:
+To refund an order's captured payment:
 
 1. Open the order's details page.
 2. Scroll to the Payment section.
 3. Click on the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon at the end of the payment to refund.
 4. Choose "Refund" from the dropdown.
 5. In the side window that opens, fill out the following fields:
-    - **Select payment to refund**: Choose the payment to refund an amount from.
     - **Amount**: Enter the amount to refund.
-    - **Note**: A note that the customer can see in the notification they receive.
+    - **Refund Reason**: Select a reason for the refund from the dropdown. You can [manage refund reasons in the settings](../../settings/refund-reasons/page.mdx).
+    - **Note**: Enter a note that the customer can see in the notification they receive.
 6. Once you’re done, click on the Save button.
 
 Once the payment is refunded, the customer will receive a notification about the refund and you can view the refund as part of the order's activity.
 
-![Refund Payment Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739550855/User%20Guide/Screenshot_2025-02-14_at_6.34.01_PM_l9evmh.png)
+![Refund Payment Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1759995110/User%20Guide/CleanShot_2025-10-09_at_10.31.35_2x_dvbdbp.png)
 
 ---