POST /kyc-start/$ID

The /kyc-start/$ID POST endpoint allows the SPA to set up a new external KYC process. It will return the URL that the client must GET to begin the KYC process. The SPA should probably open this URL in a new window or tab. The $ID will be provided as part of the /kyc-info body. 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).

Request:

Use empty JSON body for now.

Response:

200 Ok:

The KYC process was successfully initiated. The URL is in a KycProcessStartInformation object.

404 Not Found:

The $ID is unknown to the exchange.

Details:

interface KycProcessStartInformation {

  // URL to open.
  redirect_url: string;
}

Note

As this endpoint is involved in every KYC check at the beginning, this is also the place where we could integrate the payment process for the KYC fee in the future (since protocol vATTEST).