Skip to main content
POST
/
api
/
v1
/
customers
/
{customerId}
/
kyc
curl --request POST \
  --url https://skala-sandbox.ripio.com/api/v1/customers/{customerId}/kyc/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "kycSubmission": {
    "country": "AR",
    "first_name": "Mateo",
    "last_name": "Romero",
    "gender": "M",
    "birthday": "1990-01-25",
    "nationality": "AR",
    "id_number_type": "DNI",
    "id_number": "11122233",
    "registered_tax_payer": false,
    "cuit": "20111222330",
    "address": "Libertad",
    "address_flat": "1",
    "address_number": "333",
    "postal_code": "1012",
    "district": "Chubut",
    "city": "Trelew",
    "state": "AR.CH",
    "phone": "+542211228855",
    "personal_activity": "AR.6"
  },
  "redirectUrl": "https://www.example.com/"
}
'
{
  "submissionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "2023-11-07T05:31:56Z",
  "providerUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

Access token obtained via /oauth2/token/. Use as Authorization: Bearer <access_token>.

Path Parameters

​
customerId
string<uuid>
required

Unique identifier for the customer.

Body

application/json

KYC data for the customer. Structure should align with fields from /kycRequirements/.

Request body for KYC submission. Use kycSubmission + redirectUrl for the standard API flow, or only redirectUrl for the Ripio KYC delegated flow.

​
kycSubmission
object

Customer KYC data. Fields vary by country — use /kycRequirements/ to get the required fields for the customer's country. Not required when using the Ripio KYC delegated flow.

​
redirectUrl
string<uri>

URL to redirect the user after completing the KYC flow. Required for the Ripio KYC delegated flow; optional for the API flow.

Example:

"https://www.example.com/"

Response

KYC submission received successfully. Includes providerUrl for document upload and liveness check.

​
submissionId
string<uuid>
required

Unique identifier for the submitted KYC data.

​
createdAt
string<date-time>
required

Date and time the KYC submission was created (UTC format).

​
providerUrl
string<url>
required

Points to a third-party KYC provider's widget to handle file uploads and liveness checks. Only available in production.