[taler-docs] branch master updated: clarify API for #9381

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new c9ba33eb clarify API for #9381
c9ba33eb is described below

commit c9ba33eb9c90eddf2ecbdcd6225c729c23ace80e
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Wed Dec 11 22:22:13 2024 +0100

    clarify API for #9381
---
 core/api-exchange.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/core/api-exchange.rst b/core/api-exchange.rst
index d46b552a..a734c36e 100644
--- a/core/api-exchange.rst
+++ b/core/api-exchange.rst
@@ -3836,10 +3836,20 @@ typically also view the balance.)
       // the initial request for the KYC status using the corresponding
       // private key.  Will be the merchant (instance) public key.
       //
+      // This is ONLY given if the merchant did a KYC auth wire transfer.
+      // It is not given if the deposit was made to a reserve public key.
+      // The wallet would already know the reserve public key, plus there
+      // could be various reserve public keys (which do not change), while
+      // there is only the *latest* KYC auth wire transfer public key.
+      //
       // Absent if no public key is currently associated
       // with the account and the client MUST thus first
       // credit the exchange via an inbound wire transfer
       // to associate a public key with the debited account.
+      // Note that absence does *not* imply a need for a KYC auth
+      // transfer if the deposit was made to a reserve public key
+      // that was also used for the deposit.
+      //
       // @since protocol **v20**.
       account_pub?: EddsaPublicKey;
 

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.