Skip to content

CustomerSubmitKycStep

Endpoint

POST /customer/kyc/steps/{id}/submit

Authorization

Requires SESSION_CUSTOMER token.

Description

Submits answers for a KYC step owned by the authenticated customer. The server validates the payload against the step form_schema.

The path {id} is the numeric KYC step id returned by GET /customer/kyc or GET /customer/kyc/steps/{id}.

Request

{
  "answers": {
    "first_name": "John",
    "country": "CY",
    "employment_status": "employed"
  }
}

Response

{
  "step": {
    "id": 10,
    "status": 1,
    "answers": {
      "first_name": "John",
      "country": "CY",
      "employment_status": "employed"
    },
    "submitted_time": 1778160000,
    "updated_time": 1778160000
  }
}

Errors

HTTP Error Description
400 INVALID_DATA Invalid answers or schema validation failed
403 PERMISSION_DENIED Step does not belong to the customer
404 RET_NOT_FOUND Step was not found