From b8d08792ca8c1cda50f965ee9b7a6981fee316fe Mon Sep 17 00:00:00 2001 From: Christian Grothoff Date: Sat, 16 Dec 2023 09:43:09 +0800 Subject: update protocol specification for v6 --- core/api-merchant.rst | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'core/api-merchant.rst') diff --git a/core/api-merchant.rst b/core/api-merchant.rst index b6bdb0dd..7792b65c 100644 --- a/core/api-merchant.rst +++ b/core/api-merchant.rst @@ -121,6 +121,7 @@ such as the implemented version of the protocol and the currency used. .. http:get:: /config Return the protocol version and currency supported by this merchant backend. + This specification corresponds to ``current`` protocol being version **6**. **Response:** @@ -2005,6 +2006,11 @@ Creating orders // to select among the various (active) wire methods supported by the instance. payment_target?: string; + // The session for which the payment is made (or replayed). + // Only set for session-based payments. + // Since protocol v6. + session_id?: string; + // Specifies that some products are to be included in the // order from the inventory. For these inventory management // is performed (so the products must be in stock) and @@ -2132,6 +2138,8 @@ Inspecting orders :query date_s: *Optional.* Non-negative date in seconds after the UNIX Epoc, see ``delta`` for its interpretation. If not specified, we default to the oldest or most recent entry, depending on ``delta``. :query start: *Optional*. Row number threshold, see ``delta`` for its interpretation. Defaults to ``INT64_MAX``, namely the biggest row id possible in the database. :query timeout_ms: *Optional*. Timeout in milliseconds to wait for additional orders if the answer would otherwise be negative (long polling). Only useful if delta is positive. Note that the merchant MAY still return a response that contains fewer than ``delta`` orders. + :query session_id: *Optional*. Since protocol v6. Filters by session ID. + :query fulfillment_url: *Optional*. Since protocol v6. Filters by fulfillment URL. **Response:** -- cgit v1.2.3