diff --git a/src/include/taler_crypto_lib.h b/src/include/taler_crypto_lib.h
index 1e3972b5a..4f52d78fa 100644
--- a/src/include/taler_crypto_lib.h
+++ b/src/include/taler_crypto_lib.h
@@ -950,13 +950,13 @@ GNUNET_NETWORK_STRUCT_END
 
 
 /**
- * @brief It is build pos confirmation to verify payment.
+ * @brief Builds POS confirmation token to verify payment.
  *
  * @param pos_key encoded key for verification payment
  * @param pos_alg algorithm to compute the payment verification
  * @param total of the order paid
  * @param ts is the time given
- *
+ * @return POS token on success, NULL otherwise
  */
 char *
 TALER_build_pos_confirmation (const char *pos_key,
diff --git a/src/util/crypto_confirmation.c b/src/util/crypto_confirmation.c
index 63d597fd3..c5a674501 100644
--- a/src/util/crypto_confirmation.c
+++ b/src/util/crypto_confirmation.c
@@ -163,6 +163,14 @@ base32decode (const char *val,
 }
 
 
+/**
+ * @brief Builds POS confirmation to verify payment.
+ *
+ * @param h_key opaque key for the totp operation
+ * @param h_key_len size of h_key in bytes
+ * @param ts current time
+ * @return Token on success, NULL of failure
+ */
 static char *
 executive_totp (void *h_key,
                 size_t h_key_len,
@@ -201,15 +209,6 @@ executive_totp (void *h_key,
 }
 
 
-/**
- * @brief Builds POS confirmation to verify payment.
- *
- * @param pos_key base32 (RFC 3548, not Crockford!) encoded key for verification payment
- * @param pos_alg algorithm to compute the payment verification
- * @param total of the order paid
- * @param ts is the current time given
- * @return Token on success, NULL of failure
- */
 char *
 TALER_build_pos_confirmation (const char *pos_key,
                               enum TALER_MerchantConfirmationAlgorithm pos_alg,