document fulfillment_message

1 files changed, 11 insertions, 2 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index c1de77e7..56a9187f 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -2803,10 +2803,19 @@ The contract terms must have the following structure:
     amount: Amount;
 
     // The URL for this purchase.  Every time it is visited, the merchant
-    // will send back to the customer the same proposal.  Clearly, this URL
-    // can be bookmarked and shared by users.
+    // will send back to the customer the same proposal.
+    // The URL should be bookmarkable.
+    // Either fulfillment_url or fulfillment_message must be specified.
     fulfillment_url?: string;
 
+    // Message shown to the customer after paying for the order.
+    // Either fulfillment_url or fulfillment_message must be specified.
+    fulfillment_message?: string;
+
+    // Map from IETF BCP 47 language tags to localized fulfillment
+    // messages.
+    fulfillment_message_i18n: { [lang_tag: string]: string };
+
     // Maximum total deposit fee accepted by the merchant for this contract.
     max_fee: Amount;