# New KYC
## Update Kyc Name
requires authentication
Use this end point to update kyc name
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/v2/kyc/update-name" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"kyc_first_name":"neque","kyc_last_name":"quo"}'
```
> Example response (200):
```json
{
"message": "Kyc name updated successfully!",
"data": {
"user": {
"id": 145,
"email": "ankita40@yopmail.com",
"username": "ankita40",
"phone": "8765432080",
"kyc": {
"kyc_status_id": null,
"is_kyc_locked": null,
"kyc_lock_remark": null,
"kyc_first_name": "Clark",
"kyc_last_name": "Green",
"kyc_dob": "11/02/1976",
"kyc_street_address": "222333 Peacht",
"kyc_full_address": "539 Mission Drive, San Gabriel, Los Angeles, California",
"kyc_state_id": "5",
"kyc_city": "San Francisco",
"kyc_zip": "91119",
"kyc_address_place_id": "ChIJgUbEo8cfqokR5lP9_Wh_DaM",
"kyc_attempts": 0
}
}
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"kyc_first_name": [
"The kyc_first_name field is required."
],
"kyc_last_name": [
"The kyc_last_name field is required."
]
}
}
```
Request failed with error:
## Update Kyc DOB
requires authentication
Use this end point to update kyc dob
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/v2/kyc/update-dob" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"kyc_dob":"qui"}'
```
> Example response (200):
```json
{
"message": "Kyc dob updated successfully!",
"data": {
"user": {
"id": 145,
"email": "ankita40@yopmail.com",
"username": "ankita40",
"phone": "8765432080",
"kyc": {
"kyc_status_id": null,
"is_kyc_locked": null,
"kyc_lock_remark": null,
"kyc_first_name": "Clark",
"kyc_last_name": "Green",
"kyc_dob": "11/02/1976",
"kyc_street_address": "222333 Peacht",
"kyc_full_address": "539 Mission Drive, San Gabriel, Los Angeles, California",
"kyc_state_id": "5",
"kyc_city": "San Francisco",
"kyc_zip": "91119",
"kyc_address_place_id": "ChIJgUbEo8cfqokR5lP9_Wh_DaM",
"kyc_attempts": 0
}
}
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"kyc_dob": [
"The kyc_dob field is required."
]
}
}
```
Request failed with error:
## Update Kyc Street Address
requires authentication
Use this end point to update kyc street address
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/v2/kyc/update-address" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"kyc_full_address":"voluptatum","kyc_street_address":"magni","kyc_zip":"laboriosam","kyc_state":"odit","kyc_city":"quod","kyc_address_place_id":"exercitationem"}'
```
> Example response (200):
```json
{
"message": "Kyc street address updated successfully!",
"data": {
"user": {
"id": 145,
"email": "ankita40@yopmail.com",
"username": "ankita40",
"phone": "8765432080",
"kyc": {
"kyc_status_id": null,
"is_kyc_locked": null,
"kyc_lock_remark": null,
"kyc_first_name": "Clark",
"kyc_last_name": "Green",
"kyc_dob": "11/02/1976",
"kyc_street_address": "222333 Peacht",
"kyc_full_address": "539 Mission Drive, San Gabriel, Los Angeles, California",
"kyc_state_id": "5",
"kyc_city": "San Francisco",
"kyc_zip": "91119",
"kyc_address_place_id": "ChIJgUbEo8cfqokR5lP9_Wh_DaM",
"kyc_attempts": 0
}
}
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"kyc_full_address": [
"The kyc_full_address field is required."
],
"kyc_street_address": [
"The street address field is required."
],
"kyc_state": [
"The state field is required."
],
"kyc_city": [
"The city field is required."
],
"kyc_zip": [
"The zip field is required."
]
}
}
```
Request failed with error:
## KYC Check v2
requires authentication
Use this endpoint to check the KYC (Know Your Customer) status for a user.
The response will vary based on the user's current KYC status and attempts.
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/v2/kyc/check-new" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200, KYC Verification - More information required):
```json
{
"message": "KYC check response",
"data": {
"kyc_status": {
"id": 4,
"name": "Verification - More information required",
"created_at": "2022-08-17T06:26:44.000000Z",
"updated_at": "2022-08-17T06:26:44.000000Z"
},
"raw_response": {
"response": {
"id-number": 5950044412,
"summary-result": {
"key": "id.failure",
"message": "FAIL"
},
"results": {
"key": "result.no.match",
"message": "ID Not Located"
},
"idliveq-error": {
"key": "id.not.eligible.for.questions",
"message": "Not Eligible For Questions"
},
"id-scan": "yes",
"id-scan-url": "https:\/\/web.idologylive.com\/idscan\/v2.jsp?id=U4eIF0WT2916b4616a"
}
},
"already_locked": 0,
"id_scan_required": 1,
"kyc_attempts": 1,
"id_scan_url": "https:\/\/web.idologylive.com\/idscan\/v2.jsp?id=U4eIF0WT2916b4616a"
}
}
```
> Example response (200, KYC Verified & Locked):
```json
{
"message": "KYC check response",
"data": {
"kyc_status": {
"id": 5,
"name": "Duplicate Information - Deny",
"created_at": "2022-08-17T06:26:44.000000Z",
"updated_at": "2022-08-17T06:26:44.000000Z"
},
"raw_response": null,
"already_locked": 1,
"kyc_attempts": 1,
"id_scan_required": 0,
"id_scan_url": null
}
}
```
> Example response (200, KYC Failed & Locked):
```json
{
"message": "Unable to verify your ID, please contact support",
"data": {
"kyc_status": {
"id": 3,
"name": "Verification Failed",
"created_at": "2022-08-17T06:26:44.000000Z",
"updated_at": "2022-08-17T06:26:44.000000Z"
},
"raw_response": null,
"already_locked": 1,
"kyc_attempts": 1,
"id_scan_required": 0,
"id_scan_url": null
}
}
```
> Example response (200, More Info Required & Max Attempts Reached):
```json
{
"message": "ID Upload Required",
"data": {
"kyc_status": {
"id": 4,
"name": "Verification - More Information Required",
"created_at": "2022-08-17T06:26:44.000000Z",
"updated_at": "2022-08-17T06:26:44.000000Z"
},
"raw_response": null,
"already_locked": 0,
"kyc_attempts": 2,
"id_scan_required": 1,
"id_scan_url": null
}
}
```
> Example response (401, Unauthorized):
```json
{
"message": "Unauthenticated."
}
```
Request failed with error:
## KYC Upload Document
requires authentication
Use this endpoint to initiate the Scan Onboard document capture for KYC verification.
It calls the GBG Scan Onboard API to generate a unique capture URL for the user.
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/v2/kyc/upload-document" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "KYC document upload response",
"data": {
"scan_capture_url": "web.idologylive.com\/api\/idscancapture.jsp?referenceId=Ja3%2B8q%2Bdkk",
"query_id": "150352661"
}
}
```
> Example response (500, GBG API Error):
```json
{
"message": "Something went wrong! Please try again later."
}
```
> Example response (500, GBG Error Response):
```json
{
"message": "GBG error message"
}
```
> Example response (500, GBG Failed Response):
```json
{
"message": "GBG failed message"
}
```
> Example response (401, Unauthorized):
```json
{
"message": "Unauthenticated."
}
```
Request failed with error: