Document the WooCommerce 11.1.0 wc/v3 refund additions - #287
Merged
samiuelson merged 4 commits intoAug 11, 2026
Conversation
Adds the refund preview endpoint section (request/response tables, curl and JS examples, error codes), the compute_totals property on refund creation, and the read-only can_be_refunded fields on orders and their product, shipping, and fee lines. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
15 tasks
…rning The per-line can_be_refunded field was dropped from the WooCommerce stack (woocommerce/woocommerce#67044 closed), so its four property rows are removed. The refund creation docs gain a warning that stores below 11.1.0 silently drop the unknown compute_totals parameter, where a quantity-only request creates a 0.00 refund, with the OPTIONS and preview-probe capability checks clients must use. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
15 tasks
samiuelson
marked this pull request as ready for review
August 6, 2026 13:38
15 tasks
Contributor
There was a problem hiding this comment.
Pull request overview
Updates the WooCommerce REST API v3 order refunds documentation to cover new WooCommerce 11.1.0 capabilities around server-computed refunds and a refund preview endpoint, helping API consumers safely adopt the new behavior.
Changes:
- Documents
compute_totalsonPOST /wc/v3/orders/<id>/refunds, including parameter rules, validation errors, and an upgrade/compatibility warning. - Adds documentation for
POST /wc/v3/orders/<id>/refunds/preview, including request/response schema and error codes. - Fixes/improves the existing create-refund cURL example formatting/completeness.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
samiuelson
deleted the
add-v3-refund-preview-compute-totals-can-be-refunded
branch
August 11, 2026 11:15
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the two additions to the
wc/v3refunds API shipping in WooCommerce 11.1.0. The implementation merged in woocommerce/woocommerce#67042, including the server-computed refund work originally developed in the stacked woocommerce/woocommerce#67043.POST /wc/v3/orders/<id>/refunds/preview, including the request contract, response breakdown, permissions, examples, and controller-generated validation errors.compute_totalsmode onPOST /wc/v3/orders/<id>/refunds, including quantity-only requests, conditionalrefund_total/refund_taxsemantics, amount bounds, duplicate item and tax restrictions, and compatibility detection for stores older than WooCommerce 11.1.0.The compatibility warning is important because older stores silently discard the unknown
compute_totalsparameter; a quantity-only request would otherwise create a0.00refund. Clients should feature-detect support throughOPTIONSor the preview route before using the computed form.The previously proposed
can_be_refundedfield is intentionally not documented because it was removed from the implementation.Validation
markdownlint --fixandmarkdownlintusing the legacy Slate repository's heading, HTML, and table conventions.git diff --check.