diff options
1 files changed, 5 insertions, 3 deletions
diff --git a/api-merchant.rst b/api-merchant.rst
index a6b28096..9eccc2fa 100644
--- a/api-merchant.rst
+++ b/api-merchant.rst
@@ -29,10 +29,11 @@ Before reading the API reference documentation, see the :ref:`merchant architect
The Frontend HTTP API
+This frontend API is non-normative, and only gives an example of what a typical frontend API would look like.
.. http:get:: contract_url
- Triggers the contract generation. Note that the URL may differ between
- merchants.
+ Requesting this URL generates a contract, typically with a new (and unique) transaction id.
@@ -51,7 +52,8 @@ The Frontend HTTP API
Send the deposit permission to the merchant. The client should POST a `DepositPermission`_
- object.
+ object. If the payment was processed successfully by the merchant, this URL will set session
+ state that allows the fulfillment URL to show the final product.
.. _DepositPermission:
.. code-block:: tsref