- POST /kyc-upload/$ID#
The
/kyc-upload/$IDPOST endpoint allows the SPA to upload client-provided evidence. The$IDwill be provided as part of the/kyc-infobody. This is for checks of typeFORM. In practice,$IDwill encode the$ACCESS_TOKEN, legitimization measure serial ID (to disambiguate) and the index of the selected measure (but these details should be irrelevant for the client).This endpoint was introduced in protocol v20.
Request:
JSON body with data depending on the form being submitted. Details will thus completely depend on the form, but it MUST include a form ID and be generally of type CustomerKycAttributes.
Response:
- 204 No Content:
The information was successfully uploaded. The SPA should fetch an updated
/kyc-info/.- 400 Bad Request:
The request body is malformed or a parameter is invalid. This response comes with a standard ErrorDetail response with a code of
TALER_EC_GENERIC_PARAMETER_MALFORMED.- 404 Not Found:
The
$IDis unknown to the exchange. This response comes with a standard ErrorDetail response. Possible error codes includeTALER_EC_EXCHANGE_KYC_CHECK_REQUEST_UNKNOWNorTALER_EC_GENERIC_ENDPOINT_UNKNOWN.- 409 Conflict:
The upload conflicts with a previous upload. This response comes with a standard ErrorDetail response with a code of
TALER_EC_EXCHANGE_KYC_FORM_ALREADY_UPLOADEDorTALER_EC_EXCHANGE_KYC_INVALID_FORM_SUBMITTED.- 413 Request Entity Too Large:
The body is too large.
- 500 Internal Server Error:
The server experienced an internal error. This response comes with a standard ErrorDetail response. Possible error codes include
TALER_EC_GENERIC_DB_FETCH_FAILED,TALER_EC_GENERIC_DB_STORE_FAILED,TALER_EC_GENERIC_DB_INVARIANT_FAILURE,TALER_EC_GENERIC_DB_SETUP_FAILED, orTALER_EC_EXCHANGE_KYC_GENERIC_AML_LOGIC_BUG.