diff options
author | Christian Grothoff <christian@grothoff.org> | 2021-10-16 19:40:07 +0200 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2021-10-16 19:40:07 +0200 |
commit | 34bd4398b0b2b6c0db23f48b60047c0fe43cd452 (patch) | |
tree | ffb4d12802ae7c83aca67b825c80de086d08d0bf /core/api-exchange.rst | |
parent | c603e6d873a95d7545bf7addb565b465ab1afcec (diff) | |
download | docs-34bd4398b0b2b6c0db23f48b60047c0fe43cd452.tar.gz docs-34bd4398b0b2b6c0db23f48b60047c0fe43cd452.tar.bz2 docs-34bd4398b0b2b6c0db23f48b60047c0fe43cd452.zip |
specify new /kyc-wallet endpoint
Diffstat (limited to 'core/api-exchange.rst')
-rw-r--r-- | core/api-exchange.rst | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/core/api-exchange.rst b/core/api-exchange.rst index 7f4f57c0..aa371f93 100644 --- a/core/api-exchange.rst +++ b/core/api-exchange.rst @@ -3320,6 +3320,51 @@ KYC status updates This is a draft API that is not yet implemented. +.. http:POST:: /kyc-wallet + + Setup KYC identification for a wallet. Returns the KYC UUID. + + **Request:** + + The request body must be a `WalletKycRequest` object. + + **Response:** + + :http:statuscode:`200 Ok`: + A KYC ID was created. + The response will be a `WalletKycUuid` object. + :http:statuscode:`204 No Content`: + KYC is disabled at this exchange. + :http:statuscode:`401 Unauthorized`: + The provided signature is invalid. + + **Details:** + + .. ts:def:: WalletKycRequest + + interface WalletKycRequest { + + // EdDSA signature of the wallet affirming the + // request, must be of purpose + // ``TALER_SIGNATURE_WALLET_ACCOUNT_SETUP`` + reserve_sig: EddsaSignature; + + // long-term wallet reserve-account + // public key used to create the signature. + reserve_pub: EddsaPublicKey; + } + + .. ts:def:: WalletKycUuid + + interface WalletKycUuid { + + // UUID that the wallet should use when initiating + // the KYC check. + payment_target_uuid: number; + + } + + .. http:GET:: /kyc-check/$PAYMENT_TARGET_UUID Check or update KYC status of a particular payment target. |