Contents

POST /kyc-upload/$ID#

The /kyc-upload/$ID POST endpoint allows the SPA to upload client-provided evidence. The $ID will be provided as part of the /kyc-info body. This is for checks of type FORM. In practice, $ID will 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 $ID is unknown to the exchange. This response comes with a standard ErrorDetail response. Possible error codes include TALER_EC_EXCHANGE_KYC_CHECK_REQUEST_UNKNOWN or TALER_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_UPLOADED or TALER_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, or TALER_EC_EXCHANGE_KYC_GENERIC_AML_LOGIC_BUG.