# Post KYC Data

### KYC 

The Axis API is KYC dependent- meaning only orders from users who have done KYC will be fulfilled. If a user with no KYC creates an order, it will be "Pending" until the user performs KYC or their KYC data is posted to the B2CUpdateKYC endpoint. 

**There are 2 types of KYC for a user** 

1. Basic KYC 
2. Extended KYC (E-KYC)

With Each KYC category, there are transactional limits.

<table><thead><tr><th width="124"></th><th width="108">Basic KYC </th><th width="98">E-KYC</th><th>Note</th></tr></thead><tbody><tr><td>User's Limit per Transaction </td><td>$5,000</td><td>$23,000</td><td>All transactions greater than $5,000 per time will be denied. <br><br>All transactions greater than $23000 within 24 hours would trigger E-KYC </td></tr><tr><td>User's Limit per Day </td><td>$10,000</td><td>$100,000</td><td>All transactions greater than $10,000 per time will be denied. <br><br>All transactions per user per day greater than $100,000 would be denied</td></tr><tr><td></td><td></td><td></td><td></td></tr></tbody></table>

### Post KYC Data Endpoint&#x20;

### This is used by merchants to submit their user's KYC data.

Use the endpoint below if you have already done KYC for your users. use this endpoint to post their data to register them on Axis.  Kindly note that, KYC is a one-time event.

<mark style="color:green;">`POST`</mark> `https://exchanger-api.fuspay.finance/`api/v1/no-auth/Axis/B2cUpdateUserKyc

#### Headers

| Name                                            | Type   | Description                      |
| ----------------------------------------------- | ------ | -------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer ${partner\_secret\_key}" |
| x-partner-id<mark style="color:red;">\*</mark>  | String | "pxxxxxx"                        |

#### Basic KYC Request Body

| Name                                         | Type   | Description                                                                                          |
| -------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| kyc\_type<mark style="color:red;">\*</mark>  | String | basic                                                                                                |
| email<mark style="color:red;">\*</mark>      | String | email of the user                                                                                    |
| phone<mark style="color:red;">\*</mark>      | String | phone number of the user                                                                             |
| user\_data<mark style="color:red;">\*</mark> | Object | This is an object containing more data on the user                                                   |
| first\_name                                  | String | The users first name                                                                                 |
| last\_name<mark style="color:red;">\*</mark> | String | The user's last name                                                                                 |
| address\*                                    | String | The user's house address                                                                             |
| phone                                        | String | The user's phone number                                                                              |
| email                                        | String | The user's email                                                                                     |
| bvn                                          | String | The user's BVN (Bank Verification Number). <mark style="color:red;">Only required for Nigeria</mark> |
| country\_of\_residence                       |        | The country of residence for there user                                                              |
| govt\_id\_no                                 | String | The Number on a government approved ID like NIN                                                      |
| govt\_id\_photo                              | String | the url of the users government approved ID card                                                     |
| user\_facial\_images                         | Obejct | An object represeting the users series of facial images                                              |
| image\_1                                     | String | url of the users image                                                                               |
| image\_1                                     | String | URL of the users image                                                                               |

### Sample Request

```json
{
	"kyc_type": "basic",
	"email": "sample@gmail.com",
	"phone": "0900000000",
	"user_data": {
		
		"first_name": "John",
		"last_name": "Doe",
		"address": "John address",
		"phone": "0900000000",
		"email": "sample@gmail.com",
		"bvn": "123",
		"country_of_residence": "Nigeria",
		"govt_id_no": "A123",
		"govt_id_photo": "D-123",
		"user_facial_images": {
			"image_1": "url.png",
			"image_2": "url.png"
		}

		
	}
}
```

{% tabs %}
{% tab title="200: OK successful response" %}

```
{
	"success": true,
	"message": "User Kyc data updated successfully",
	"data": {
		"kyc_token": "N2E1NzZiOTdhMzk0NjY4MTg5MjgyYzk3MjM3NmY1OWNhMWYyMTM5Nzk1YjE3YjYzZDU1YmY1YjUxMTRmMDU4Mw=="
	}
}

```

{% endtab %}

{% tab title="400: Bad Request failed responses" %}

{% endtab %}
{% endtabs %}

#### Extended KYC Request Body

| Name                                                  | Type   | Description                                                            |
| ----------------------------------------------------- | ------ | ---------------------------------------------------------------------- |
| kyc\_type<mark style="color:red;">\*</mark>           | String | extended                                                               |
| email<mark style="color:red;">\*</mark>               | String | email of the user                                                      |
| phone<mark style="color:red;">\*</mark>               | String | phone number of the user                                               |
| extended\_kyc\_data<mark style="color:red;">\*</mark> | Object | This is an object containing more data on the user  for extended KYC   |
| proof\_of\_address<mark style="color:red;">\*</mark>  | String | Utility bills & Lease agreement                                        |
| bank\_statement<mark style="color:red;">\*</mark>     | String | Recent Bank statement generated in the last 6 months                   |
| user\_indemnity\*                                     | String | Duly signed Indemnity form. See below link to download Indemnity form  |
| guarantors\_form                                      | String | Duly Filled & signed guarantor's form. See below link to download form |
| id\_of\_guarantor                                     | String | Gov't issued ID (Passport, Driver's License or national ID)            |

{% hint style="info" %}
To download forms for Extended KYC Visit&#x20;

1. User Indemnity Form
2. Guanrator's Form
   {% endhint %}

### Sample of Request Body

```json
user_data = {
    "first_name": "",
    "last_name": "",
    "address": "",
    "phone": "",
    "email": "",
    "extended_kyc_data": {
        "proof_of_address": "",
        "bank_statement": "",
        "user_indemnity": "",
        "guarantors_form": "",
        "id_of_guarantor": "",
        "guarantors_proof_of_address": ""
    }

}

            
```

{% tabs %}
{% tab title="200: Ok Successful Response" %}

```
Response {

}

```

{% endtab %}

{% tab title="400: Bad Resquest " %}

```
Response {

}

```

{% endtab %}
{% endtabs %}