Update User Agent Identity
PUT/kyc-sandbox/api/v1/users/:agent_id/repair
An endpoint for resubmit the Agent’s identity data.
Request
Path Parameters
The agent ID of the user.
Header Parameters
A unique identifier for the request, used for tracking and troubleshooting purposes. In case of any errors, Flip can use this value to trace and investigate the specific request.
The Request-ID will be formed of bigflip-{uuid}, where the “uuid” (Universally unique identifier) has to be generated on your end.
Example: "Request-ID: bigflip-47EB7F57-5565-4BF0-B9DD-46C6268CEE71".
- application/x-www-form-urlencoded
Body
Input 1 for The user type is Agent
Possible values: non-empty and <= 50 characters
Alphanumeric Agent's full name
Type of Identity. Accept value are as follow 1 for (National Id Card/KTP), 2 is Passport
Identity number based on the identity_type chosen.
Agent's Birth Date; The format is DD-MM-YYYY
Possible values: <= 255 characters
Agent’s birth place.
Agent’s country code based on the identity chosen. Available values can be retrieved from the country list API here.
Agent’s province code based on the identity chosen. Available values can be retrieved from the province list API here.
Agent’s city code based on the identity chosen. Available values can be retrieved from the city list API here.
Agent’s district code based on the identity chosen. Available values can be retrieved from the district list API here.
Possible values: >= 10 characters and <= 300 characters, Value must match regular expression ^[a-zA-Z0-9\s\.\-\/\(\)]+$
Agent’s address based on the identity chosen. Allows Alphanumeric, numbers, spaces, periods, hyphens, slashes, and parentheses.
Agent’s gender. Accepted value are as follows 1 for Male, 2 for Female.
Agent’s job. Accepted value are as follows housewife, entrepreneur, private_employee, government_employee,
foundation_board for People who work at foundation as an employee, indonesian_migrant_worker Also known as TKI,
company If sender is a company, not individual, others
Agent’s phone number. It must be the one that has been verified by the company.
A flag to set if the current residential address of the Agent is the same as the identity address. Value 0 for false, `1`` for true
Agent’s Country id code based on the Agent current residence. Available values can be retrieved from the Country Id list API
Agent’s Province id code based on the Agent current residence. Available values can be retrieved from the Province Id list API
Agent’s City Id code based on the Agent current residence. Available values can be retrieved from the City Id list API
Agent’s District Id code based on the Agent current residence. Available values can be retrieved from the District Id list API
Agent’s address based on the Agent current address. Allows Alphanumeric, numbers, spaces, periods, hyphens, slashes, and parentheses.
Responses
- 200
- 401
Successful KYC submission with user details
- application/json
- Schema
- Example (from schema)
- Example
Schema
The ID of the user.
The type of user.
The name of the user.
The birthplace of the user.
The birthdate of the user.
The gender of the user.
The status of the KYC process.
Indicates if the basic data is filled.
The type of identity document.
The national identification number.
The passport number of the user (if available).
The occupation of the user.
The country ID.
The province ID.
The city ID.
The district ID.
The address of the user.
The residence country ID.
The residence province ID.
The residence city ID.
The residence district ID.
The residence address of the user.
The timestamp when the record was created.
The timestamp when the record was last updated.
{
"user_id": 0,
"user_type": 0,
"name": "string",
"birth_place": "string",
"birth_date": "2024-10-02T04:05:32.068Z",
"gender": 0,
"status": 0,
"basic_data_filled": true,
"identity_type": 0,
"nik": "string",
"passport_number": "string",
"occupation": "string",
"country_id": 0,
"province_id": 0,
"city_id": 0,
"district_id": 0,
"address": "string",
"residence_country_id": 0,
"residence_province_id": 0,
"residence_city_id": 0,
"residence_district_id": 0,
"residence_address": "string",
"created_at": "2024-10-02T04:05:32.069Z",
"updated_at": "2024-10-02T04:05:32.069Z"
}
{
"user_id": 1,
"user_type": 1,
"name": "John Smith",
"birth_place": "Kota Depok",
"birth_date": "1990-10-31T00:00:00Z",
"gender": 1,
"status": 20,
"basic_data_filled": true,
"identity_type": 1,
"nik": "1234567890123456",
"passport_number": null,
"occupation": "entrepreneur",
"country_id": 1,
"province_id": 12,
"city_id": 184,
"district_id": 1234,
"address": "Jalan Margonda Raya",
"residence_country_id": 1,
"residence_province_id": 12,
"residence_city_id": 128,
"residence_district_id": 1234,
"residence_address": "Jalan Margonda Raya",
"created_at": "2022-04-20T14:37:07+07:00",
"updated_at": "2022-04-21T13:48:05+07:00"
}
Sample response when Your Flip api secret key value for Authorization is missing or invalid
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
{
"errors": [
{
"code": 401,
"message": "Invalid Auth"
}
]
}