Post KYC Data

This page describes the KYC properties of the Axis system.

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.

	Basic KYC	E-KYC	Note
User's Limit per Transaction	$5,000	$23,000	All transactions greater than $5,000 per time will be denied. All transactions greater than $23000 within 24 hours would trigger E-KYC
User's Limit per Day	$10,000	$100,000	All transactions greater than $10,000 per time will be denied. All transactions per user per day greater than $100,000 would be denied

Post KYC Data Endpoint

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.

POST https://exchanger-api.fuspay.finance/api/v1/no-auth/Axis/B2cUpdateUserKyc

Headers

Name	Type	Description
Authorization*	String	"Bearer ${partner_secret_key}"
x-partner-id*	String	"pxxxxxx"

Basic KYC Request Body

Name	Type	Description
kyc_type*	String	basic
email*	String	email of the user
phone*	String	phone number of the user
user_data*	Object	This is an object containing more data on the user
first_name	String	The users first name
last_name*	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). Only required for Nigeria
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

{
	"kyc_type": "basic",
	"email": "[e-mail]",
	"phone": "0900000000",
	"user_data": {
		
		"first_name": "John",
		"last_name": "Doe",
		"address": "John address",
		"phone": "0900000000",
		"email": "[e-mail]",
		"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"
		}

		
	}
}

200: OK successful response

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

400: Bad Request failed responses

Extended KYC Request Body

Name	Type	Description
kyc_type*	String	extended
email*	String	email of the user
phone*	String	phone number of the user
extended_kyc_data*	Object	This is an object containing more data on the user for extended KYC
proof_of_address*	String	Utility bills & Lease agreement
bank_statement*	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)

To download forms for Extended KYC Visit

1. User Indemnity Form

2. Guanrator's Form

Sample of Request Body

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": ""
    }

}

            

200: Ok Successful Response

Response {

}

400: Bad Resquest

Response {

}