commit 8027f2d0e1c6260344633eb60261d46691301c48 parent 25a8a5b2bce14a07fa2be557ac4cc91b1a0312a1 Author: Antoine A <> Date: Wed, 8 Oct 2025 16:46:58 +0200 corebank: update 2FA Diffstat:
| M | core/api-corebank.rst | | | 25 | ++++++++++++++++++++++--- |
1 file changed, 22 insertions(+), 3 deletions(-)
diff --git a/core/api-corebank.rst b/core/api-corebank.rst @@ -1662,15 +1662,33 @@ Requesting challenges **Response:** - :http:statuscode:`204 No Content`: - The TAN code has bee + :http:statuscode:`200 Ok`: + The TAN code has been sent. The body will be a `ChallengeRequestResponse`. :http:statuscode:`404 Not Found`: + * ``TALER_EC_BANK_TAN_CHANNEL_SCRIPT_FAILED``: TAN transmition failed. + * ``TALER_EC_BANK_TAN_CHALLENGE_EXPIRED``: TAN transmition failed. The challenge was not found. + :http:statuscode:`410 Gone`: + The challenge was already solved. :http:statuscode:`429 Too many requests`: Too many challenges are active right now, you must wait or confirm current challenges. :http:statuscode:`502 Bad Gateway`: * ``TALER_EC_BANK_TAN_CHANNEL_SCRIPT_FAILED``: TAN transmition failed. + **Details:** + + .. ts:def:: ChallengeRequestResponse + + interface ChallengeRequestResponse { + // How long does the client have to solve the + // challenge. + solve_expiration: Timestamp; + + // What is the earlist time at which the client + // may request a new challenge to be transmitted? + earliest_retransmission: Timestamp; + } + Solving challenges ^^^^^^^^^^^^^^^^^^ @@ -1696,7 +1714,8 @@ Solving challenges :http:statuscode:`204 No Content`: The challenge is confirmed. :http:statuscode:`404 Not Found`: - The challenge was not found. + * ``TALER_EC_BANK_TRANSACTION_NOT_FOUND`` : unknown challenge TAN. + * ``TALER_EC_BANK_TAN_CHALLENGE_EXPIRED`` : expired challenge. :http:statuscode:`409 Conflict`: * ``TALER_EC_BANK_TAN_CHALLENGE_FAILED`` : wrong TAN. * ``TALER_EC_BANK_TAN_CHALLENGE_EXPIRED`` : expired TAN.