Skip to content

Commit 6391c45

Browse files
committed
explain within-handler presentation preference
Handler-level presentation preference is carried by map_order.payment_handlers; review on #657 noted the instrument grain was uncovered. The order of the business's advertised available_instruments array now carries the same suggestive within-handler preference, earliest first: platforms SHOULD consider it and MAY apply their own ordering, and the buyer-side context.payment[] preference remains distinct with the platform arbitrating. Completes handler-major presentation ordering at both grains.
1 parent 37bb7d7 commit 6391c45

1 file changed

Lines changed: 6 additions & 4 deletions

File tree

docs/specification/overview.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1930,10 +1930,12 @@ profile and response envelopes (see
19301930
[The `ucp` Protocol Namespace](#the-ucp-protocol-namespace)). The preference
19311931
is suggestive: it communicates the business's preferred presentation —
19321932
typically a conversion or risk judgment — and platforms **SHOULD** take it
1933-
into account but **MAY** apply their own ordering. It is distinct from, and
1934-
does not override, the buyer-side preference a platform submits in
1935-
`context.payment[]` (buyer-preferred handlers, on the request side); the
1936-
platform arbitrates between the two.
1933+
into account but **MAY** apply their own ordering. The same suggestive
1934+
preference applies within a handler: the order of the business's advertised
1935+
`available_instruments` array communicates preferred instrument presentation,
1936+
earliest first. It is distinct from, and does not override, the buyer-side
1937+
preference a platform submits in `context.payment[]` (buyer-preferred
1938+
handlers, on the request side); the platform arbitrates between the two.
19371939

19381940
**Available Instrument Resolution:** Within each active handler, both the
19391941
platform and the business independently advertise `available_instruments` — the

0 commit comments

Comments
 (0)