update pay api

1 files changed, 16 insertions, 4 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index c495d34d..e06b262b 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -375,14 +375,14 @@ Making the payment
 
   .. ts:def:: SignedTokenEnvelope
 
-    // TODO: Check if we actually need this wrapper interface.
-    //       Could be useful if we want to add some metadata to
-    //       the issued coin.
     interface SignedTokenEnvelope {
 
       // Blind signature made by the merchant.
       blind_sig: TokenIssueBlindSig;
 
+      // Hash of the token issue public key.
+      h_issue: HashCode;
+
     }
 
   .. ts:def:: TokenIssueBlindSig
@@ -489,10 +489,22 @@ Making the payment
 
   .. ts:def:: TokenEnvelope
 
+    interface TokenEnvelope {
+
+      // Blinded token use public key.
+      token_ev: BlindedTokenEnvelope;
+
+      // Hash of the token issue public key.
+      h_issue: HashCode;
+
+    }
+
+  .. ts:def:: BlindedTokenEnvelope
+
     // This type depends on the cipher used to sign token families. This is
     // configured by the merchant and defined for each token family in the
     // contract terms.
-    type TokenEnvelope = RSATokenEnvelope | CSTokenEnvelope;
+    type BlindedTokenEnvelope = RSATokenEnvelope | CSTokenEnvelope;
 
   .. ts:def:: RSATokenEnvelope