Create KYC
Developing
POST
/v2/fiat/kyc
What This API Does
fiat_kyc_id. This ID is used later when creating the fiat pay-in order.Request Data Structure
{
"email": "user@example.com",
"firstName": "Alice",
"lastName": "Doe",
"date": "01-01-1990",
"country": "US",
"gender": "female",
"phone": "1234567890",
"address": {
"city": "New York",
"postalCode": "10001",
"street": "Main Street",
"state": "NY"
}
}| Field | Type | Required / Nullable | Conditions / Notes |
|---|---|---|---|
email | string | Required, cannot be null | End user's email address. |
firstName | string | Required, cannot be null | End user's first name. |
lastName | string | Required, cannot be null | End user's last name. |
date | string | Required, cannot be null | Date of birth in dd-mm-yyyy format. User must be at least 18 years old. |
country | string | Required, cannot be null | 2-letter uppercase ISO country code, for example US, AE, IN. |
gender | string | Required, cannot be null | Allowed values: male, female. |
phone | string | Required, cannot be null | 8 to 15 digits only. No symbols and no + prefix. |
address | object | Required, cannot be null | Address object is required. |
address.city | string | Required, cannot be null | User's city. |
address.postalCode | string | Required, cannot be null | User's postal code. |
address.street | string | Required, cannot be null | User's street address. |
address.state | string | Required, cannot be null | User's state or province. |
Response Structure
{
"fiat_kyc_id": "KYC_xxx"
}| Field | Type | Nullable | Description |
|---|---|---|---|
fiat_kyc_id | string | No | KYC profile ID. Store this value and pass it to POST /v2/fiat/pay-in. |
Logic in a Nutshell
fiat_kyc_id. The fiat_kyc_id becomes the user identity reference for fiat pay-in orders.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.aio.cash/v2/v2/fiat/kyc' \
--header 'Content-Type: application/json' \
--data '{
"type": "string",
"required": [
"string"
],
"properties": {
"email": {
"type": "string",
"format": "string"
},
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"date": {
"type": "string",
"description": "string"
},
"country": {
"type": "string",
"minLength": 0,
"maxLength": 0
},
"gender": {
"type": "string",
"enum": [
"string"
]
},
"phone": {
"type": "string",
"pattern": "string"
},
"address": {
"type": "string",
"required": [
"string"
],
"properties": {
"city": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"street": {
"type": "string"
},
"state": {
"type": "string"
}
}
}
}
}'Response Response Example
{
"success": true,
"msg": "ok",
"data": {
"type": "string",
"required": [
"string"
],
"properties": {
"fiat_kyc_id": {
"type": "string",
"example": "string"
}
}
}
}Modified at 2026-05-18 08:39:10