docs: docs for next release (#13303)

* added draft order plugin docs

* fix vale error

* added note about draft order being optional

* add new shipping option - shipping method link

* update user guides

* generate

* fix github icon

* changes to shipping option type

* document logger

* reorder list

* fixes

* fixes
This commit is contained in:
Shahed Nasser
2025-08-28 18:49:07 +03:00
committed by GitHub
parent 94effdcda7
commit d510639193
55 changed files with 1653 additions and 182 deletions
@@ -91,22 +91,9 @@ To capture an orders payment:
---
## Handling Outstanding Amounts
After making changes to an order, such as [editing its items](../edit/page.mdx) or [creating an exchange](../exchanges/page.mdx), there may be outstanding amounts (to be captured from the customer or returned) that are in the Summary section.
![Outstanding amount in Summary](https://res.cloudinary.com/dza7lstvk/image/upload/v1739801684/User%20Guide/Screenshot_2025-02-17_at_4.14.05_PM_qmw7gr.png)
If the outstanding amount is negative, it means you owe the customer a [refund](#refund-payment).
Otherwise, a positive outstanding amount means there are additional payments required from the customer. You can handle it by either:
1. [Mark the order as paid manually](#mark-outstanding-amount-as-paid);
2. Or [copy a payment link](#copy-payment-link-for-additional-payment).
## Refund Payment
If you've made changes to an order, such as return or exchange items, you can refund a previously-captured payment if there's an outstanding amount.
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.
Refunding the payment triggers its processing with the chosen payment provider, such as Stripe.
@@ -116,7 +103,7 @@ Refunding payments is irreversible.
</Note>
To refund an orders outstanding amount:
To refund an orders negative outstanding amount:
1. Open the order's details page.
2. Scroll to the Payment section.
@@ -132,6 +119,21 @@ Once the payment is refunded, the customer will receive a notification about the
![Refund Payment Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739550855/User%20Guide/Screenshot_2025-02-14_at_6.34.01_PM_l9evmh.png)
---
## Handling Positive Outstanding Amounts
An order may have a positive outstanding amount either after making changes to it, or if it was created as a [draft order](../draft-orders/page.mdx).
A positive outstanding amount indicates that the customer needs to pay an additional amount to complete the order.
![Outstanding amount in Summary](https://res.cloudinary.com/dza7lstvk/image/upload/v1739801684/User%20Guide/Screenshot_2025-02-17_at_4.14.05_PM_qmw7gr.png)
You can handle it by either:
1. [Marking the order as paid manually](#mark-outstanding-amount-as-paid);
2. Or [copying a payment link](#copy-payment-link-for-additional-payment).
### Mark Outstanding Amount as Paid
By marking a positive outstanding amount as paid, you're capturing the payment without processing it through the associated payment provider. Instead, you handle capturing the payment outside of Medusa.