@@ -5,7 +5,7 @@
 | Status | Implemented |
 | Author | Jon Tzeng |
 | Reviewer | - |
-| Last updated | 2026-08-10 |
+| Last updated | 2026-08-11 |
 | Repos | [edge-react-gui](https://github.com/EdgeApp/edge-react-gui) |
 | Implementation | see [PR link in the task](https://app.asana.com/0/1215088146871429/1217224633446931) |
 | Supersedes | - |
@@ -343,17 +343,32 @@ Banxa holds the best quote and leads its own group, so the badge sits on a card
 
 No badge anywhere, and the absence is a decision, not a gap ([decision 10.8](#108-the-badge-is-display-honest-and-absent-under-a-promotion)). The badge is a claim about the number printed on the card face. A pinned or affiliate-preferred session exists to surface the promoted provider, and badging a competing provider's rate beside it would work against that promotion. Banxa's quote is still in `allQuotes`, `getBestRateRampQuote` still finds it, and the user still reaches it through any card's "Powered By" picker; it is simply unmarked while a promotion is in force.
 
-That gives a rule that predicts the outcome without re-deriving it:
-
-| Pin | Effect on the list | Badge |
-|---|---|---|
-| Payment type only (`/buy` with no provider) | reorders cards; the provider shown in each card is unchanged | survives |
-| Provider (`/buy/moonpay/...`, or affiliate `preferProviders`) | changes the displayed provider in every card | disappears, unless the pinned provider genuinely holds the best quote |
+[Section 5.7](#57-outcomes-by-configuration) tabulates every reachable configuration; the short form is that the badge disappears exactly from the groups where the promotion displaced the displayed best quote, and nowhere else.
 
 For the user this means a first-time buyer on an unpinned list gets a green starburst naming the cheapest option, while the same buyer arriving through a partner link gets no starburst and no hint that a cheaper option is one picker away. The list is not claiming anything false; it stops answering "which is cheapest". Because `isBestOption` reads the card's current selection rather than its initial one, the badge does reappear if the user opens the picker and selects the best-rate provider, so the information is recoverable but not discoverable.
 
 The product decision resolving this is [decision 10.8](#108-the-badge-is-display-honest-and-absent-under-a-promotion): the badge stays display-honest, and its absence under a promotion is intended. The group-scoped alternative was implemented during PR review and reverted.
 
+### 5.7 Outcomes by configuration
+
+The ordering and the badge are each simple rules, but their product across the inputs (link pin, affiliate preference, provider type, user action) is not obvious; the second review round mispredicted two of these rows. The table enumerates every reachable configuration so an outcome can be looked up instead of re-derived. Each row follows from [section 5.4](#54-ordering) (ordering), [section 5.6](#56-what-the-option-list-shows-and-where-the-best-rate-badge-lands) (badge), and decisions [10.7](#107-rank-the-preferences-above-has-amounts) and [10.8](#108-the-badge-is-display-honest-and-absent-under-a-promotion); if a row and the prose ever disagree, the prose wins and the row is stale.
+
+| # | Configuration | List effect | "Best Rate" badge | Card face |
+|---|---|---|---|---|
+| 1 | No pin, no affiliate preference | Best-rate order, groups and in-group | On the card displaying the best quote | Real totals |
+| 2 | `edge://buy` (direction only) | Same as 1; the link only opens the flow | Present | Real totals |
+| 3 | `edge://buy/moonpay` (priced provider) | MoonPay first inside every group it quotes in; its groups float up | Absent from any group where the promotion displaced the displayed best quote; unaffected elsewhere, and stays if MoonPay itself holds the best quote | Real totals |
+| 4 | `edge://buy/moonpay/venmo` (provider + payment type) | Venmo group first, MoonPay first within it ([decision 10.4](#104-rank-the-payment-type-pin-above-the-provider-pin)) | Same rule as 3 | Real totals |
+| 5 | `edge://buy/libertyx` (external provider) | Its cash group floats to the top with the LibertyX placeholder first; reachable only with a bitcoin wallet in a US region | Survives: LibertyX quotes in no other group, so the best quote's card is not displaced | Promoted card shows its `specialQuoteRateMessage` ("Select to view quote"); the number exists only on the provider's site |
+| 6 | `edge://buy/moonpay/cashapp` while the [info server](#info-server) disables Cash App | No cashapp group exists; MoonPay still leads the groups that do | Same rule as 3 | Real totals |
+| 7 | Pin matches nothing (unknown or absent provider, or a provider with no quotes) | Identical to 1; a debug-only log names the unmatched pin | Present | Real totals |
+| 8 | Affiliate `preferProviders: ["paybis"]` (priced) | Paybis first in every group, silently, with no card rendered | Same rule as 3 | Real totals |
+| 9 | Affiliate `preferProviders: ["libertyx"]` (external) | Same as 5, from server config with no link | Same rule as 5 | Placeholder on the promoted card |
+| 10 | Link pin and affiliate preference together | The link provider is prepended and outranks the affiliate list | Display-honest, rules 3/5 | Mixed |
+| 11 | User hand-picks an amount-less provider from a badged card's picker | No reorder; that card now displays the placeholder | Leaves that card while the placeholder is selected (`hasSelectedAmounts`); returns on switching back | Placeholder while selected |
+| 12 | Amount-less quote that no preference names | Sinks below the priced quotes in its group | Not applicable | Behind "Powered By" |
+| 13 | Any pin, then the user leaves the buy/sell tab | Pin cleared on tab blur ([section 5.3](#53-param-threading)) | Row 1 again on return | Real totals |
+
 ## 6. Info server configuration
 
 Both blocks below are cards inside the `promoCards2` array of the [info server](#info-server) rollup document in the `info_data` CouchDB database. `promoCards2` is a healing array, so a card that fails the cleaner is dropped silently and the rest still load. `background` is required on every card, including the silent one.